Address Validation API akceptuje adres, identyfikuje jego komponenty i je weryfikuje, standaryzuje adres na potrzeby wysyłki pocztą i zwraca najlepiej dopasowane współrzędne szerokości i długości geograficznej. W przypadku adresów w Stanach Zjednoczonych i Portoryko możesz opcjonalnie włączyć przetwarzanie USPS CASS.
Address Validation API: najważniejsze informacje
- Usługa: Address Validation API
- Kategoria: Miejsca
- Platforma: usługa internetowa (REST)
- Działa na: serwerze (kod backendu)
- Etap uruchomienia: GA
- Cykl życia: aktywny
- Omówienie: Address Validation API
- Dostępność: ograniczona. Obsługiwane kraje i jakość danych różnią się w zależności od kraju, a niektóre kraje są w wersji testowej. Metadane dotyczące budynków mieszkalnych i komercyjnych są zwracane tylko w przypadku krajów oznaczonych na stronie zasięgu. Usługa USPS CASS jest obsługiwana tylko w Stanach Zjednoczonych i Portoryko. (szczegóły dotyczące zakresu ochrony)
Address Validation API: kiedy z niego korzystać
Kiedy używać interfejsu Address Validation API:
- Musisz sprawdzić, czy adres odnosi się do rzeczywistego miejsca, i znaleźć brakujące lub potencjalnie nieprawidłowe komponenty.
- Musisz ustandaryzować i uzupełnić adres na potrzeby poczty, na przykład podczas procesu płatności.
- W przypadku adresów w Stanach Zjednoczonych lub Portoryko potrzebujesz certyfikatu USPS CASS i
uspsData. - Potrzebujesz metadanych adresu domowego lub firmowego w kraju wymienionym na stronie z informacjami o zasięgu.
Nie używaj interfejsu Address Validation API, gdy:
- Wystarczy, że przekonwertujesz adres na szerokość i długość geograficzną, i nie musisz sprawdzać poszczególnych komponentów adresu. Zamiast tego użyj interfejsu Geocoding API.
- Potrzebujesz bardzo szczegółowych informacji o miejscu docelowym, takich jak wejścia do budynków, ich obrysy czy punkty nawigacyjne. Zamiast tego użyj interfejsu Geocoding API.
Address Validation API: konfiguracja
- Usługa do włączenia:
addressvalidation.googleapis.com - Uwierzytelnianie: klucz interfejsu API, OAuth 2.0, konto usługi.
- Pierwsze kroki: skonfiguruj Address Validation API
- Dokumentacja: dokumentacja Address Validation API
- Ceny: korzystanie z Address Validation API i płatności
- Zasady: zasady dotyczące interfejsu Address Validation API
- Informacje o wersjach: informacje o wersjach Address Validation API
Oficjalne pakiety Address Validation API:
- npm:
@googlemaps/addressvalidation - pypi:
google-maps-addressvalidation - go:
cloud.google.com/go/maps
Address Validation API: częste błędy
- Problem: właściwość
addressCompletejest pomijana w werdykcie, gdy jej wartość tofalse, więc kod, który oczekuje obecności tego pola, może błędnie odczytać niekompletne adresy. Rozwiązanie: traktuj brakującą właściwośćaddressCompletejakofalselub sprawdź, czy właściwość jest obecna. Zobacz /maps/documentation/address-validation/understand-response. - Problem: jeśli parametr
regionCodezostanie pominięty, interfejs API określi region na podstawie adresu, co może dać gorsze wyniki. Rozwiązanie: podajregionCodewPostalAddress, jeśli go znasz. Zobacz /maps/documentation/address-validation/requests-validate-address. - Problem: nie ma gwarancji, że obiekt
uspsDatabędzie w pełni wypełniony w przypadku każdego zweryfikowanego adresu w USA. Rozwiązanie: nie polegaj nauspsDatajako jedynym sygnale weryfikacji. Używaj też werdyktu i komponentów adresu. Zobacz /maps/documentation/address-validation/handle-us-address. - Problem: opinia wysłana za pomocą
provideValidationFeedbackmusi odwoływać się doresponseIdz pierwszego wywołaniavalidateAddressw sekwencji, a nie z późniejszego. Rozwiązanie: zapisz parametrresponseIdz pierwszej odpowiedzivalidateAddressi wyślij go w żądaniu opinii. Zobacz /maps/documentation/address-validation/handle-updated-address.
Co możesz zrobić za pomocą interfejsu Address Validation API
Zapoznaj się z przewodnikami po poszczególnych zadaniach, do których linki znajdziesz poniżej, lub porównaj usługi w Eksploratorze funkcji.
- Zwracanie zweryfikowanego adresu dla określonego adresu lub częściowego adresu.
- Zwracanie współrzędnych szerokości i długości geograficznej dla zweryfikowanego adresu.
- Zwracanie identyfikatora miejsca Google dla zweryfikowanego adresu.
- Użyj certyfikatu Coding Accuracy Support System (CASS) wydanego przez United States Postal Service (USPS) do weryfikacji adresów.
- Zwracaj informacje o tym, czy zweryfikowany adres jest adresem firmy, adresem zamieszkania czy skrytką pocztową.
- Zwracanie metadanych dostawy United States Postal Service (USPS) dla zweryfikowanego adresu.
- Zwracanie angielskiej wersji zweryfikowanego adresu. Podgląd
- Zwracanie kodu Plus Code dla zweryfikowanego adresu.