Omówienie interfejsu Validation API

Wprowadzenie

Address Validation API to usługa, która akceptuje adres. Identyfikuje komponenty adresu i je weryfikuje. Standaryzuje też adres na potrzeby wysyłki pocztą i określa dla niego najlepsze znane współrzędne określające szerokość i długość geograficzną. Opcjonalnie w przypadku adresów w Stanach Zjednoczonych i Portoryko możesz włączyć system CASS™.

Dlaczego warto korzystać z interfejsu Address Validation API

Dzięki interfejsowi Address Validation API możesz zwiększyć przewidywalność dostaw i zmniejszyć liczbę nieudanych dostaw, co poprawi komfort klientów. Możesz to zrobić, wychwytując nieprawidłowe adresy i uzyskując lepszą wiedzę o ich cechach.

Jeśli nie musisz weryfikować poszczególnych komponentów adresu, lepszym rozwiązaniem może być interfejs Geocoding API. Interfejs Geocoding API konwertuje adresy na współrzędne geograficzne. Interfejs Address Validation API sprawdza poprawność adresów. Szczegółowe porównanie znajdziesz w artykule Tworzenie funkcji weryfikacji lokalizacji budynku za pomocą platformy Map Google w Centrum architektury.

Możliwości interfejsu Address Validation API

inputWypróbuj wersję demonstracyjną

Za pomocą interfejsu Address Validation API możesz sprawdzić, czy adres odnosi się do rzeczywistego miejsca. Jeśli adres nie odnosi się do rzeczywistego miejsca, interfejs API może zidentyfikować prawdopodobnie nieprawidłowe komponenty, które możesz przedstawić klientom do poprawienia. Oto przykładowy proces korzystania z interfejsu API:

1. Klient wpisuje adres – na poniższym obrazie widać prosty formularz, który umożliwia klientowi wpisanie adresu, prawdopodobnie w ramach procesu płatności.

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

   

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

4. Klient potwierdza lub poprawia adres – w zależności od tego, co zwraca interfejs API, możesz wyświetlić klientowi te komunikaty:A. Potwierdź rekomendowany adres. B. Podaj brakujące informacje. C. Popraw adres.

   

Jak działa Address Validation API

Weryfikacja adresu akceptuje żądanie POST z adresem w formie treści JSON. Dzieli adres na poszczególne komponenty, a następnie próbuje wykonać te czynności:

• Poprawia – zapewnia weryfikację na poziomie komponentów, w tym w przypadku dostępności podlokalizacji.
• Uzupełnia – próbuje wywnioskować brakujące lub nieprawidłowe elementy adresu.
• Formaty – oczyszcza i standaryzuje format komponentów adresu.

Zasoby

W tabeli poniżej znajdziesz podsumowanie zasobów dostępnych w interfejsie Address Validation API wraz z danymi, które zwraca. Szczegółowe informacje znajdziesz w dokumentacji interfejsu Address Validation API.

Zasoby danych	Zwrócone dane
Komponenty adresu w formacie JSON. Zobacz Weryfikowanie adresu.	Pełny, zweryfikowany adres (jeśli to możliwe). Stan weryfikacji każdego komponentu adresu. Jeśli adres jest dostępny: Geokodowanie Dokładność adresu dane usług pocztowych, jeśli są dostępne; Zobacz Interpretowanie odpowiedzi weryfikacyjnej.

Jak korzystać z interfejsu Address Validation API

1	Wypróbuj wersję demonstracyjną	Wypróbuj wersję demonstracyjną z różnymi formami adresów, zarówno poprawnymi, jak i niepoprawnymi. Wersja demonstracyjna to przydatny sposób na zapoznanie się zarówno z wartościami zwracanymi przez usługę, jak i z odpowiedzią interfejsu API w formacie JSON.
2	Sprawdź zasięg	Sprawdź szczegóły zasięgu, aby dowiedzieć się, które kraje i regiony są obsługiwane przez interfejs Address Validation API.
3	Konfiguracja	Zacznij od sekcji Konfigurowanie projektu Google Cloud i wykonaj podane tam instrukcje.
4	Przesyłanie prośby o weryfikację adresu	Zacznij od podstawowego adresu, a potem, aby zwiększyć dokładność, możesz włączyć CASS (tylko w przypadku adresów w Stanach Zjednoczonych i Portoryko). Zobacz Prośba o weryfikację adresu.
5	Przetwarzanie odpowiedzi	Odpowiedź interfejsu Address Validation API zawiera 2 właściwości, z których każda jest używana w inny sposób. Zobacz Omówienie podstawowej odpowiedzi.
6	Zwiększanie dokładności weryfikacji	Możesz pomóc zwiększyć dokładność adresów, przesyłając opinie o odpowiedziach interfejsu Address Validation API. Zobacz Obsługa zaktualizowanych adresów.

Dostępne biblioteki klienta

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

Informacje o CASS™

United States Postal Service® (USPS®)¹ prowadzi Coding Accuracy Support System (CASS™), który wspiera i certyfikuje dostawców usług weryfikacji adresów. Usługa z certyfikatem CASS Certified™, taka jak Address Validation API, została potwierdzona pod kątem możliwości uzupełniania informacji, których brakuje w adresie, standaryzowania go i aktualizowania, aby zapewnić Ci najbardziej aktualny i dokładny adres.

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

W ramach korzystania z usług USPS firma ta ocenia prośby dotyczące adresów utworzonych sztucznie. Jeśli USPS uzna, że adres wejściowy został utworzony sztucznie, Google musi zaprzestać weryfikacji adresów dla klienta i przekazać USPS informacje kontaktowe klienta (imię i nazwisko oraz adres), odpowiedni adres wejściowy i zagregowane dane o użytkowaniu. Korzystając z interfejsu API, wyrażasz zgodę na te Warunki korzystania z konkretnych usług.

Co dalej?

• Wypróbuj wersję demonstracyjną: kliknij Demo
• Sprawdź obszary objęte usługą: otwórz szczegóły dotyczące krajów i regionów objętych usługą.
• Wyślij pierwszą prośbę o weryfikację: otwórz stronę Wysyłanie prośby o weryfikację adresu
• Przetwarzanie dużej liczby adresów: przejdź do artykułu Przetwarzanie dużej liczby adresów za pomocą interfejsu Address Validation API