Package google.maps.addressvalidation.v1

Indeks

AddressValidation

Usługa weryfikacji adresów.

ProvideValidationFeedback

rpc ProvideValidationFeedback(ProvideValidationFeedbackRequest) returns (ProvideValidationFeedbackResponse)

Informacje o wyniku sekwencji prób weryfikacji. To powinno być ostatnie wywołanie po sekwencji wywołań weryfikujących ten sam adres. Wywołanie to powinno nastąpić po zakończeniu transakcji. Należy go wysłać tylko raz w przypadku sekwencji ValidateAddress żądań potrzebnych do pełnej weryfikacji adresu.
ValidateAddress

rpc ValidateAddress(ValidateAddressRequest) returns (ValidateAddressResponse)

Sprawdzanie poprawności adresu.

Adres

Szczegóły adresu po przetworzeniu. Przetwarzanie wsteczne obejmuje poprawianie błędnie zapisanych części adresu, zastępowanie nieprawidłowych części i wywnioskowanie brakujących części.

Pola
formatted_address

string

Adres po przetworzeniu, sformatowany jako adres jednowierszowy zgodnie z zasadami formatowania adresów obowiązującymi w regionie, w którym się znajduje.

Uwaga: format tego adresu może być inny niż format adresu w polu postal_address. Na przykład postal_address zawsze reprezentuje kraj jako 2-literowy region_code, np. „US” lub „NZ”. W tym polu używa się dłuższej formy nazwy kraju, np. „USA” lub „Nowa Zelandia”.
postal_address

PostalAddress

Adres po przetworzeniu w postaci adresu pocztowego.
address_components[]

AddressComponent

Lista nieuporządkowana. Poszczególne elementy adresu w sformatowanym i poprawionym adresie wraz z informacjami weryfikacyjnymi. Zawiera on informacje o stanie weryfikacji poszczególnych komponentów.

Elementy adresu nie są uporządkowane w określony sposób. Nie należy zakładać kolejności elementów adresu na liście.
missing_component_types[]

string

Typy komponentów, które powinny być obecne w prawidłowo sformatowanym adresie e-mail, ale nie zostały znalezione w danych wejściowych ani nie można ich było wywnioskować. Przykład: ['street_number', 'route'] dla danych wejściowych takich jak „Boulder, Kolorado, 80301, USA”. Listę możliwych typów znajdziesz tutaj.

Uwaga: jeśli uważasz, że brakuje komponentu, który już został przesłany, możesz zobaczyć brakujący typ komponentu. Może się tak zdarzyć, gdy adres wejściowy zawiera nazwę budynku, ale nie numer lokalu. W adresie „渋谷区渋谷３丁目　Shibuya Stream” nazwa budynku „Shibuya Stream” ma typ komponentu premise, ale brakuje numeru lokalu, więc missing_component_types będzie zawierać premise.
unconfirmed_component_types[]

string

Typy komponentów obecnych w address_components, których poprawności nie udało się potwierdzić. To pole jest dostępne dla wygody użytkowników. Jego zawartość jest równoważna z przeszukiwaniem address_components w celu znalezienia typów wszystkich komponentów, w których confirmation_level nie jest CONFIRMED lub flaga inferred nie jest ustawiona na true. Listę możliwych typów znajdziesz tutaj.
unresolved_tokens[]

string

tokeny w danych, których nie udało się rozwiązać; Może to być dane wejściowe, które nie zostały rozpoznane jako prawidłowa część adresu. Na przykład w przypadku danych wejściowych takich jak „Parcel 0000123123 & 0000456456 Str # Guthrie Center IA 50115 US” nierozwiązane tokeny mogą wyglądać tak: ["Parcel", "0000123123", "&", "0000456456"].

AddressComponent

Reprezentuje element adresu, np. ulicę, miasto lub województwo.

Pola
component_name

ComponentName

Nazwa tego komponentu.
component_type

string

Typ elementu adresu. Listę dostępnych typów znajdziesz w tabeli 2: Dodatkowe typy zwracane przez usługę Miejsca.
confirmation_level

ConfirmationLevel

Wskazuje na poziom pewności, że komponent jest prawidłowy.
inferred

bool

Wskazuje, że element nie był częścią danych wejściowych, ale udało nam się go odgadnąć na podstawie lokalizacji adresu i uważamy, że powinien być podany w ramach pełnego adresu.
spell_corrected

