Omówienie interfejsu Validation API

Interfejs Address Validation API to usługa, która akceptuje adresy. Identyfikuje i weryfikuje składniki adresu. a także ustandaryzuje adres pocztowy i znajduje dla niego najbardziej znane 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 Validation API

Za pomocą interfejsu Address Validation API możesz zwiększyć przewidywalność dostawy i zmniejszyć liczbę błędów podczas dostawy, co przekłada się na większą wygodę klientów. Wystarczy wyłapać nieprawidłowe adresy i uzyskać lepsze informacje o cechach adresowych.

Interfejs Geocoding API może lepiej odpowiadać Twoim potrzebom, jeśli nie musisz weryfikować poszczególnych komponentów adresu. Geocoding API konwertuje adresy na współrzędne szerokości i długości geograficznej, natomiast interfejs Address Validation API weryfikuje ich poprawność. Szczegółowe porównanie znajdziesz w artykule Tworzenie możliwości weryfikacji lokalizacji budynku przy użyciu Google Maps Platform w Centrum architektury.

Do czego służy interfejs Address Validation API

Za pomocą interfejsu Address Validation 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 wykryć prawdopodobnie nieprawidłowe komponenty, które możesz zaprezentować klientom w celu poprawienia. Oto przykładowy przepływ pracy przy użyciu interfejsu API:

1. Klient wpisuje adres – na ilustracji poniżej znajdziesz prosty formularz, za pomocą którego klient może podać adres, np. 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 ustandaryzuje adres – w odpowiedzi interfejs Address Validation API zwraca pełny adres określony przez interfejs API lub wskazuje brak informacji.

4. Klient poprawia lub potwierdza zalecany adres – w zależności od tego, co zwraca interfejs API, możesz wyświetlać klientowi następujące komunikaty:

   • Pokaż klientowi zalecany adres, aby potwierdzić:
     

   • Poproś klienta o uzupełnienie brakujących informacji:
     

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

Jak działa interfejs Address Validation API

Weryfikacja adresu akceptuje żądanie POST z adresem w formie treści JSON. Następnie dzieli adres na poszczególne elementy, a następnie sprawdza i poprawia te informacje:

• Prawidłowo – przeprowadza weryfikację na poziomie komponentu, w tym w lokalach podrzędnych, jeśli są dostępne.
• Ukończono – próby wykrycia brakujących lub nieprawidłowych komponentów adresu.
• Prawidłowo sformatowany – czyści i ustandaryzuje format komponentów adresu.

Wypróbuj wersję demonstracyjną, aby zobaczyć, jak działa interfejs Address Validation API.

Zasoby

W tabeli poniżej znajdziesz podsumowanie zasobów dostępnych przez interfejs Address Validation API oraz zwracane przez niego dane. Szczegółowe informacje znajdziesz w dokumentacji interfejsu Address Validation API.

Zasoby danych	Zwrócone dane
Adresuj komponenty w formacie JSON. Więcej informacji znajdziesz w sekcji Weryfikowanie adresu.	Pełny, zweryfikowany adres (jeśli to możliwe). Stan weryfikacji każdego komponentu adresu. Jeśli adres jest dostępny: Geokod Dokładność adresu dane dotyczące usług pocztowych (jeśli są dostępne); Zapoznaj się z sekcją Interpretowanie odpowiedzi na żądanie weryfikacji.

Jak korzystać z interfejsu Address Validation API

1	Wypróbuj	Zapoznaj się z prezentacją, korzystając z różnych formularzy adresowych, zarówno poprawnych, jak i nieprawidłowych. Wersja demonstracyjna stanowi przydatny sposób badania zarówno wartości zwracanych przez usługę, jak i odpowiedzi interfejsu API w formacie JSON.
2	Sprawdź zasięg	Sprawdź szczegóły pokrycia, aby zobaczyć, które kraje i regiony są obsługiwane przez interfejs Address Validation API.
3	Konfiguracja	Zacznij od skonfigurowania projektu Google Cloud i wykonaj kolejne instrukcje.
4	Prośba o sprawdzenie 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). Zapoznaj się z sekcją Przesyłanie prośby o sprawdzenie adresu.
5	Przetwarzanie odpowiedzi	Odpowiedź interfejsu Address Validation API zawiera 2 właściwości, z których każdej używasz 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 opinię na temat odpowiedzi interfejsu Address Validation API. Zapoznaj się z sekcją Obsługa zaktualizowanych adresów.

Dostępne biblioteki klienta

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

Informacje o CASSTM

Organizacja United States Postal Service® (USPS®)¹ obsługuje system wsparcia dokładności kodowania (CASSTM), aby obsługiwać i certyfikować dostawców weryfikacji adresów. Potwierdzono, że usługa CASS CertifiedTM, np. Address Validation API, może uzupełniać informacje brakujące w adresie, ustandaryzować i aktualizować je tak, aby dostarczały jak najbardziej aktualny i najdokładniejszy adres.

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

W ramach korzystania z usług USPS USPS rozpatruje wnioski o sztucznie utworzone adresy. Gdy USPS rozpozna adres wejściowy jako sztucznie utworzony, Google musi zaprzestać weryfikacji adresów klienta i przekazać firmie USPS jego dane kontaktowe (imię i nazwisko oraz adres), odpowiedni adres wejściowy oraz zbiorcze dane o korzystaniu. Korzystając z interfejsu API, wyrażasz zgodę na te dodatkowe warunki korzystania z usługi.

Co dalej

• Przejrzyj najczęstsze pytania: przejdź do sekcji Najczęstsze pytania.
• Sprawdź obsługiwane obszary: przejdź do sekcji Informacje o zasięgu w poszczególnych krajach i regionach.
• Przetwarzanie adresów z dużą ilością danych: przeczytaj artykuł na temat korzystania z interfejsu Address Validation API do przetwarzania adresów z dużą liczbą odbiorców.