Package google.maps.addressvalidation.v1

Indeks

AddressValidation

Usługa weryfikacji adresów.

ProvideValidationFeedback

rpc ProvideValidationFeedback(ProvideValidationFeedbackRequest) returns (ProvideValidationFeedbackResponse)

Opinia na temat wyniku sekwencji prób weryfikacji. Powinno to być ostatnie wywołanie po serii wywołań weryfikacji dla tego samego adresu. Powinno być ono wywoływane po zakończeniu transakcji. Należy je wysłać tylko raz w przypadku sekwencji żądań ValidateAddress niezbędnych do pełnej weryfikacji adresu.

ValidateAddress

rpc ValidateAddress(ValidateAddressRequest) returns (ValidateAddressResponse)

Weryfikuje adres.

Adres

Szczegóły przetworzonych adresów. Proces ten obejmuje poprawianie błędnie napisanych części adresu, wymianę nieprawidłowych części oraz ustalanie brakujących części.

Pola
formatted_address

string

Przetworzony adres w formacie jednowierszowym zgodnie z regułami formatowania adresu obowiązującymi w regionie, w którym się znajduje.

postal_address

PostalAddress

Adres pocztowy do przetworzenia po przetworzeniu.

address_components[]

AddressComponent

Lista nieuporządkowana. Pojedyncze składniki sformatowanego i poprawionego adresu wraz z informacjami dotyczącymi weryfikacji. Znajdziesz tu informacje o stanie weryfikacji poszczególnych komponentów.

Komponenty adresu nie są uporządkowane w określony sposób. Nie przyjmij żadnych założeń dotyczących kolejności komponentów adresu na liście.

missing_component_types[]

string

Typy komponentów, które powinny znajdować się w prawidłowo sformatowanym adresie pocztowym, ale nie zostały znalezione w danych wejściowych ORAZ nie można ich określić. Komponenty tego typu nie występują w środowiskach formatted_address, postal_address i address_components. Przykładem może być ['street_number', 'route'] dla danych wejściowych, takich jak „Boulder, Kolorado, 80301, USA”. Listę możliwych typów znajdziesz tutaj.

unconfirmed_component_types[]

string

Typy komponentów, które występują w polu address_components, ale nie udało się potwierdzić ich poprawności. To pole zostało udostępnione dla wygody: jego zawartość jest równoważna iteracja z polecenia address_components w celu znalezienia typów wszystkich komponentów, dla których confirmation_level nie ma wartości CONFIRMED lub flaga inferred nie jest ustawiona na true. Listę możliwych typów znajdziesz tutaj.

unresolved_tokens[]

string

Wszystkie tokeny w danych wejściowych, których nie udało się znaleźć. Może to być wartość, która nie została rozpoznana jako prawidłowa część adresu. Na przykład w przypadku danych wejściowych takich jak „123235253253 Main St, San Francisco, CA, 94105”, nierozpoznane tokeny mogą wyglądać jak ["123235253253"], ponieważ nie wygląda to na prawidłowy numer ulicy.

AddressComponent

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

Pola
component_name

ComponentName

Nazwa tego komponentu.

component_type

string

Typ komponentu adresu. Listę możliwych typów znajdziesz w tabeli 2. Dodatkowe typy zwracane przez usługę Miejsca.

confirmation_level

ConfirmationLevel

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

inferred

bool

Wskazuje, że komponent nie był częścią danych wejściowych, ale wywnioskowaliśmy, że jest to lokalizacja adresu i uważamy, że należy go podać w przypadku pełnego adresu.

spell_corrected

bool

Wskazuje poprawkę błędu pisowni w nazwie komponentu. Interfejs API nie zawsze oznacza zmiany z jednej wersji pisowni na inny, na przykład przy zmianie wartości „centre” na „center”. Nie zawsze oznacza to również częste błędy pisowni, np. „Amphitheater Pkwy” na „Amphitheatre Pkwy”.

replaced

bool

Wskazuje, że nazwa komponentu została zastąpiona zupełnie inną – np. nieprawidłowy kod pocztowy został zastąpiony kodem poprawnym dla adresu. Nie jest to zmiana wyglądu. Komponent wejściowy został zmieniony na inny.

unexpected

bool

