Beschikbare DataFormaten in WIWB 2.0 API

De WIWB 2.0 API ondersteunt verschillende dataformaten voor het exporteren van gegevens. Het beschikbare formaat is afhankelijk van het type data (StructureType) dat je opvraagt. Hieronder een overzicht van alle ondersteunde dataformaten per structuurtype.

TimeSeries (Tijdreeksen)

Voor tijdreeksdata zijn de volgende formaten beschikbaar:

JSON (json)

• Gebruik: Geschikt voor webapplicaties en API-integratie
• Voordelen: Gemakkelijk te verwerken in JavaScript/Python, human-readable
• Content-Type: application/json

CSV (csv)

• Gebruik: Geschikt voor spreadsheetapplicaties en data-analyse
• Voordelen: Breed ondersteund, gemakkelijk te importeren in Excel
• Content-Type: text/csv

SSV (Space Separated Values) (ssv)

• Gebruik: Alternatief voor CSV met spaties als scheidingsteken
• Voordelen: Compact formaat
• Content-Type: text/plain

Hydronet CSV (hydronet.csv.simple)

• Gebruik: Specifiek formaat voor hydrologische toepassingen
• Voordelen: Geoptimaliseerd voor water management systemen
• Content-Type: text/csv

NetCDF (netcdf)

• Gebruik: Wetenschappelijke toepassingen en klimaatdata
• Voordelen: Zelf-beschrijvend formaat met metadata, breed gebruikt in klimaatwetenschap
• Content-Type: application/netcdf

PiXML (pixml)

• Gebruik: Integration met PI System van OSIsoft
• Voordelen: Standaard formaat voor industriële datasystemen
• Content-Type: text/xml

SobekBUI (sobekbui)

• Gebruik: Integratie met Sobek hydrodynamische modellen
• Voordelen: Direct compatibel met Sobek software
• Content-Type: application/octet-stream

Grids (Grid data)

Voor griddata zijn de volgende formaten beschikbaar:

JSON (json)

• Gebruik: Webapplicaties en API-integratie
• Voordelen: Gemakkelijk te verwerken programmatisch
• Content-Type: application/json

GeoTIFF (geotiff)

• Gebruik: GIS-applicaties en ruimtelijke analyse
• Voordelen: Standaard GIS-formaat met georeferentie informatie
• Content-Type: application/zip (altijd gecomprimeerd)
• Let op: GeoTIFF bestanden worden altijd geleverd in een ZIP-archief

AAIGrid (aaigrid)

• Gebruik: ESRI ArcGIS en andere GIS-software
• Voordelen: Eenvoudig ASCII-formaat, breed ondersteund
• Content-Type: image/x-aaigrid

HDF5 (hdf5)

• Gebruik: Wetenschappelijke toepassingen en big data
• Voordelen: Efficiënte opslag van grote datasets met metadata
• Content-Type: application/x-hdf5

NetCDF (netcdf4.cf1p6)

• Gebruik: Klimaat- en weerdata, wetenschappelijke analyse
• Voordelen: Climate and Forecast (CF) metadata conventies, zelf-beschrijvend
• Content-Type: application/netcdf

NetCDF ZIP (netcdf4.cf1p6.zip)

• Gebruik: Meerdere NetCDF bestanden in één download
• Voordelen: Handig voor tijdreeksen van grids
• Content-Type: application/zip

ModelGrids (Weermodel data)

ModelGrids ondersteunen dezelfde formaten als reguliere grids:

• JSON
• GeoTIFF (gecomprimeerd)
• AAIGrid
• HDF5
• NetCDF
• NetCDF ZIP

EnsembleGrids (Ensemble weerdata)

EnsembleGrids ondersteunen ook dezelfde formaten als reguliere grids:

• JSON
• GeoTIFF (gecomprimeerd)
• AAIGrid
• HDF5
• NetCDF
• NetCDF ZIP

Formaat Selectie

In API Requests

Specificeer het gewenste formaat in de Exporter sectie van je API request:

{
  "Readers": [...],
  "Exporter": {
    "DataFormatCode": "json"
  }
}

Aanbevelingen per Gebruik

Technische Details

Compression

• GeoTIFF: Altijd gecomprimeerd in ZIP
• NetCDF ZIP: Meerdere bestanden in één ZIP
• Andere formaten: Ongecomprimeerd, tenzij anders aangegeven

Character Encoding

• Tekstformaten (CSV, SSV, JSON): UTF-8
• Binaire formaten (NetCDF, HDF5, GeoTIFF): N.v.t.

Maximale Bestandsgrootte

Voor grote requests wordt aanbevolen om de asynchrone endpoints (/createdownload) te gebruiken in plaats van de directe endpoints (/get).

Voor meer informatie over het gebruik van deze formaten, zie de API documentatie en de Postman voorbeelden.