Omówienie interfejsu Validation API

Omówienie weryfikacji adresu

Interfejs Address Verification API to usługa, która akceptuje adres. Określa i weryfikuje komponenty adresu. Standaryzuje też adres do wysyłki i znajduje najbardziej znane dla niego współrzędne szerokości i długości geograficznej. Opcjonalnie w przypadku adresów w Stanach Zjednoczonych i Portoryko możesz włączyć system wsparcia dokładności kodowania (CASSTM).

Dlaczego warto korzystać z interfejsu Address Verificationation API

Za pomocą interfejsu Address Review API możesz poprawić przewidywalność dostarczania i zmniejszyć liczbę błędów podczas dostarczania, a w efekcie poprawić wygodę klientów. W tym celu wychwytuje nieprawidłowe adresy i uzyskuje lepsze informacje o ich cechach.

Jeśli nie musisz weryfikować poszczególnych komponentów adresu, interfejs Geocoding API może być lepiej dopasowany do Twoich potrzeb. Interfejs Geocoding API przekształca adresy na współrzędne szerokości i długości geograficznej, natomiast interfejs Address Verificationation API weryfikuje adresy pod kątem poprawności. Szczegółowe porównanie znajdziesz w artykule o możliwości weryfikacji lokalizacji budynków przy użyciu Google Maps Platform w Centrum architektury.

Co można zrobić przy użyciu interfejsu Address Verificationation API

Za pomocą interfejsu Address Billingation API możesz określić, czy adres odnosi się do rzeczywistego miejsca. Jeśli adres nie odnosi się do rzeczywistego miejsca, interfejs API może zidentyfikować potencjalnie nieprawidłowe komponenty, które możesz przedstawić klientom do poprawienia. Oto przykładowy przepływ pracy przy użyciu interfejsu API:

  1. Klient wpisuje adres – poniższa ilustracja przedstawia prosty formularz, w którym klient może wpisać adres, np. w ramach procesu płatności.
    Adres podany przez klienta.

  2. Aplikacja wysyła adres do interfejsu API – aplikacja przekazuje ten adres jako dane wejściowe do interfejsu Address Verificationation API.

  3. API weryfikuje i ustandaryzuje adres – w odpowiedzi interfejs Address Review API zwraca pełny adres określony przez interfejs API lub wskazuje, gdzie brakuje informacji.

  4. Klient poprawia lub potwierdza zalecany adres – w zależności od tego, co zwraca interfejs API, możesz wyświetlić klientowi te komunikaty:

    • Pokaż zalecany adres, który klient może potwierdzić:
      Poproś klienta o potwierdzenie adresu określonego w interfejsie API.

    • Poproś klienta o dodanie brakujących informacji:
      Poproś klienta o wpisanie brakujących danych adresowych.

    • Poproś użytkownika o poprawienie adresu, jeśli interfejs API nie może zweryfikować podanego adresu z powodu brakujących lub nieprawidłowych informacji:
      Poproś klienta o poprawienie danych adresowych.

Jak działa interfejs Address Billingation API

Weryfikacja adresu akceptuje żądanie POST z adresem w formie treści JSON. Dzieli on adres na poszczególne składniki, a następnie wykonuje te czynności sprawdzające i korygujące:

  • Prawidłowo – zapewnia testy weryfikacji na poziomie komponentów, w tym lokalizacje podrzędne, jeśli są dostępne.
  • Ukończono – próby wywnioskowania brakujących lub nieprawidłowych komponentów adresu.
  • Dobrze sformatowany – czyści i ujednolica format komponentów adresu.

Obejrzyj prezentację, aby zobaczyć, jak działa interfejs Address Verificationation API.

Zasoby

W tabeli poniżej znajdziesz podsumowanie zasobów dostępnych za pomocą interfejsu Address Review API oraz zwracanych przez nie danych. Szczegółowe informacje znajdziesz w dokumentacji interfejsu Address Review API.

Zasoby danych Zwrócone dane

Adresy w formacie JSON.

Zobacz Weryfikowanie adresu.

Pełny, zweryfikowany adres (jeśli to możliwe).

Stan weryfikacji każdego komponentu adresu.

Jeśli występuje dla danego adresu:

  • Geokod
  • Dokładność adresu
  • Dane dotyczące usług pocztowych (jeśli są dostępne).

Więcej informacji znajdziesz w sekcji Interpretowanie odpowiedzi weryfikacyjnej.

Jak korzystać z interfejsu Address Verificationation API

1 Wypróbuj wersję demonstracyjną Zapoznaj się z prezentacją, używając różnych formularzy adresowych, zarówno poprawnych, jak i nieprawidłowych. Wersja demonstracyjna udostępnia użyteczny sposób poznawania zarówno wartości zwracanych przez usługę, jak i odpowiedzi interfejsu API w formacie JSON.
2 Sprawdzanie zasięgu Sprawdź szczegóły zasięgu, aby zobaczyć, które kraje i regiony obsługuje interfejs Address Verificationation API.
3 Skonfiguruj Zacznij od konfigurowania projektu Google Cloud i postępuj zgodnie z podanymi niżej instrukcjami.
4 Wysyłanie prośby o weryfikację adresu Zacznij od prostego adresu, a następnie, aby zwiększyć dokładność, możesz włączyć CASS (tylko w przypadku adresów w Stanach Zjednoczonych i PR). Zobacz Wysyłanie prośby o weryfikację adresu.
5 Przetwarzanie odpowiedzi Odpowiedź interfejsu Address Verification API zawiera 2 właściwości, z których każda jest używana w inny sposób. Zobacz Omówienie odpowiedzi podstawowej.
6 Zwiększanie dokładności weryfikacji Możesz pomóc zwiększyć dokładność adresów, przesyłając opinię o odpowiedziach interfejsu Address Verificationation API. Zobacz Obsługa zaktualizowanych adresów.

Dostępne biblioteki klienta

Listę dostępnych bibliotek klienta dla interfejsu Address Review API znajdziesz w sekcji Biblioteki klienta.

CASSTM – informacje

Amerykański urząd pocztowy® (USPS®)1 utrzymuje system wsparcia dokładności kodowania (Coding Accuracy Support System (CASSTM)), aby wspierać i certyfikować dostawców usług weryfikacji adresów. Potwierdzono, że usługa CASS CertificateTM, na przykład Address Review API, może uzupełniać informacje brakujące w adresie, ustandaryzować je i aktualizować w celu uzyskania najnowszego i najdokładniejszego adresu.

Funkcja CASS nie jest domyślnie włączona i jest obsługiwana tylko w regionach „US” i „PR”. Aby włączyć CASS, ustaw enableUspsCass na true w ramach żądania weryfikacji. Więcej informacji znajdziesz w artykule o weryfikowaniu adresu.

W ramach korzystania z usług USPS firma USPS rozpatruje wnioski dotyczące sztucznie utworzonych adresów. Jeśli USPS zidentyfikuje adres wejściowy jako sztucznie utworzony, Google ma obowiązek przestać weryfikować adresy klientów i musi podać informacje kontaktowe klienta (imię i nazwisko oraz adres), odpowiedni adres wejściowy oraz zbiorcze dane o korzystaniu do USPS. Korzystając z interfejsu API, akceptujesz te dodatkowe warunki korzystania z usługi.

Co dalej?


  1. Google Maps Platform jest niewyłącznym licencjobiorcą amerykańskiej poczty Postal Service®. Następujące znaki towarowe należą do Stanów Zjednoczonych Postal Service® i są używane za zgodą: United States Postal Service®, CASSTM, CASS CertifiedTM.