Wskazuje komponent adresu, którego nie powinno się znajdować w adresie pocztowym w danym regionie. Zostały przez nas zachowane tylko dlatego, że stanowiły część tych danych.

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 Mogliśmy potwierdzić, że ten komponent istnieje i czy ma sens w kontekście reszty adresu.
UNCONFIRMED_BUT_PLAUSIBLE Nie udało się potwierdzić tego komponentu, ale prawdopodobnie istnieje. Może to być na przykład numer domu mieszczący się w określonym prawidłowym zakresie numerów na ulicy, na której nie są znane konkretne numery domów.
UNCONFIRMED_AND_SUSPICIOUS Ten komponent nie został potwierdzony i prawdopodobnie jest nieprawidłowy. Przykładem może być dzielnica, która nie pasuje do podanego adresu.

AddressMetadata

Metadane adresu. Nie ma gwarancji, że w przypadku każdego adresu wysłanego do interfejsu Address Validation API pole metadata będzie wypełnione w pełni.

Pola
business

bool

Wskazuje, że jest to adres firmy. Jeśli zasada jest nieskonfigurowana, wartość jest nieznana.

po_box

bool

Wskazuje, że jest to adres skrytki pocztowej. Jeśli zasada jest nieskonfigurowana, wartość jest nieznana.

residential

bool

Wskazuje, że jest to adres miejsca zamieszkania. Jeśli zasada jest nieskonfigurowana, wartość jest nieznana.

ComponentName

Opakowanie nazwy komponentu.

Pola
text

string

Tekst nazwy. Na przykład „Piąta Aleja” dla nazwy ulicy lub „1253” w przypadku numeru ulicy.

language_code

string

Kod języka BCP-47. Nie pojawi się, jeśli nazwa komponentu nie jest powiązana z językiem, np. z numerem domu.

Geokod

Zawiera informacje o miejscu, na które dane zostały zmapowane.

Pola
location

LatLng

Geokodowana lokalizacja danych wejściowych.

Preferowanym sposobem używania identyfikatora miejsca jest stosowanie adresów, współrzędnych geograficznych oraz kodów plus. Używanie współrzędnych do wyznaczania tras lub wyznaczania tras dojazdu zawsze powoduje przyciągnięcie punktu do drogi znajdującej się najbliżej tych współrzędnych. Nie musi to być droga, która szybko lub bezpiecznie prowadzi do miejsca docelowego, i nie musi znajdować się w pobliżu punktu dostępu do nieruchomości. Jeśli lokalizacja jest geokodowana w odwrotnym zapisie, nie ma gwarancji, że zwrócony adres będzie zgodny z oryginałem.

plus_code

PlusCode

Plus Code odpowiadający atrybutowi location.

bounds

Viewport

Granice miejsca objętego geokodowaniem.

feature_size_meters

float

Wielkość miejsca objętego geokodem (w metrach). Jest to kolejna miara niedokładności geokodowanej lokalizacji, ale w kontekście fizycznym, a nie semantycznym.

place_id

string

Identyfikator PlaceID miejsca, do którego dane są geokodowane.

Więcej informacji o identyfikatorach miejsc znajdziesz tutaj.

place_types[]

string

Typy miejsc, dla których dane wejściowe zostały przekształcone w dane geograficzne. Na przykład: ['locality', 'political']. Pełną listę typów znajdziesz tutaj.

LanguageOptions

Wersja testowa: ta funkcja jest w wersji przedpremierowej (przed GA). Usługi i funkcje przed GA mogą mieć ograniczoną obsługę, a zmiany w takich usługach mogą być niezgodne z ich innymi wersjami. Oferty przed GA podlegają Szczegółowym warunkom korzystania z usługi Google Maps Platform. Więcej informacji znajdziesz w opisach etapu uruchamiania.

Włącza interfejs Address Validation API, aby mógł zawierać dodatkowe informacje w odpowiedzi.

Pola
return_english_latin_address

bool

Podgląd: zwróć google.maps.addressvalidation.v1.Address w języku angielskim. Aby dowiedzieć się więcej, wejdź na google.maps.addressvalidation.v1.ValidationResult.english_latin_address.

PlusCode

