Compatibiliteit: Google en Nominatim
Wijzig de basis-URL en houd uw clientcode. Deze pagina geeft aan wat wordt ondersteund, volgens de API-specificatie (OpenAPI 1.0.0).
Google Geocoding-modus
| Element | Ondersteuning |
|---|---|
| Pad | /compat/google/maps/api/geocode/json |
| Geocodering | `address` (maximaal 512 tekens) |
| Omgekeerde geocodering | `latlng`, in de vorm `lat,lng` |
| Filters | `components`: alleen `country:XX` wordt gehonoreerd; `language` en `region` geaccepteerd |
| Antwoordvelden | status, error_message, results[].formatted_address, place_id, types, partial_match, address_components, geometry.location, geometry.location_type, geometry.viewport |
| Fouten | `status` in Google-formaat (OK, ZERO_RESULTS, OVER_QUERY_LIMIT, REQUEST_DENIED, INVALID_REQUEST, UNKNOWN_ERROR), HTTP 200 |
| Plaats-ID’s | Aanwezig in de vorm; de waarden zijn Addrova-identificaties |
| Addrova-uitbreiding | Lijst `attribution` met bronnen en licenties |
Nominatim-modus
| Element | Ondersteuning |
|---|---|
| Zoeken | /compat/nominatim/search met `q`, `format` (json of jsonv2, standaard jsonv2), `limit` (1 tot 40, standaard 10), `countrycodes` (ISO-codes gescheiden door komma’s), `addressdetails` (0 of 1, standaard 0) |
| Omgekeerd | /compat/nominatim/reverse met `lat`, `lon`, `format`, `addressdetails` (standaard 1) |
| Antwoordvelden | place_id, licence, lat, lon, display_name, category (jsonv2) of class (json), type, importance, address, boundingbox |
| Omgekeerd zonder resultaat | {"error": "Unable to geocode"} |
| Buiten bereik | Kaarttegels, opvragen van OSM-objecten |
Authenticatie op de compatibiliteitsroutes
| Methode | Hoe |
|---|---|
| Queryparameter | `key=ADDROVA_KEY`, alleen geaccepteerd op /compat-routes, voor compatibiliteit. Wordt nooit gelogd. |
| Header | `X-API-Key`, of de sleutel als bearer-token |