Kompatibilität: Google und Nominatim
Ändern Sie die Basis-URL und behalten Sie Ihren Client-Code. Diese Seite listet auf, was unterstützt wird, nach der API-Spezifikation (OpenAPI 1.0.0).
Google-Geocoding-Modus
| Element | Unterstützung |
|---|---|
| Pfad | /compat/google/maps/api/geocode/json |
| Geokodierung | `address` (bis 512 Zeichen) |
| Rückwärts-Geokodierung | `latlng`, als `lat,lng` |
| Filter | `components`: nur `country:XX` wird berücksichtigt; `language` und `region` werden akzeptiert |
| Antwortfelder | status, error_message, results[].formatted_address, place_id, types, partial_match, address_components, geometry.location, geometry.location_type, geometry.viewport |
| Fehler | `status` im Google-Format (OK, ZERO_RESULTS, OVER_QUERY_LIMIT, REQUEST_DENIED, INVALID_REQUEST, UNKNOWN_ERROR), HTTP 200 |
| Place-IDs | Im Format vorhanden; die Werte sind Addrova-Kennungen |
| Addrova-Erweiterung | Liste `attribution` mit Quellen und Lizenzen |
Nominatim-Modus
| Element | Unterstützung |
|---|---|
| Suche | /compat/nominatim/search mit `q`, `format` (json oder jsonv2, Standard jsonv2), `limit` (1 bis 40, Standard 10), `countrycodes` (durch Kommas getrennte ISO-Codes), `addressdetails` (0 oder 1, Standard 0) |
| Rückwärtssuche | /compat/nominatim/reverse mit `lat`, `lon`, `format`, `addressdetails` (Standard 1) |
| Antwortfelder | place_id, licence, lat, lon, display_name, category (jsonv2) oder class (json), type, importance, address, boundingbox |
| Rückwärtssuche ohne Treffer | {"error": "Unable to geocode"} |
| Nicht enthalten | Kartenkacheln, Abruf von OSM-Objekten |
Authentifizierung auf den Kompatibilitätsrouten
| Methode | Wie |
|---|---|
| Abfrageparameter | `key=ADDROVA_KEY`, nur auf /compat-Routen akzeptiert, aus Kompatibilitätsgründen. Er wird nie protokolliert. |
| Header | `X-API-Key` oder der Schlüssel als Bearer-Token |