Voorbeeldrijen

Haal een klein stukje van een dataset op om het schema en de werkelijke waarden te inspecteren. Voorbeelden zijn openbaar en kosten geen credits, dus gebruik ze tijdens de ontwikkeling voordat je credits uitgeeft aan een volledige download.

Endpoint

GET /v1/dataset/:table/sample/:format

Openbaar, kost geen credits. Ondersteunde format waarden: json, csv, geojson, kml. (SHP wordt niet aangeboden als voorbeeld; gebruik het JSON- of GeoJSON-voorbeeld om de geometrie te inspecteren.)

Padparameters

Parameter	Beschrijving
table	Dataset identificator, bijvoorbeeld nl-domino-poi.
format	Een van json, csv, geojson, kml.

Verzoek

curl "https://api.topolab.nl/v1/dataset/nl-domino-poi/sample/json"

Antwoord

Een voorbeeld retourneert een handvol representatieve rijen — genoeg om veldnamen, types en coördinatenwaarden te bevestigen voordat je je verbindt aan een betaalde pull.

{
  "table": "nl-domino-poi",
  "format": "json",
  "rowCount": 3,
  "rows": [
    {
      "store_id": "NL-0142",
      "name": "Domino's Pizza",
      "city": "Amsterdam",
      "postal_code": "1012 AB",
      "longitude": 4.8952,
      "latitude": 52.3702
    },
    {
      "store_id": "NL-0317",
      "name": "Domino's Pizza",
      "city": "Rotterdam",
      "postal_code": "3011 AA",
      "longitude": 4.4777,
      "latitude": 51.9244
    },
    {
      "store_id": "NL-0488",
      "name": "Domino's Pizza",
      "city": "Utrecht",
      "postal_code": "3511 LX",
      "longitude": 5.1214,
      "latitude": 52.0907
    }
  ]
}

Het csv formaat retourneert dezelfde rijen als komma-gescheiden tekst met een headerrij. De geojson en kml formaten retourneren de rijen als puntfeatures in WGS84 (EPSG:4326).

curl "https://api.topolab.nl/v1/dataset/nl-domino-poi/sample/geojson"

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "geometry": { "type": "Point", "coordinates": [4.8952, 52.3702] },
      "properties": { "store_id": "NL-0142", "city": "Amsterdam" }
    }
  ]
}

GeoJSON-coördinaten zijn geordend [longitude, latitude] en zijn altijd WGS84 (EPSG:4326).

Wanneer voorbeelden te gebruiken

• Bevestig veldnamen en types voordat je ze in je code in kaart brengt.
• Controleer de volgorde van coördinaten en het referentiesysteem.
• Ontwikkel en test parsers zonder je maandelijkse creditlimiet te verbruiken.

Voor een gestructureerd veldprofiel (types, null ratio's, distinct counts) zonder rijen te downloaden, zie fieldAnalysis op Haal een dataset op.

Fouten

Status	Betekenis
404	Onbekende table of niet-ondersteund voorbeeld format.
429	Rate limited — zie Rate limieten & credits.

Volgende

• Download bestanden — volledige exports zodra het schema er goed uitziet.
• Haal een dataset op — metadata, kwaliteitsgraad en veldanalyse.