Hoe het werkt

Onveranderlijke datasets

Elke dataset wordt gebouwd uit OpenStreetMap, aangevuld met open adresbronnen waar de adresdekking van OpenStreetMap tekortschiet, zoals nationale adresregisters. Een dataset wordt nooit ter plekke aangepast. Een nieuwe build levert een nieuwe, geversioneerde dataset op, en de vorige blijft beschikbaar totdat de nieuwe zich heeft bewezen.

Per bron leggen we de versie, de licentie, de verplichte bronvermelding en de vraag of resultaten onbeperkt mogen worden opgeslagen vast. Een bron maakt alleen deel uit van de standaarddataset als de licentie dat toestaat.

Shards per land

De data is opgedeeld in shards per land. Zo blijft elke shard klein, snel te bouwen en eenvoudig te controleren.

• Zoeken: verzoeken worden gerouteerd op basis van de parameter countrycodes. Daarom is die verplicht bij /search.
• Reverse geocoding: verzoeken worden gerouteerd op basis van de coördinaten in het verzoek.

Canary-releases

Nieuwe data gaat niet overal tegelijk live. Een nieuwe datasetversie draait eerst op een klein deel van het verkeer en doorloopt kwaliteitstests, waaronder metingen van de adresdekking. Pas daarna wordt hij de standaard. Het toevoegen of wijzigen van een bron volgt hetzelfde proces.

Bronvermelding

De data is beschikbaar onder de Open Database License (ODbL), en elke aanvullende bron kent een eigen eis voor bronvermelding. De bronvermelding per land wordt automatisch samengesteld uit de gebruikte bronnen en we nemen haar op in de responses en de documentatie. Gebruik tot die tijd de basisbronvermelding: © OpenStreetMap contributors, ODbL. Toon die overal waar je de resultaten laat zien of opslaat.