Dlaczego warto używać interfejsu Address Validation API
Dzięki interfejsowi API do weryfikacji adresów możesz zwiększyć przewidywalność doręczenia i zmniejszyć liczbę niepowodzeń, co poprawi wrażenia klientów. Możesz to zrobić, aby wykrywać nieprawidłowe adresy i lepiej poznawać ich właściwości.
Jeśli nie musisz weryfikować poszczególnych elementów adresu, interfejs Geocoding API może być lepszym rozwiązaniem. Interfejs Geocoding API konwertuje adresy na współrzędne szerokości i długości geograficznej. Interfejs Address Validation API sprawdza poprawność adresów. Aby uzyskać szczegółowe porównanie, zapoznaj się z artykułem Tworzenie funkcji weryfikacji lokalizacji za pomocą platformy Mapy Google w Architecture Center.
Co można robić za pomocą interfejsu Address Validation API
Wypróbuj wersję demonstracyjną
Za pomocą interfejsu API weryfikacji adresów możesz sprawdzić, czy adres odnosi się do prawdziwego miejsca. Jeśli adres nie odnosi się do prawdziwego miejsca, interfejs API może wskazać potencjalnie błędne komponenty, które możesz przedstawić klientom w celu ich poprawienia. Oto przykładowy proces obsługi interfejsu API:
Klient podaje adres – na poniższym obrazku widać podstawowy formularz, który umożliwia klientowi podanie adresu, prawdopodobnie 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 sprawdza i standardyzuje adres – w odpowiedzi interfejs Address Validation API zwraca pełny adres określony przez interfejs API lub wskazuje, gdzie brakuje informacji.
Klient potwierdza lub poprawia adres – w zależności od tego, co zwraca interfejs API, możesz wyświetlić klientowi te prompty: A. Potwierdź zalecany adres. B. Podaj brakujące informacje. C. Popraw adres.
Jak działa interfejs Address Validation API
Weryfikacja adresu akceptuje żądanie POST z adresem w postaci treści JSON. Dzieli adres na poszczególne elementy, a potem próbuje wykonać te czynności:
- Poprawne – zapewnia weryfikację na poziomie komponentu, w tym w sublokacjach, jeśli są dostępne.
- Kompletuje – próbuje wywnioskować brakujące lub nieprawidłowe elementy adresu.
- Formaty – czyści i standaryzuje format komponentów adresu.
Zasoby
W tabeli poniżej podano podsumowanie zasobów dostępnych za pomocą interfejsu Address Validation API wraz z zwracanymi przez niego danymi. Szczegółowe informacje znajdziesz w dokumentacji interfejsu Address Validation API.
| Zasoby danych | Zwrócone dane |
|---|---|
|
Adresy komponentów w formacie JSON. Zobacz Weryfikowanie adresu. |
Pełny, zweryfikowany adres (jeśli to możliwe). Stan weryfikacji każdego elementu adresu. Gdzie jest dostępny adres:
Zapoznaj się z artykułem Informacje o weryfikacji odpowiedzi. |
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 nieprawidłowymi. Demonstracja umożliwia zapoznanie się z wartościami zwracanymi przez usługę oraz z odpowiedzią interfejsu API w formacie JSON. |
| 2 | Sprawdzanie zasięgu | Zapoznaj się z szczegółami obsługi, aby sprawdzić, w których krajach i regionach interfejs API weryfikacji adresów jest dostępny. |
| 3 | Konfiguracja | Zacznij od konfigurowania projektu Google Cloud i wykonaj podane niżej instrukcje. |
| 4 | Wyślij prośbę o weryfikację adresu | Zacznij od adresu podstawowego, a potem, aby zwiększyć dokładność, włącz CASS (tylko w przypadku adresów w Stanach Zjednoczonych i Puerto Rico). Zobacz Prośba o weryfikację adresu. |
| 5 | Przetwarzanie odpowiedzi | Odpowiedź interfejsu Address Validation API zawiera 2 właściwości, z których każdą można używać na różne sposoby. Zobacz artykuł Omówienie podstawowej odpowiedzi. |
| 6 | Zwiększanie dokładności weryfikacji | Możesz pomóc poprawić dokładność adresów, przesyłając opinie na temat odpowiedzi 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 Bibliotekach klienta.
Informacje o CASS™
United States Postal Service® (USPS®)1 utrzymuje System obsługi dokładności kodowania (CASS™), aby wspierać i certyfikować dostawców usług weryfikacji adresów. Usługa CASS Certified™, np. interfejs API do weryfikacji adresów, została potwierdzona pod kątem możliwości uzupełniania brakujących informacji w adresie, jego standaryzacji i aktualizowania, aby zapewnić najbardziej aktualny i najdokładniejszy adres.
CASS nie jest domyślnie włączona i jest obsługiwana tylko w regionach „US” i „PR”. Aby włączyć CASS, ustaw wartość parametru enableUspsCass na true w żądaniu weryfikacji. Więcej informacji znajdziesz w artykule Weryfikowanie adresu.
W ramach korzystania z usług USPS USPS ocenia prośby o adresy utworzone sztucznie. Jeśli USPS uzna, że adres wejściowy został utworzony w sposób sztuczny, Google musi zaprzestać weryfikowania adresów dla klienta i przekazać USPS informacje kontaktowe klienta (imię i nazwisko oraz adres), odpowiedni adres wejściowy oraz zagregowane dane o korzystaniu. Korzystając z interfejsu API, wyrażasz zgodę na te Warunki korzystania z usługi.
Co dalej?
- Wypróbuj wersję demonstracyjną: otwórz Demo.
- Sprawdź obszary zasięgu: kliknij Szczegóły dotyczące zasięgu w krajach i regionach.
- Wyślij pierwszą prośbę o weryfikację: kliknij Wyślij prośbę o weryfikację adresu.
- Przetwarzanie adresów w dużej ilości: zapoznaj się z artykułem Używanie interfejsu Address Validation API do przetwarzania adresów w dużej ilości.
-
Google Maps Platform jest licencjobiorcą niewyłącznym United States Postal Service®. Następujące znaki towarowe są własnością United States Postal Service® i są używane za zgodą: United States Postal Service®, CASS™, CASS Certified™. ↩