Plus Code (http://plus.codes) to odniesienie do lokalizacji w 2 formatach: kod globalny definiujący rozmiar 14 m x 14 m lub mniejszy prostokątny oraz kod złożony, zastępując prefiks lokalizacją referencyjną.

Pola
global_code

string

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

compound_code

string

Kod złożony miejsca, np. „33GV+HQ, Ramberg, Norwegia”, zawierający sufiks kodu globalnego i zastąpienie go sformatowaną nazwą elementu referencyjnego.

ProvideValidationFeedbackRequest

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

Pola
conclusion

ValidationConclusion

Wymagane. Wynik sekwencji prób weryfikacji.

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

response_id

string

Wymagane. Identyfikator odpowiedzi, której dotyczy ta opinia. Powinien to być identyfikator [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 próśb o weryfikację adresu, które są niezbędne 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, zostanie zwrócony błąd INVALID_ARGUMENT.
VALIDATED_VERSION_USED Wersja adresu zwrócona przez interfejs Address Validation API została użyta w transakcji.
USER_VERSION_USED Wersja adresu podana przez użytkownika, która została użyta do zrealizowania transakcji
UNVALIDATED_VERSION_USED W przypadku transakcji została użyta wersja adresu podana po ostatniej próbie weryfikacji, która nie została ponownie zweryfikowana.
UNUSED Transakcja została porzucona i adres nie został użyty.

ProvideValidationFeedbackResponse

Ten typ nie zawiera pól.

Odpowiedź na opinię dotyczącą weryfikacji.

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

UspsAddress

Dokument przesyłany przez USPS z adresu w Stanach Zjednoczonych.

Pola
first_address_line

string

Pierwszy wiersz adresu.

firm

string

Nazwa firmy.

second_address_line

string

Drugi wiersz adresu.

urbanization

string

Portorykańska nazwa urbanizacji.

city_state_zip_address_line

string

Miasto, województwo + kod pocztowy.

city

string

Nazwa miasta.

state

string

Dwuliterowy kod stanu.

zip_code

string

Kod pocztowy, np. 10009.

zip_code_extension

string

Czterocyfrowe rozszerzenie kodu pocztowego, np. 5023.

UspsData

Dane USPS dotyczące adresu. Nie ma gwarancji, że pole uspsData będzie wypełnione w całości w przypadku każdego adresu w Stanach Zjednoczonych lub kraju, który został wysłany do interfejsu Address Validation API. Jeśli jako główną część odpowiedzi używasz pola uspsData, zalecamy zintegrowanie w odpowiedzi pól zapasowego adresu URL.

Pola
standardized_address

UspsAddress

Ustandaryzowany 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 parametru delivery_point_barcode w przypadku poczty skanowanej mechanicznie. Po dodaniu wszystkich cyfr kodu kreskowego_punktu dostawy, kodu pocztowego (delivery_point_check_digit), kodu pocztowego i kodu ZIP+4 otrzymasz liczbę podzieloną przez 10.

dpv_confirmation

string

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

  • N: nie udało się potwierdzić informacji o numerze głównym ani o numerze pomocniczym.
  • D: adres został potwierdzony tylko w przypadku numeru głównego, a brakowało drugiego numeru.
  • S: adres został potwierdzony tylko w przypadku numeru głównego, a informacje o numerze dodatkowym były dostępne, ale nie zostały potwierdzone.
  • Y: adres został potwierdzony jako DPV jako numer główny i wszystkie numery dodatkowe.
  • Puste: jeśli odpowiedź nie zawiera wartości dpv_confirmation, oznacza to, że adres nie został przesłany w celu potwierdzenia DPV.
dpv_footnote

string

Przypisy z weryfikacji punktu dostawy. W tym samym ciągu znaków może być wiele przypisów.

  • AA: adres wejściowy pasujący 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 i nie jest wymagany
  • C1: numer dodatkowy nie pasuje, ale jest wymagany
  • N1: brak dodatkowego numeru w adresie wieżowca
  • M1: brak głównego numeru
  • M3: nieprawidłowy numer podstawowy
  • P1: brak numeru skrytki, numeru RR lub numeru skrytki w Centrum pomocy
  • P3: podany adres PO, RR lub numer skrytki pomocy jest nieprawidłowy
  • F1: adres wejściowy pasujący do adresu wojskowego
  • G1: adres wejściowy pasujący do ogólnego adresu dostawy
  • U1: adres wejściowy dopasowany do unikalnego kodu pocztowego
  • PB: adres wejściowy pasujący do rekordu PBSA
  • RR: potwierdzony adres firmy zewnętrznej z informacjami o PMB
  • R1: potwierdzony adres firmy zewnętrznej bez informacji o PMB
  • R7: rekord trasy R777 lub R779 operatora
  • IA: zidentyfikowano świadomy adres
  • TA: liczba podstawowa dopasowana przez usunięcie końcowej litery alfa
dpv_cmra

string

Wskazuje, czy adres należy do agencji zajmującej się dostarczaniem poczty e-mail (CMRA) – prywatnej firmy, która odbiera pocztę w imieniu klientów. Zwraca pojedynczy znak.

  • Y: adres jest zgodny z CMRA
  • N: adres nie jest zgodny z CMRA
dpv_vacant

string

Czy to miejsce jest puste? Zwraca pojedynczy znak.

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

string

Czy to jest adres bez danych statystycznych czy aktywny? Adresy bez statystyk to takie, które nie są stale zajęte lub nie są obsługiwane przez USPS. Zwraca pojedynczy znak.

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

int32

Wskazuje typ NoStat. Zwraca kod przyczyny w postaci liczby całkowitej.

  • 1: IDA (wewnętrzny adres zwrotny) – adresy, które nie otrzymują poczty bezpośrednio z USPS, ale są dostarczane na adres pocztowy, który jest dla nich obsługiwany.
  • 2: CDS – adresy, których nie można jeszcze dostarczyć. Przykładem może być nowy podział, w którym określono działki i numery główne, ale nie ma jeszcze budynku przeznaczonego na obłożenie.
  • 3: kolizja – adresy, które w rzeczywistości nie są potwierdzone przez DPV.
  • 4: kod CMZ (szkoły wyższe, wojskowe i inne) – plik ZIP + 4 rekordy USPS zostały dołączone do danych.
  • 5: zwykła przesyłka – oznacza, że adresy nie są dostarczane, a adresy nie są liczone jako możliwe dostawy.
  • 6: dodatkowy wymagany – adres wymaga informacji dodatkowych.
dpv_drop

string

Flaga wskazuje, że poczta jest dostarczana do jednej skrzynki odbiorczej w witrynie. Zwraca pojedynczy znak.

  • Y: e-mail jest dostarczany do jednej skrzynki, którą można odbierać w witrynie.
  • N: e-mail nie jest dostarczany do jednego, który można otworzyć w witrynie.
dpv_throwback

string

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

  • Y: poczta nie zostanie dostarczona na adres.
  • N: poczta jest dostarczana na adres.
dpv_non_delivery_days

string

Flaga oznacza, że poczta nie jest dostarczana każdego dnia tygodnia. Zwraca pojedynczy znak.

  • Y: poczta nie jest dostarczana każdego dnia tygodnia.
  • N: brak informacji o tym, że poczta nie jest dostarczana każdego dnia tygodnia.
dpv_non_delivery_days_values

int32

Liczba całkowita określająca dni niedostarczenia. Można sprawdzać je przy użyciu flag bitowych: 0 x 40 – niedziela to dzień niedostarczenia 0x20 – poniedziałek to dzień niedostarczenia 0x10 – wtorek to dzień niedostarczenia 0x08 – środa to dzień niedoręczenia 0x04 – czwartek to dzień niedoręczenia 0x02 – piątek to dzień niedoręczenia 0x02 – piątek to dzień niedoręczenia 0x01

dpv_no_secure_location

string

Flaga wskazuje, że drzwi są dostępne, ale paczka nie zostanie pozostawiona ze względów bezpieczeństwa. Zwraca pojedynczy znak.

  • Y: ze względów bezpieczeństwa przesyłka nie zostanie pozostawiona.
  • N: nie oznacza, że pakiet nie zostanie pozostawiony 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, pod którymi USPS nie może zapukać w celu dostarczenia poczty. 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 dla danego adresu prawidłowy jest więcej niż 1 kod zwrotny od dostawcy zewnętrznego. Zwraca pojedynczy znak.

  • Y: adres został potwierdzony jako DPV jako numer główny i wszystkie numery dodatkowe.
  • N: nie udało się potwierdzić informacji o numerze głównym ani o numerze pomocniczym.
  • S: adres został potwierdzony tylko w przypadku numeru głównego, a informacje o numerze dodatkowym były dostępne, ale nie zostały potwierdzone, lub pominięto pojedynczy końcowy znak alfa dotyczący numeru podstawowego w celu dopasowania DPV i wymagane były dodatkowe informacje.
  • D: adres został potwierdzony tylko w przypadku numeru głównego, a brakowało drugiego numeru.
  • R: adres potwierdzony, ale przypisany do trasy fantomowej R777 i R779 oraz dostawy przez USPS nie jest podany.
carrier_route

string

Kod trasy przewoźnika. Czteroznakowy kod składający się z 1-literowego prefiksu i 3-cyfrowego oznaczenia trasy.

Prefiksy:

  • C: trasa przewoźnika (lub trasa miejska).
  • R: droga wiejska
  • H: trasa zakontraktowana na autostradę
  • B: Sekcja skrytki pocztowej
  • G: ogólna jednostka dostawy
carrier_route_indicator

string

Wskaźnik sortowania stawki przewoźnika.

ews_no_match

bool

Adres dostawy jest możliwy do dopasowania, ale plik EWS wskazuje, że dopasowanie ścisłe będzie wkrótce dostępne.

post_office_city

string

Główny urząd pocztowy.

post_office_state

string

Główny stan poczty.

abbreviated_city

string

Skrócone miasto.

fips_county_code

string

Kod kraju FIPS.

county

string

Nazwa hrabstwa.

elot_number

string

numeru rozszerzonego linii podróży (eLOT).

elot_flag

string

Flaga eLOT rosnąco/malejąco (A/D).

po_box_only_postal_code

bool

Kod pocztowy tylko w przypadku skrytki pocztowej.

pmb_designator

string

Oznaczenie jednostki PMB (Private Mail Box).

pmb_number

string

Numer PMB (Private Mail Box);

address_record_type

string

Typ rekordu adresowego, który pasuje do wejściowego adresu.

  • F: FIRMA. Jest to dopasowanie do rekordu firmy, czyli najlepszego możliwego poziomu dopasowania dla adresu.
  • G: DOSTAWA OGÓLNA. To jest dopasowanie do ogólnego rekordu dostawy.
  • H: BUDŻET / MIEJSCE. To jest dopasowanie do danych o budynku lub mieszkaniu.
  • P: SKRZYNKA POCZTOWA. To odpowiednik skrytki pocztowej.
  • R: TRASA RUCHOWA lub UMOWA DUŻĄ DROGĄ: wskazuje dopasowanie do rekordu drogi wiejskiej lub umowy drogowej, które mogą mieć powiązane zakresy numerów skrzynek.
  • S: REKORD ULICY: dopasowanie do rekordu ulicy, który zawiera prawidłowy podstawowy zakres numerów.
default_address

bool

Wskazuje, że znaleziono adres domyślny, ale istnieją bardziej szczegółowe adresy.

error_message

string

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

Ten błąd może powodować, że pola danych USPS mogą nie być wypełnione.

cass_processed

bool

Wskazuje, że żądanie zostało przetworzone przez CASS.

ValidateAddressRequest

Żądanie weryfikacji adresu.

Pola
address

PostalAddress

Wymagane. Trwa weryfikacja adresu. Niesformatowane adresy należy przesyłać za pomocą formularza address_lines.

Łączna długość pól w tych danych 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 dzisiaj jest ignorowana. Wyniki dotyczące zweryfikowanego adresu zostaną zapełnione na podstawie preferowanego języka danego adresu określonego przez system.

Interfejs Address Validation API ignoruje wartości w polach 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 pojedynczego adresu potrzeba więcej żądań (np. zmiany wprowadzone przez użytkownika po początkowej weryfikacji wymagają ponownej weryfikacji), każde dodatkowe żądanie musi zawierać w tym polu wartość response_id już od pierwszej odpowiedzi w sekwencji weryfikacji.

enable_usps_cass

bool

Włącza tryb zgodności USPS CASS. Dotyczy to tylko pola google.maps.addressvalidation.v1.ValidationResult.usps_data elementu google.maps.addressvalidation.v1.ValidationResult. Uwaga: w przypadku żądań USPS CASS w przypadku adresów w Portoryko pole google.type.PostalAddress.region_code identyfikatora address należy podać jako „PR” lub „google.type.PostalAddress.administrative_area” elementu address należy podać jako „Puerto Rico” (wielkość liter nie ma znaczenia) lub „PR”.

Zalecamy użycie składowego elementu address lub podanie co najmniej 2 elementów google.type.PostalAddress.address_lines, gdzie pierwszy wiersz zawiera numer i nazwę ulicy, a drugi – miasto, województwo i kod pocztowy.

language_options

LanguageOptions

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

Włącza interfejs Address Validation API, aby mógł zawierać dodatkowe informacje w odpowiedzi.

session_token

string

Opcjonalnie. Ciąg znaków identyfikujący sesję autouzupełniania w celach rozliczeniowych. Musi to być adres URL i nazwa pliku bezpieczny ciąg znaków w formacie base64 o długości maksymalnie 36 znaków ASCII. W przeciwnym razie zwracany jest błąd INVALID_ARGUMENT.

Sesja rozpoczyna się, gdy użytkownik wykona zapytanie autouzupełniania, i kończy się, gdy użytkownik wybierze miejsce i wywoła informacje o miejscu lub weryfikację adresu. Każda sesja może zawierać kilka zapytań autouzupełniania, po których następuje jedno pytanie o informacje o miejscu lub weryfikację adresu. Dane logowania używane w każdym żądaniu w sesji muszą należeć do tego samego projektu w konsoli Google Cloud. Po zakończeniu sesji token straci ważność – aplikacja musi wygenerować nowy token dla każdej sesji. Jeśli parametr sessionToken zostanie pominięty lub użyjesz tokena sesji ponownie, sesja jest obciążana tak, jakby żaden token sesji nie został udostępniony (każde żądanie jest rozliczane oddzielnie).

Uwaga: weryfikacji adresów można używać tylko w sesjach z nowym interfejsem API autouzupełniania, a nie z interfejsem API autouzupełniania. Więcej informacji znajdziesz na stronie https://developers.google.com/maps/documentation/places/web-service/session-pricing.

ValidateAddressResponse

Odpowiedź na żądanie weryfikacji adresu.

Pola
result

ValidationResult

Wynik weryfikacji adresu.

response_id

string

Identyfikator UUID identyfikujący tę odpowiedź. Jeśli adres wymaga ponownej weryfikacji, identyfikator UUID musi zostać dołączony do nowego żądania.

ValidationResult

Wynik weryfikacji adresu.

Pola
verdict

Verdict

Flagi ogólnej oceny

address

Address

Informacje o samym adresie, a nie o kodzie geograficznym.

geocode

Geocode

Informacje o lokalizacji i miejscu, do którego przekodowano dane geograficzne.

metadata

AddressMetadata

Inne informacje istotne z punktu widzenia dostawy. Nie ma gwarancji, że w przypadku każdego adresu wysłanego do interfejsu Address Validation API pole metadata będzie wypełnione w pełni.

usps_data

UspsData

Dodatkowe flagi dostawy dostarczane przez USPS. Jest dostępna tylko w regionach US i PR.

english_latin_address

Address

Wersja testowa: ta funkcja jest w wersji przedpremierowej (przed GA). Usługi i funkcje przed GA mogą mieć ograniczoną obsługę, a zmiany w takich usługach mogą być niezgodne z ich innymi wersjami. Oferty przed GA podlegają Szczegółowym warunkom korzystania z usługi Google Maps Platform. Więcej informacji znajdziesz w opisach etapu uruchamiania.

Adres przetłumaczony na język angielski.

Przetłumaczonych adresów nie można używać ponownie jako danych wejściowych interfejsu API. Dzięki tej usłudze użytkownik może w swoim języku potwierdzić lub odrzucić poprawność pierwotnie podanego adresu.

Jeśli część adresu nie ma tłumaczenia na język angielski, usługa zwróci tę część w języku alternatywnym używającym alfabetu łacińskiego. Wyjaśnienie wyboru języka alternatywnego znajdziesz tutaj. Jeśli część adresu nie ma żadnych tłumaczeń ani transliteracji w języku używającym alfabetu łacińskiego, usługa zwróci tę część w języku lokalnym powiązanym z adresem.

Włącz te dane wyjściowe za pomocą flagi google.maps.addressvalidation.v1.LanguageOptions.return_english_latin_address.

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

Wynik

Ogólny przegląd wyniku weryfikacji adresu i kodu geograficznego.

Pola
input_granularity

Granularity

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

Jeśli na przykład podany adres zawiera konkretny numer mieszkania, pole input_granularity w tym miejscu ma wartość SUB_PREMISE. Jeśli nie możemy dopasować numeru mieszkania w bazie danych lub numer jest nieprawidłowy, validation_granularity prawdopodobnie będzie wynosić PREMISE lub mniej.

validation_granularity

Granularity

Poziom szczegółowości, na którym interfejs API może w pełni validate adres. Na przykład wartość validation_granularity o wartości PREMISE wskazuje, że wszystkie składniki adresu na poziomie PREMISE lub bardziej przybliżonym mogą zostać zweryfikowane.

Wyniki weryfikacji komponentu według adresu można znaleźć w polu google.maps.addressvalidation.v1.Address.address_components.

geocode_granularity

Granularity

Informacje o szczegółowości geocode. Można to rozumieć jako znaczenie semantyczne określające przybliżoną lub dokładną lokalizację geokodowaną.

Ta zasada może się czasami różnić od powyższej procedury validation_granularity. W naszej bazie danych można na przykład rejestrować istnienie numeru mieszkania, ale nie określać jego dokładnej lokalizacji w dużym kompleksie mieszkalnym. W takim przypadku validation_granularity będzie mieć wartość SUB_PREMISE, a geocode_granularity będzie mieć wartość PREMISE.

address_complete

bool

Adres jest uznawany za pełny, jeśli nie ma nierozstrzygniętych tokenów ani niespodziewanych lub brakujących komponentów adresu. Jeśli zasada jest nieskonfigurowana, wartość to false. Więcej informacji znajdziesz w polach missing_component_types, unresolved_tokens i unexpected.

has_unconfirmed_components

bool

Nie można sklasyfikować ani zweryfikować co najmniej jednego komponentu adresu. Więcej informacji znajdziesz na stronie google.maps.addressvalidation.v1.Address.address_components.

has_inferred_components

bool

Pobrano (dodano) co najmniej 1 komponent adresu, którego nie ma w danych wejściowych. Więcej informacji znajdziesz tutaj: google.maps.addressvalidation.v1.Address.address_components.

has_replaced_components

bool

Zastąpiono co najmniej 1 komponent adresu. Szczegóły znajdziesz tutaj: google.maps.addressvalidation.v1.Address.address_components.

Szczegółowość

Różne poziomy szczegółowości adresu lub geokodu. Wartości te używane do określania szczegółowości adresu wskazują, z jaką dokładnością adres identyfikuje miejsce docelowe poczty. Na przykład adres „123 Main Street, Redwood City, CA, 94061” identyfikuje PREMISE, a na przykład „Redwood City, CA, 94061” wskazuje identyfikator LOCALITY. Jeśli jednak nie możemy znaleźć kodu geograficznego „ulica Główna 123” w Redwood City, zwracany geokod może mieć dokładność LOCALITY, mimo że jest bardziej szczegółowy.

Wartości w polu enum
GRANULARITY_UNSPECIFIED Wartość domyślna. Ta wartość nie jest używana.
SUB_PREMISE Wynik znajdujący się poniżej poziomu budynku, np. mieszkanie.
PREMISE Wynik na poziomie budynku.
PREMISE_PROXIMITY Geokod, który określa przybliżoną lokalizację adresu na poziomie budynku.
BLOCK Adres lub kod geograficzny wskazują blok. Używany tylko w regionach z adresowaniem na poziomie bloku, np. w Japonii.
ROUTE Geokod lub adres są bardzo szczegółowe w odniesieniu do trasy, np. ulicy, drogi lub autostrady.
OTHER Wszystkie inne szczegóły, które są grupowane razem, ponieważ nie są możliwe do dostarczenia.