Zgodność: Google i Nominatim
Zmień bazowy adres URL i zachowaj kod klienta. Ta strona wylicza, co jest obsługiwane, na podstawie specyfikacji API (OpenAPI 1.0.0).
Tryb Google Geocoding
| Element | Obsługa |
|---|---|
| Ścieżka | /compat/google/maps/api/geocode/json |
| Geokodowanie proste | `address` (do 512 znaków) |
| Geokodowanie odwrotne | `latlng`, w postaci `lat,lng` |
| Filtry | `components`: uwzględniane jest tylko `country:XX`; `language` i `region` akceptowane |
| Pola odpowiedzi | status, error_message, results[].formatted_address, place_id, types, partial_match, address_components, geometry.location, geometry.location_type, geometry.viewport |
| Błędy | `status` w formacie Google (OK, ZERO_RESULTS, OVER_QUERY_LIMIT, REQUEST_DENIED, INVALID_REQUEST, UNKNOWN_ERROR), HTTP 200 |
| Place ID | Obecne w formacie; wartości to identyfikatory Addrova |
| Rozszerzenie Addrova | Lista `attribution` ze źródłami i licencjami |
Tryb Nominatim
| Element | Obsługa |
|---|---|
| Wyszukiwanie | /compat/nominatim/search z `q`, `format` (json lub jsonv2, domyślnie jsonv2), `limit` (od 1 do 40, domyślnie 10), `countrycodes` (kody ISO oddzielone przecinkami), `addressdetails` (0 lub 1, domyślnie 0) |
| Odwrotne | /compat/nominatim/reverse z `lat`, `lon`, `format`, `addressdetails` (domyślnie 1) |
| Pola odpowiedzi | place_id, licence, lat, lon, display_name, category (jsonv2) lub class (json), type, importance, address, boundingbox |
| Odwrotne bez wyniku | {"error": "Unable to geocode"} |
| Poza zakresem | Kafelki map, wyszukiwanie obiektów OSM |
Uwierzytelnianie na trasach zgodności
| Metoda | Jak |
|---|---|
| Parametr zapytania | `key=ADDROVA_KEY`, akceptowany tylko na trasach /compat, ze względu na zgodność. Nigdy nie jest logowany. |
| Nagłówek | `X-API-Key` lub klucz jako token bearer |