Snelstart

1. Maak een account en een project aan

Registreer je op my.terrarelay.eu, maak een organisatie aan en voeg een project toe. Een project bundelt je API-keys en je verbruik.

2. Maak een API-key aan

Open het project en maak een API-key aan. De key wordt één keer getoond, direct na het aanmaken. Bewaar hem op een veilige plek op je server, zoals een secret store. Raak je hem kwijt, maak dan een nieuwe key aan en trek de oude in.

3. Stuur een forward-verzoek

/search vereist de parameter countrycodes. Stuur de key mee in de Authorization-header.

curl -H "Authorization: Bearer <api-key>" \
  "https://api.terrarelay.eu/search?q=Damrak+1+Amsterdam&countrycodes=nl&format=jsonv2"

Wil je in meerdere landen zoeken, scheid de codes dan met een komma, bijvoorbeeld countrycodes=nl,be.

4. Stuur een reverse-verzoek

/reverse werkt met coördinaten en heeft dus geen countrycodes nodig.

curl -H "Authorization: Bearer <api-key>" \
  "https://api.terrarelay.eu/reverse?lat=52.3745&lon=4.8981&format=jsonv2"

5. Vermeld de bronvermelding

De resultaten zijn gebouwd op OpenStreetMap-data en andere bronnen. Toon of bewaar je resultaten, neem dan de bronvermelding op die de bronnen vereisen. Zie Hoe het werkt voor de details.