Przejście z Google Geocoding API w jednej linii

Addrova oferuje punkt końcowy zgodny z Google. W większości przypadków zmieniasz bazowy adres URL i klucz, a resztę kodu zachowujesz.

Szybki start (EN)Zobacz, co jest obsługiwane

Przed i po

Produkcyjny bazowy adres URL https://api.addrova.eu nie jest jeszcze aktywny; poniższa ścieżka pochodzi ze specyfikacji API.

Google

https://maps.googleapis.com/maps/api/geocode/json
  ?address=10+rue+de+Rivoli+Paris
  &key=GOOGLE_KEY

Addrova (punkt końcowy zgodny)

https://api.addrova.eu/compat/google/maps/api/geocode/json
  ?address=10+rue+de+Rivoli+Paris
  &key=ADDROVA_KEY

Emulowany jest wyłącznie format zapytań i odpowiedzi. Nie są używane żadne dane Google.

Co jest obsługiwane

Element	Obsługa
address	Geokodowanie proste
latlng	Geokodowanie odwrotne (`lat,lng`)
components	Uwzględniane jest tylko `country:XX`
language, region	Akceptowane
Odpowiedź	status, results z formatted_address, place_id, types, partial_match, address_components i geometry (location, location_type, viewport)
Błędy	W formacie Google: pole `status` z HTTP 200, aby istniejący klienci nadal działali
Rozszerzenie Addrova	Lista `attribution`, ignorowana przez istniejących klientów; wyświetlaj ją obok wyników

Wartość place_id to identyfikator Addrova, a nie place ID Google: nie mieszaj ich.

Lista kontrolna przejścia

Zastąp bazowy adres URL, prefiks ścieżki i klucz API.
Przepuść próbkę własnych adresów przez obie usługi i porównaj wyniki.
Wyświetlaj atrybucję obok wyników, jak wymagają licencje danych.
Po walidacji zapisz współrzędne we własnej bazie danych. Nie obowiązuje żaden termin wygaśnięcia.

Dlaczego przechowywanie ma znaczenie

Warunki Google ograniczają czas, przez jaki szerokość i długość geograficzną można przechowywać w pamięci podręcznej, a tylko identyfikatory miejsc można zachować bezterminowo (zob. warunki Google Maps Platform i zasady Geocoding API). Jeśli musisz zachować współrzędne, sprawdź obowiązujące warunki dla swojego przypadku. Addrova dopuszcza trwałe przechowywanie.