bool

Wskazuje poprawkę do nieprawidłowego zapisu nazwy komponentu. Interfejs API nie zawsze sygnalizuje zmiany jednej wersji pisowni na inną, np. gdy „centre” zmienia się na „center”. Nie zawsze też oznacza błędy w pisownię, np. gdy zmienisz „Amphitheater Pkwy” na „Amphitheatre Pkwy”.
replaced

bool

Wskazuje, że nazwa komponentu została zastąpiona zupełnie inną nazwą, np. nieprawidłowy kod pocztowy został zastąpiony kodem właściwym dla adresu. To nie jest zmiana kosmetyczna, ponieważ komponent wejściowy został zastąpiony innym.
unexpected

bool

Wskazuje element adresu, który nie powinien występować w adresie pocztowym w danym regionie. Zachowaliśmy go tylko dlatego, że był częścią danych wejściowych.

ConfirmationLevel

Różne możliwe wartości poziomów potwierdzenia.

Wartości w polu enum
CONFIRMATION_LEVEL_UNSPECIFIED Wartość domyślna. Ta wartość nie jest używana.
CONFIRMED Udało nam się potwierdzić, że ten element istnieje i ma sens w kontekście reszty adresu.
UNCONFIRMED_BUT_PLAUSIBLE Nie udało się potwierdzić tego komponentu, ale jest prawdopodobne, że istnieje. Może to być na przykład numer domu w znanym zakresie numerów na ulicy, na której nie ma konkretnych numerów domów.
UNCONFIRMED_AND_SUSPICIOUS Ten komponent nie został potwierdzony i prawdopodobnie jest nieprawidłowy. Może to być na przykład dzielnica, która nie pasuje do reszty adresu.

AddressMetadata

Metadane adresu. Nie można mieć pewności, że parametr metadata będzie w pełni wypełniony w przypadku każdego adresu wysłanego do interfejsu Address Validation API.

Pola
business

bool

Wskazuje, że jest to adres firmy. Jeśli nie jest ustawiona, oznacza, że wartość jest nieznana.
po_box

bool

Wskazuje, że adres jest adresem skrytki pocztowej. Jeśli nie jest ustawiona, oznacza, że wartość jest nieznana.
residential

bool

Wskazuje, że jest to adres zamieszkania. Jeśli nie jest ustawiona, oznacza, że wartość jest nieznana.

ComponentName

Otoczka dla nazwy komponentu.

Pola
text

string

Tekst nazwy. Na przykład „5th Avenue” w przypadku nazwy ulicy lub „1253” w przypadku numeru domu.
language_code

string

Kod języka BCP-47. Nie będzie ona widoczna, jeśli nazwa komponentu nie jest powiązana z językiem, np. numer domu.

Geokodowanie

Zawiera informacje o miejscu, do którego został zgeokodowany podany tekst.

Pola
location

LatLng

Geokodowana lokalizacja danych wejściowych.

Zalecamy używanie identyfikatorów miejsc zamiast adresów, współrzędnych geograficznych czy kodów Plus Code. Korzystanie z współrzędnych podczas wyznaczania trasy lub obliczania wskazówek dojazdu zawsze powoduje przyciąganie punktu do najbliższej drogi. Droga może nie prowadzić szybko ani bezpiecznie do miejsca docelowego i być zlokalizowana z dala od punktu dostępu do obiektu. Dodatkowo, gdy lokalizacja jest odwrotnie zgeokodowana, nie ma gwarancji, że zwrócony adres będzie zgodny z pierwotnym.
plus_code

PlusCode

Plus Code odpowiadający location.
bounds

Viewport

Granice miejsca powiązanego z danymi geograficznymi.
feature_size_meters

float

Wielkość zgeokodowanego miejsca w metrach. Jest to kolejny wskaźnik dokładności zgeokodowanej lokalizacji, ale w przypadku rozmiaru fizycznego, a nie znaczenia semantycznego.
place_id

string

Identyfikator miejsca, do którego ten geokodowany przez ten input adres.

Więcej informacji o identyfikatorach miejsc znajdziesz tutaj.
place_types[]

string

Typy miejsc, do których zmapowano dane wejściowe. Na przykład: ['locality', 'political']. Pełną listę typów znajdziesz tutaj.

