Bouw op de Commons

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

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

Bekijk de interactieve API-referentie (Engels), met elk endpoint, zijn parameters en zijn antwoorden, of de specificatie op GitHub.

Endpoints
GET/v1/searchzoek dekking op bbox, letter, tier
GET/v1/items/{id}één item: zijn soort, de details gekozen uit een lijst, zijn foto's en waar het vandaan komt
GET/v1/regions/{id}één regio: zijn omtrek en wat erin staat, letter per letter
GET/v1/regions/{id}/bestwat fietsers dit seizoen het beste vonden in een regio
GET/v1/routes/{id}.gpxhet spoor van een route, als GPX-bestand om te downloaden
GETcoverage.pmtilesvectortegels per land, opgesomd door /v1/map-config, voor je eigen MapLibre-stijl
POST/v1/contributionsvoor geregistreerde partner-apps: komt in dezelfde beoordelingsrij als bijdragen op de site

De bulkexport: wat erin zit, de licentie en de momentopnamen →

Voorbeeldverzoek
# drinking water & food in a bounding box
curl --compressed "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":{
   "id":4512, "letter":"B",
   "name":"Fountain · Spa",
   "tier":"curated", "grade":"minimum",
   "confirmations":3, "region_id":"wallonia", …
  }
 }]
}

Antwoorden zijn standaard alleen-referentie: onze eigen velden, en bij één item (/v1/items/{id}) 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.
Photos © their creators,
under the licence named with each photo.
Code, user interface and translations
© their contributors, under AGPL-3.0-only.
De regels
Fair use. Lezen staat open voor iedereen, zonder sleutel en zonder account, binnen een snelheidslimiet per adres waar een gewone app ver onder blijft. Voor bulk of offline gebruik: download de wekelijkse bulkexport 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.