Bouw op de Commons

Open data. Een open API.
Voor iedereen om op te bouwen.

Bevraag de Commons per gebied en type, of host zelf vanaf de periodieke bulkexport. De data is open (ODbL), en dat maakt het een commons. Geen sleutel, geen account, geen kosten: een snelheidslimiet en fair use, meer niet.

In ontwerp — deze endpoints zijn het contract dat we bouwen. Bekijk de interactieve API-referentie (Engels) of de specificatie op GitHub.

Endpoints
GET/v1/searchzoek dekking op bbox, letter, tier
GET/v1/items/{id}één item, met onze verrijking en herkomst (gepland)
GET/v1/regions/{id}regiopolygoon en dekkingscijfers (gepland)
GET/v1/regions/{id}/bestde best-of van een regio (gepland)
GET/v1/routes/{id}.gpxroutedetail en GPX-download (gepland)
GETcoverage.pmtilesvectortegels en TileJSON, voor je eigen MapLibre-stijl (gepland)
POST/v1/contributionsbijdragen (gepland), komt in dezelfde beoordelingsrij als bijdragen in de app
Voorbeeldverzoek
# drinking water & food in a bounding box
curl "https://api.cyclingcommons.org/v1/search\
  ?letter=B&bbox=5.6,50.3,6.1,50.6"
Antwoord
{
 "type":"FeatureCollection",
 "licence":"ODbL-1.0",
 "features":[{
  "type":"Feature",
  "geometry":{"type":"Point",
   "coordinates":[5.865,50.492]},
  "properties":{
   "osm_ref":"node/4207030426",
   "letter":"B", "tier":"curated",
   "potable":true, "confirmed":3
  }
 }]
}

Antwoorden zijn standaard alleen-referentie: onze toegevoegde velden plus de osm_ref om bij OSM te hydrateren. ?hydrate=osm voegt onze gecachte OSM-subset alvast samen.

Verplichte naamsvermelding
Contains data from the
Cycling Commons © contributors
and © OpenStreetMap contributors,
under the Open Database License.
De regels
Fair use. Lezen staat open voor iedereen, zonder sleutel en zonder account, met 120 verzoeken per minuut per adres. Dat is een schuivend venster: een piek leent van de volgende minuut in plaats van je buiten te sluiten. Voor bulk of offline gebruik: neem de periodieke export en host die zelf, in plaats van de live API te belasten; het scrapen van de dienst is niet toegestaan. Licenties: data ODbL 1.0, media CC BY-SA 4.0. Vermeld de bron, deel onder dezelfde voorwaarden, houd het open. Commercieel gebruik mag. Zie de samenvatting in gewone taal: Licenties.