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:
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.
Aplikacja wysyła adres do interfejsu API – aplikacja przekazuje ten adres jako dane wejściowe do interfejsu Address Validation API.
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.
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:
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®)1 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.
-
Google Maps Platform jest niewyłącznym licencjobiorcą Stanów Zjednoczonych Postal Service®. Następujące znaki towarowe należą do amerykańskiej poczty Postal Service® i są używane za zgodą: United States Postal Service®, CASSTM, CASS CertifiedTM. ↩