LanguageOptions

Wersja testowa: ta funkcja jest w wersji testowej (przed GA). Usługi i funkcje przed GA mogą mieć ograniczoną obsługę, a zmiany w takich usługach i funkcjach mogą być niezgodne z ich innymi wersjami. Oferty przed GA są objęte szczegółowymi warunkami korzystania z usługi Google Maps Platform. Więcej informacji znajdziesz w opisach etapu uruchamiania.

Umożliwia interfejsowi Address Validation API uwzględnienie dodatkowych informacji w odpowiedzi.

Pola
return_english_latin_address

bool

Podgląd: zwraca google.maps.addressvalidation.v1.Address w języku angielskim. Więcej informacji znajdziesz w artykule google.maps.addressvalidation.v1.ValidationResult.english_latin_address.

PlusCode

Kod Plus Code (http://plus.codes) to odniesienie do lokalizacji w 2 formatach: kod globalny określający prostokąt o wymiarach 14 × 14 m (1/8000 stopnia) lub mniejszy oraz kod złożony, który zastępuje prefiks lokalizacją odniesienia.

Pola
global_code

string

Globalny (pełny) kod miejsca, np. „9FWM33GV+HQ”, reprezentujący obszar o wymiarach 1/8000 x 1/8000 stopnia (~14 x 14 metrów).
compound_code

string

złożony kod miejsca, np. „33GV+HQ, Ramberg, Norwegia”, zawierający sufiks kodu globalnego i zastępujący prefiks nazwą sformatowanego elementu odniesienia.

ProvideValidationFeedbackRequest

Prośba o przesłanie opinii dotyczącej weryfikacji.

Pola
conclusion

ValidationConclusion

Wymagany. Wynik sekwencji prób weryfikacji.

Jeśli to pole ma wartość VALIDATION_CONCLUSION_UNSPECIFIED, zwracany jest błąd INVALID_ARGUMENT.
response_id

string

Wymagany. Identyfikator odpowiedzi, której dotyczy opinia. Powinien to być parametr [response_id][google.maps.addressvalidation.v1.ValidateAddressRequest.response_id] z pierwszej odpowiedzi w serii prób weryfikacji adresu.

ValidationConclusion

Możliwe końcowe wyniki sekwencji żądań weryfikacji adresu, które są potrzebne do zweryfikowania adresu.

Wartości w polu enum
VALIDATION_CONCLUSION_UNSPECIFIED Ta wartość nie jest używana. Jeśli pole ProvideValidationFeedbackRequest.conclusion ma wartość VALIDATION_CONCLUSION_UNSPECIFIED, zwracany jest błąd INVALID_ARGUMENT.
VALIDATED_VERSION_USED Wersja adresu zwrócona przez interfejs Address Validation API została użyta do transakcji.
USER_VERSION_USED W transakcji użyto wersji adresu podawanej przez użytkownika.
UNVALIDATED_VERSION_USED W transakcji użyto wersji adresu, która została wpisana po ostatniej próbie weryfikacji, ale nie została ponownie zweryfikowana.
UNUSED Transakcja została przerwana, a adres nie został użyty.

ProvideValidationFeedbackResponse

Ten typ nie ma pól.

Odpowiedź na opinię weryfikacyjną.

Jeśli opinia została przesłana, odpowiedź jest pusta.

UspsAddress

Adres w Stanach Zjednoczonych według USPS.

Pola
first_address_line

string

Pierwszy wiersz adresu.
firm

string

Nazwa firmy.
second_address_line

string

Drugi wiersz adresu.
urbanization

string

Nazwa portorykańskiej urbanizacji.
city_state_zip_address_line

string

Miasto + stan + kod pocztowy.
city

string

Nazwa miasta.
state

string

2-literowy kod stanu.
zip_code

string

Kod pocztowy, np. 10009.
zip_code_extension

string

4-cyfrowy kod pocztowy, np. 5023.

UspsData

Dane USPS dla adresu. Nie można zagwarantować, że parametr uspsData będzie w pełni wypełniony w przypadku każdego adresu w Stanach Zjednoczonych lub Portoryko wysłanego do interfejsu Address Validation API. Jeśli w odpowiedzi używasz pola uspsData jako głównego, zalecamy zintegrowanie w niej pól adresu zapasowego.

Pola
standardized_address

UspsAddress

Znormalizowany adres USPS.
delivery_point_code

string

2-cyfrowy kod punktu dostawy
delivery_point_check_digit

string

Cyfra kontrolna punktu dostawy. Ta liczba jest dodawana na końcu kodu kreskowego delivery_point_barcode w przypadku skanowania poczty w sposób mechaniczny. Dodanie wszystkich cyfr z delivery_point_barcode, delivery_point_check_digit, postal_code i ZIP+4 powinno dać liczbę podzielną przez 10.
dpv_confirmation

string

Możliwe wartości potwierdzenia DPV. Zwraca 1 znak lub nie zwraca żadnej wartości.

  • N: nie udało się potwierdzić informacji dotyczących numeru głównego ani żadnego numeru dodatkowego.
  • D: adres został potwierdzony w DPV tylko w przypadku numeru głównego, a informacje o numerze dodatkowym były niekompletne.
  • S: adres został potwierdzony w usłudze DPV tylko w przypadku numeru głównego, a informacje o numerze dodatkowym były dostępne, ale nie zostały potwierdzone.
  • Y: adres został potwierdzony przez dostawcę usług w przypadku numeru głównego i dodatkowych numerów.
  • Pusty: jeśli odpowiedź nie zawiera wartości dpv_confirmation, adres nie został przesłany do potwierdzenia przez dostawcę.
dpv_footnote

string

Uwagi dotyczące weryfikacji punktu dostawy. W jednym ciągu może być wiele przypisów.

  • AA: adres wejściowy dopasowany do pliku ZIP+4
  • A1: adres wejściowy nie został dopasowany do pliku ZIP+4
  • BB: dopasowanie do DPV (wszystkie komponenty)
  • CC: numer dodatkowy nie został dopasowany, ale nie jest wymagany
  • C1: numer dodatkowy nie pasuje, ale jest wymagany
  • N1: brak numeru dodatkowego w adresie budynku
  • M1: brak numeru głównego
  • M3: nieprawidłowy numer główny
  • P1: brak numeru pola adresu zamówienia, RR lub HC
  • P3: nieprawidłowy adres skrytki pocztowej PO, RR lub HC
  • F1: podany adres jest zgodny z adresem wojskowym
  • G1: adres podany przez użytkownika jest zgodny z adresem ogólnym
  • U1: adres podany w formularzu z powiązaniem z unikalnym kodem pocztowym
  • PB: adres wejściowy dopasowany do rekordu PBSA
  • RR: DPV potwierdził adres za pomocą informacji z PMB
  • R1: DPV potwierdził adres bez informacji PMB
  • R7: rekord R777 lub R779 operatora trasy
  • IA: zidentyfikowano adres e-mail osoby, która została powiadomiona
  • TA: numer główny dopasowany przez odrzucenie ostatniej litery alfabetu
dpv_cmra

string

Wskazuje, czy adres jest CMRA (Commercial Mail Receiving Agency) – prywatną firmą odbierającą pocztę dla klientów. Zwraca pojedynczy znak.

  • Y: adres jest adresem CMRA
  • N: adres nie jest adresem CMRA
dpv_vacant

string

Czy to miejsce jest wolne? Zwraca pojedynczy znak.

  • Y: adres jest pusty
  • N: adres nie jest pusty
dpv_no_stat

string

Czy to adres bez statystyk czy aktywny? Adresy bez statystyk to adresy, które nie są stale zajęte lub adresy, których USPS nie obsługuje. Zwraca pojedynczy znak.

  • Y: adres nie jest aktywny
  • N: adres jest aktywny
dpv_no_stat_reason_code

int32

Wskazuje typ NoStat. Zwraca kod przyczyny jako int.

  • 1: IDA (Internal Drop Address) – adresy, na które nie są wysyłane przesyłki bezpośrednio z USPS, ale są dostarczane na adresy dostawy, które je obsługują.
  • 2: CDS – adresy, które nie są jeszcze dostępne do dostarczenia. Może to być na przykład nowy podział, w którym określono już działki i numery główne, ale nie ma jeszcze struktury dla zamieszkania.
  • 3: kolizja – adresy, które nie są faktycznie potwierdzone przez DPV.
  • 4: CMZ (uczelnie, wojsko i inne typy) – kody pocztowe i 4 rekordy USPS uwzględnione w danych.
  • 5: Regular – wskazuje adresy, na które nie dotarła przesyłka. Adresy te nie są liczone jako możliwe dostawy.
  • 6: wymagane informacje dodatkowe – adres wymaga dodatkowych informacji.
dpv_drop

string

Flaga wskazuje, że wiadomość została dostarczona do jednego urządzenia na stronie. Zwraca pojedynczy znak.

  • Y: poczta jest dostarczana do jednego adresata na stronie.
  • N: poczta nie jest dostarczana do jednego miejsca odbioru w witrynie.
dpv_throwback

string

Wskazuje, że poczta nie jest dostarczana na adres ulicy. Zwraca pojedynczy znak.

  • Y: poczta nie jest dostarczana na adres ulicy.
  • N: przesyłka jest dostarczana na adres do korespondencji.
dpv_non_delivery_days

string

Flaga wskazuje, że dostawa poczty nie jest realizowana codziennie. Zwraca pojedynczy znak.

  • Y: dostawa poczty nie odbywa się codziennie.
  • N: brak informacji o tym, że dostawa poczty nie odbywa się codziennie.
dpv_non_delivery_days_values

int32

Całkowita liczba dni bez dostawy. Można go przeszukiwać za pomocą flag bitowych: 0x40 – niedziela jest dniem bez dostawy 0x20 – poniedziałek jest dniem bez dostawy 0x10 – wtorek jest dniem bez dostawy 0x08 – środa jest dniem bez dostawy 0x04 – czwartek jest dniem bez dostawy 0x02 – piątek jest dniem bez dostawy 0x01 – sobota jest dniem bez dostawy
dpv_no_secure_location

string

Flaga wskazuje, że drzwi są dostępne, ale ze względów bezpieczeństwa nie można zostawić paczki. Zwraca pojedynczy znak.

  • Y: Ze względów bezpieczeństwa paczka nie zostanie pozostawiona.
  • N: brak informacji o tym, że paczka nie zostanie pozostawiona ze względów bezpieczeństwa.
dpv_pbsa

string

Wskazuje, że adres został dopasowany do rekordu PBSA. Zwraca pojedynczy znak.

  • Y: adres został dopasowany do rekordu PBSA.
  • N: adres nie został dopasowany do rekordu PBSA.
dpv_door_not_accessible

string

Flaga wskazuje adresy, w przypadku których USPS nie może zapukać do drzwi, aby dostarczyć przesyłkę. Zwraca pojedynczy znak.

  • Y: drzwi są niedostępne.
  • N: brak informacji o tym, że drzwi są niedostępne.
dpv_enhanced_delivery_code

string

Wskazuje, że w przypadku adresu jest ważny więcej niż 1 kod zwrotu DPV. Zwraca pojedynczy znak.

  • Y: adres został potwierdzony przez dostawcę usług w przypadku numeru głównego i dodatkowych numerów.
  • N: nie udało się potwierdzić informacji dotyczących numeru głównego ani żadnego numeru dodatkowego.
  • S: adres został potwierdzony w ramach weryfikacji danych osobowych tylko w przypadku numeru głównego, a informacje o numerze dodatkowym były obecne, ale nie zostały potwierdzone. Albo też z numeru głównego usunięto jedną literę, aby dopasować dane osobowe i wymagać informacji dodatkowych.
  • D: adres został potwierdzony w DPV tylko w przypadku numeru głównego, a informacje o numerze dodatkowym były niekompletne.
  • R: adres został potwierdzony, ale został przypisany do fikcyjnej trasy R777 i R779, a usługa USPS nie została wybrana.
carrier_route

string

Kod trasy przewoźnika. Czterozyłowy kod składający się z jednoliterowego prefiksu i trzycyfrowego wskaźnika trasy.

Prefiksy:

  • C: trasa przewoźnika (lub trasa miejska)
  • R: trasa wiejska
  • H: umowa na autostradę
  • B: sekcja skrzynki pocztowej
  • G: ogólna jednostka dostawy
carrier_route_indicator

string

Wskaźnik sortowania stawki trasy przewoźnika.
ews_no_match

bool

Adres dostawy można dopasować, ale plik EWS wskazuje, że dokładne dopasowanie będzie dostępne wkrótce.
post_office_city

string

Główny urząd pocztowy w mieście.
post_office_state

string

Stan głównego urzędu pocztowego.
abbreviated_city

string

Skrót nazwy miasta.
fips_county_code

string

Kod FIPS hrabstwa.
county

string

Nazwa powiatu.
elot_number

string

Numer rozszerzonej linii podróży (eLOT).
elot_flag

string

eLOT Flaga rosnąca/malejąca (A/D).
po_box_only_postal_code

bool

Kod pocztowy tylko dla skrzynki pocztowej.
pmb_designator

string

PMB (Private Mail Box) – identyfikator jednostki.
pmb_number

string

Numer PMB (Private Mail Box);
address_record_type

string

Typ rekordu adresu pasującego do adresu wejściowego.

  • F: FIRM. Jest to dopasowanie do rekordu firmy, czyli dopasowanie na najniższym poziomie dostępne dla adresu.
  • G: OGÓLNA DOSTAWA. Jest to dopasowanie do rekordu ogólnego.
  • H: BUDYNKI / MIESZKANIA. Dopasowanie do rekordu budynku lub mieszkania.
  • P: Skrzynka pocztowa. To jest skrzynka pocztowa.
  • R: RURAL ROUTE lub HIGHWAY CONTRACT: to dopasowanie do rekordu dotyczącego umowy dotyczącej drogi wiejskiej lub autostrady. Oba rekordy mogą mieć powiązane zakresy numerów skrzynek.
  • S: RECORD STREET: dopasowanie do rekordu ulicy zawierającego prawidłowy zakres numerów głównych.
default_address

bool

Wskaźnik, że znaleziono adres domyślny, ale istnieją bardziej szczegółowe adresy.
error_message

string

Komunikat o błędzie podczas pobierania danych USPS To pole jest wypełniane, gdy przetwarzanie przez USPS jest zawieszone z powodu wykrycia sztucznie utworzonych adresów.

Gdy wystąpi ten błąd, pola danych USPS mogą nie zostać wypełnione.
cass_processed

bool

Wskaźnik, że żądanie zostało przetworzone przez CASS.

ValidateAddressRequest

Prośba o weryfikację adresu.

Pola
address

PostalAddress

Wymagany. Adres, który jest weryfikowany. Niesformatowane adresy należy przesyłać za pomocą address_lines.

Łączna długość pól w tym wejściu nie może przekraczać 280 znaków.

Obsługiwane regiony znajdziesz tutaj.

Wartość language_code w adresie wejściowym jest zarezerwowana do wykorzystania w przyszłości i jest ignorowana. Walidowany adres zostanie wypełniony na podstawie preferowanego języka danego adresu, jak to zostało zidentyfikowane przez system.

Interfejs API weryfikacji adresów ignoruje wartości w elementach recipients i organization. Wszystkie wartości w tych polach zostaną odrzucone i nie zostaną zwrócone. Nie ustawiaj ich.
previous_response_id

string

W przypadku pierwszego żądania weryfikacji adresu to pole musi być puste. Jeśli do pełnej weryfikacji jednego adresu potrzebne jest więcej żądań (np. jeśli zmiany wprowadzone przez użytkownika po początkowej weryfikacji wymagają ponownej weryfikacji), to w każdym kolejnym żądaniu należy wypełnić to pole wartością response_id z pierwszej odpowiedzi w sekwencji weryfikacji.
enable_usps_cass

bool

Włącza tryb zgodny z USPS CASS. Dotyczy to tylko pola google.maps.addressvalidation.v1.ValidationResult.usps_data w elementach google.maps.addressvalidation.v1.ValidationResult. Uwaga: w przypadku żądań z włączoną usługą USPS CASS dla adresów w Portoryko google.type.PostalAddress.region_code address musi być podane jako „PR”, a google.type.PostalAddress.administrative_area address jako „Portoryko” (bez względu na wielkość liter).

Zalecamy użycie komponentu address lub podanie co najmniej 2 wartości google.type.PostalAddress.address_lines, z których pierwsza zawiera numer i nazwę ulicy, a druga – miasto, województwo i kod pocztowy.
language_options

LanguageOptions

Opcjonalnie: Wersja testowa: ta funkcja jest w wersji testowej (przed GA). Usługi i funkcje przed GA mogą mieć ograniczoną obsługę, a zmiany w takich usługach i funkcjach mogą być niezgodne z ich innymi wersjami. Oferty przed GA są objęte szczegółowymi warunkami korzystania z usługi Google Maps Platform. Więcej informacji znajdziesz w opisach etapu uruchamiania.

Umożliwia interfejsowi Address Validation API uwzględnienie dodatkowych informacji w odpowiedzi.
session_token

string

Opcjonalnie: Ciąg tekstowy identyfikujący sesję Autouzupełniania na potrzeby rozliczeń. Musi być bezpiecznym ciągiem znaków w formacie base64, który może zawierać maksymalnie 36 znaków ASCII. W przeciwnym razie zwracany jest błąd INVALID_ARGUMENT.

Sesja rozpoczyna się, gdy użytkownik przesyła zapytanie do funkcji autouzupełniania, a kończy, gdy wybierze miejsce i wywoła funkcję Szczegóły miejsca lub Weryfikacja adresu. Każda sesja może zawierać wiele zapytań autouzupełniania, a następnie jedno żądanie dotyczące szczegółów miejsca lub weryfikacji adresu. Dane logowania używane w przypadku każdego żądania w ramach sesji muszą należeć do tego samego projektu w Google Cloud Console. Po zakończeniu sesji token nie jest już ważny. Aplikacja musi wygenerować nowy token dla każdej sesji. Jeśli pominiesz parametr sessionToken lub użyjesz ponownie tokenu sesji, sesja zostanie obciążona opłatą tak, jakby nie podano tokenu sesji (za każde żądanie nalicza się opłata).

Uwaga: weryfikacji adresu można używać tylko w sesjach z interfejsem Autocomplete API (New), a nie Autocomplete API. Więcej informacji znajdziesz na stronie https://developers.google.com/maps/documentation/places/web-service/session-pricing.

ValidateAddressResponse

Odpowiedź na prośbę o weryfikację adresu.

Pola
result

ValidationResult

Wynik weryfikacji adresu.
response_id

string

Identyfikator UUID, który identyfikuje tę odpowiedź. Jeśli adres wymaga ponownej weryfikacji, ten identyfikator UUID musi zostać dołączony do nowej prośby.

ValidationResult

Wynik weryfikacji adresu.

Pola
verdict

Verdict

Flagi ogólnej oceny
address

Address

Informacje o samym adresie, a nie o jego geokodze.
geocode

Geocode

Informacje o lokalizacji i miejscu, do których został zakodowany adres.
metadata

AddressMetadata

inne informacje istotne dla skuteczności przesyłania. Nie można mieć pewności, że parametr metadata będzie w pełni wypełniony w przypadku każdego adresu wysłanego do interfejsu Address Validation API.
usps_data

UspsData

dodatkowe flagi dotyczące możliwości dostarczenia przesyłki dostarczane przez USPS. Dostępne tylko w regionach US i PR.
english_latin_address

Address

Wersja testowa: ta funkcja jest w wersji testowej (przed GA). Usługi i funkcje przed GA mogą mieć ograniczoną obsługę, a zmiany w takich usługach i funkcjach mogą być niezgodne z ich innymi wersjami. Oferty przed GA są objęte szczegółowymi warunkami korzystania z usługi Google Maps Platform. Więcej informacji znajdziesz w opisach etapu uruchamiania.

Adres przetłumaczony na język angielski.

Przetłumaczone adresy nie mogą być ponownie używane jako dane wejściowe API. Usługa udostępnia je, aby użytkownik mógł potwierdzić lub zaprzeczyć weryfikacji pierwotnie podanego adresu w jego ojczystym języku.

Jeśli część adresu nie ma tłumaczenia na język angielski, usługa zwraca tę część w innym języku, który używa alfabetu łacińskiego. Sposób wybierania języka alternatywnego znajdziesz tutaj. Jeśli część adresu nie ma tłumaczenia ani transliteracji w języku korzystającym z alfabetu łacińskiego, usługa zwraca tę część w języku lokalnym powiązanym z adresem.

Aby włączyć to wyjście, użyj parametru google.maps.addressvalidation.v1.LanguageOptions.return_english_latin_address.

Uwaga: pole google.maps.addressvalidation.v1.Address.unconfirmed_component_types w układance english_latin_address i pole google.maps.addressvalidation.v1.AddressComponent.confirmation_level w układance english_latin_address.address_components nie są wypełnione.

Wynik

Ogólne omówienie wyniku weryfikacji adresu i geokodu.

Pola
input_granularity

Granularity

Szczegółowość adresu wejścia. Jest to wynik analizy adresu wejściowego i nie zawiera żadnych sygnałów weryfikacyjnych. Informacje o weryfikacji znajdziesz w sekcji validation_granularity poniżej.

Jeśli na przykład adres wejściowy zawiera konkretny numer mieszkania, wartość input_granularity będzie miała postać SUB_PREMISE. Jeśli nie uda nam się dopasować numeru mieszkania w bazach danych lub jeśli numer mieszkania jest nieprawidłowy, wartość validation_granularity będzie prawdopodobnie równa PREMISE lub mniejsza.
validation_granularity

Granularity

Poziom szczegółowości, na którym interfejs API może w pełni weryfikować adres. Na przykład validation_granularity PREMISE wskazuje, że można sprawdzić wszystkie elementy adresu na poziomie PREMISE lub bardziej ogólnym.

Wynik weryfikacji poszczególnych elementów adresu można znaleźć w google.maps.addressvalidation.v1.Address.address_components.
geocode_granularity

Granularity

Informacje o szczegółowości geocode. Może to być rozumiane jako semantyczne znaczenie tego, jak ogólna lub szczegółowa jest zgeokodowana lokalizacja.

Czasami może się on różnić od podanego powyżej validation_granularity. Na przykład nasza baza danych może zawierać numer mieszkania, ale nie precyzyjne dane o jego lokalizacji w ramach dużego kompleksu mieszkaniowego. W tym przypadku validation_granularity będzie równe SUB_PREMISE, a geocode_granularity równa się PREMISE.
address_complete

bool

Adres jest uważany za kompletny, jeśli nie ma nierozwiązanych tokenów ani nieoczekiwanych lub brakujących elementów adresu. Jeśli nie zostanie ustawiony, oznacza to, że jego wartość to false. Więcej informacji znajdziesz w polach missing_component_types, unresolved_tokens lub unexpected.
has_unconfirmed_components

bool

Co najmniej jednego elementu adresu nie można zaklasyfikować ani zweryfikować. Szczegółowe informacje znajdziesz w sekcji google.maps.addressvalidation.v1.Address.address_components.
has_inferred_components

bool

W przypadku co najmniej jednego elementu adresu została wywnioskowana (dodana) informacja, która nie była podana w danych wejściowych. Szczegółowe informacje znajdziesz w dokumentacji google.maps.addressvalidation.v1.Address.address_components.
has_replaced_components

bool

Zmieniono co najmniej 1 element adresu. Szczegółowe informacje znajdziesz w sekcji google.maps.addressvalidation.v1.Address.address_components.

Szczegółowość

Różne poziomy szczegółowości, jakie może mieć adres lub kod geograficzny. Gdy są używane do określenia dokładności adresu, wskazują, z jaką dokładnością adres wskazuje miejsce docelowe przesyłki. Na przykład adres „123 Main Street, Redwood City, CA, 94061” wskazuje na PREMISE, a „Redwood City, CA, 94061” na LOCALITY. Jeśli jednak nie uda nam się znaleźć geokodu dla „123 Main Street” w Redwood City, zwrócony geokod może mieć poziom szczegółowości LOCALITY, mimo że adres jest bardziej szczegółowy.

Wartości w polu enum
GRANULARITY_UNSPECIFIED Wartość domyślna. Ta wartość nie jest używana.
SUB_PREMISE Wynik poniżej poziomu budynku, np. apartament.
PREMISE Wynik na poziomie budynku.
PREMISE_PROXIMITY geokod, który w przybliżeniu określa lokalizację adresu na poziomie budynku.
BLOCK Adres lub geokod wskazują blok. Używany tylko w regionach, w których adresowanie odbywa się na poziomie bloku, np. w Japonii.
ROUTE Geokod lub adres jest dokładny do poziomu ulicy, drogi lub autostrady.
OTHER Wszystkie inne poziomy szczegółowości, które są grupowane razem, ponieważ nie można ich dostarczyć.