Krótkie wprowadzenie do Address Validation API

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

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ść addressComplete jest pomijana w werdykcie, gdy jej wartość to false, 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ść addressComplete jako false lub sprawdź, czy właściwość jest obecna. Zobacz /maps/documentation/address-validation/understand-response.
  • Problem: jeśli parametr regionCode zostanie pominięty, interfejs API określi region na podstawie adresu, co może dać gorsze wyniki. Rozwiązanie: podaj regionCode w PostalAddress, jeśli go znasz. Zobacz /maps/documentation/address-validation/requests-validate-address.
  • Problem: nie ma gwarancji, że obiekt uspsData będzie w pełni wypełniony w przypadku każdego zweryfikowanego adresu w USA. Rozwiązanie: nie polegaj na uspsData jako 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ą provideValidationFeedback musi odwoływać się do responseId z pierwszego wywołania validateAddress w sekwencji, a nie z późniejszego. Rozwiązanie: zapisz parametr responseId z pierwszej odpowiedzi validateAddress i 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.