Overstappen van publieke Nominatim

Overstappen van de publieke Nominatim-server naar TerraRelay vraagt om twee aanpassingen: de basis-URL en een API-key in een header. Bij /search voeg je bovendien countrycodes toe.

- https://nominatim.openstreetmap.org/search?q=Damrak+1+Amsterdam
+ https://api.terrarelay.eu/search?q=Damrak+1+Amsterdam&countrycodes=nl

Authenticatie

Stuur je API-key mee in de Authorization-header. TerraRelay is bedoeld voor server-naar-servergebruik, dus een key hoort nooit in een URL, in browsercode of in een mobiele app.

Authorization: Bearer <api-key>

Een key in de querystring wordt niet geaccepteerd. Zo blijven keys buiten toegangslogs, proxy’s en browsergeschiedenis.

Verplichte countrycodes bij /search

/search vereist de parameter countrycodes, bijvoorbeeld countrycodes=nl of countrycodes=nl,be. Op basis daarvan wordt het verzoek naar de data van de juiste landen gerouteerd. Zonder die parameter krijg je een foutmelding met een verwijzing naar de documentatie.

Wanneer de publieke server je blokkeert

De publieke Nominatim-server wordt door vrijwilligers beheerd en hanteert een streng gebruiksbeleid. Stuur je te veel verzoeken, of maak je je applicatie niet herkenbaar, dan krijg je mogelijk 403-responses of wordt je IP-adres geblokkeerd. De publieke dienst biedt bovendien geen garanties en is niet bedoeld voor zwaar of commercieel gebruik.

TerraRelay is juist voor dat gebruik gebouwd. Je krijgt een eigen API-key, rate limits per key en het recht om resultaten zonder tijdslimiet op te slaan, met de vereiste bronvermelding.

Alle afwijkingen van publieke Nominatim

De endpoints, parameters en responseformaten zijn gelijk aan die van de publieke Nominatim-API. Dit zijn de afwijkingen:

Elke afwijking is een bewuste keuze. Voldoet een verzoek er niet aan, dan verwijst de foutmelding naar de documentatie.