Package google.maps.addressvalidation.v1

string

Przetworzony adres w postaci adresu jednowierszowego zgodny z regułami formatowania adresu obowiązującymi w regionie, w którym znajduje się adres.

PostalAddress

Adres po przetworzeniu danych, który jest widoczny jako adres pocztowy.

AddressComponent

Lista nieuporządkowana. Poszczególne składniki adresu sformatowanego i poprawionego adresu wraz z informacjami weryfikacyjnymi. Znajdziesz tam informacje o stanie weryfikacji poszczególnych komponentów.

Komponenty adresu nie są uporządkowane w określony sposób. Nie zakładaj w żaden sposób kolejności komponentów adresu na liście.

string

Typy komponentów, które powinny znajdować się w poprawnie sformatowanym adresie pocztowym, ale nie znaleziono w danych wejściowych ORAZ nie można wywnioskować. Komponenty tego typu nie występują w elementach formatted_address, postal_address ani address_components. Przykładem może być ['street_number', 'route'] w przypadku danych wejściowych, takich jak „Boulder, Kolorado, 80301, USA”. Listę możliwych typów znajdziesz tutaj.

string

Typy komponentów obecnych w polu address_components, których nie udało się potwierdzić, że są prawidłowe. To pole zostało dodane dla wygody użytkowników. Jego zawartość jest odpowiednikiem powtórzenia metody 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.

string

Wszystkie wpisane dane wejściowe, których nie udało się rozpoznać. Mogą to być dane, które nie zostały rozpoznane jako prawidłowa część adresu (np. w danych takich jak „ul. Główna 123235253253, San Francisco, CA, 94105”, nierozstrzygnięte tokeny mogą wyglądać tak: ["123235253253"], ponieważ nie wyglądają one na prawidłowy numer budynku.

ComponentName

Nazwa tego komponentu.

string

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

ConfirmationLevel

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

bool

Wskazuje, że komponent nie był częścią danych, ale wywnioskowaliśmy go dla lokalizacji adresu i uważamy, że należy go podać, aby podać pełny adres.

bool

Wskazuje poprawkę błędu pisowni w nazwie komponentu. Interfejs API nie zawsze oznacza zmiany między wariantami pisowni, np. przy zmianie słowa „w środku” na „wyśrodkowany”. Nie zawsze oznacza też typowe błędy w pisowni, na przykład gdy zmieniasz nazwę „Pałac Kultury i Nauki” na „Pałac Kultury i Nauki”.

bool

wskazuje, że nazwa komponentu została zastąpiona całkowicie inną nazwą (np. nieprawidłowy kod pocztowy został zastąpiony prawidłowym kodem adresu). Nie jest to tylko kosmetyczna zmiana, ponieważ komponent danych wejściowych został zmieniony na inny.

bool

Wskazuje składnik adresu, który nie powinien występować w adresie pocztowym dla danego regionu. Zachowajmy je tylko dlatego, że były częścią danych wejściowych.

bool

Wskazuje, że jest to adres firmy. Jeśli nie jest skonfigurowana, wskazuje, że wartość jest nieznana.

bool

Wskazuje, że adres skrytki pocztowej. Jeśli nie jest skonfigurowana, wskazuje, że wartość jest nieznana.

bool

Wskazuje, że jest to adres miejsca zamieszkania. Jeśli nie jest skonfigurowana, wskazuje, że wartość jest nieznana.

string

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

string

Kod języka BCP-47. Ten atrybut nie będzie dostępny, jeśli nazwa komponentu nie jest powiązana z językiem, np. z numerem domu.

LatLng

Geokodowana lokalizacja danych wejściowych.

Używanie identyfikatorów miejsc jest preferowane zamiast używania adresów, współrzędnych szerokości i długości geograficznej lub kodów plus. Korzystanie ze współrzędnych podczas wyznaczanie trasy lub obliczanie trasy dojazdu zawsze powoduje przyciągnięcie punktu do drogi znajdującej się najbliżej tych współrzędnych. Nie może to być droga, która szybko lub bezpiecznie prowadzi do celu i nie może znajdować się w pobliżu punktu dostępu do posesji. Ponadto, gdy lokalizacja jest poddawana odwrotnym geokodowi, nie ma gwarancji, że zwrócony adres jest zgodny z pierwotnym adresem.

PlusCode

Kod plus odpowiadający kontu location.

Viewport

Granice miejsca geokodowanego.

float

Wielkość miejsca geokodowanego (w metrach). Jest to kolejna miara przybliżenia geokodowanej lokalizacji, ale jej rozmiaru fizycznego, a nie semantycznego.

string

Identyfikator miejsca miejsca, do którego dane geograficzne są przesyłane.

Więcej informacji na temat identyfikatorów miejsc znajdziesz tutaj.

string

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

bool

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

string

Globalny (pełny) kod miejsca, np. „9FWM33GV+HQ”, który reprezentuje obszar o wymiarach 1/8000 x 1/8000 stopnia (ok. 14 x 14 metrów).

string

Kod złożony miejsca, np. „33GV+HQ, Ramberg, Norwegia”, który zawiera sufiks kodu globalnego i zastępuje prefiks sformatowaną nazwą jednostki referencyjnej.

ValidationConclusion

To pole jest wymagane. Rezultat sekwencji prób weryfikacji.

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

string

To pole jest wymagane. Identyfikator odpowiedzi, której dotyczy ta opinia. Powinien to być parametr [response_id][google.maps.addressvalidation.v1.ValidateAddressRequest.response_id], który pochodzi z pierwszej odpowiedzi z serii prób weryfikacji adresu.

string

Pierwszy wiersz adresu.

string

Nazwa firmy.

string

Drugi wiersz adresu.

string

Portorykańska nazwa urbanizacji.

string

Miasto + województwo + kod pocztowy.

string

Nazwa miasta.

string

Dwuliterowy kod stanu.

string

Kod pocztowy, np. 10009.

string

4-cyfrowe rozszerzenie kodu pocztowego, np. 5023.

UspsAddress

Ujednolicony adres USPS.

string

2-cyfrowy kod punktu dostawy

string

Cyfra kontrolna punktu dostawy. Ten numer jest dodawany na końcu kodu delivery_point_barcode w przypadku e-maili zeskanowanych mechanicznie. Dodanie do siebie wszystkich cyfr parametru „delivery_point_barcode”, „delivery_point_check_digit” i „zip+4” powinno dać liczbę podzieloną przez 10.

string

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

• N: nie udało się potwierdzić DPV podstawowego i dodatkowego numeru telefonu.
• D: adres został potwierdzony tylko w DPV jako numer główny i brakowało dodatkowych informacji o numerze.
• S: adres został potwierdzony tylko w DPV dla numeru głównego, a dodatkowe informacje dotyczące numeru były dostępne, ale nie zostały potwierdzone.
• Y: potwierdzono DPV dla numerów głównych i dodatkowych.
• Puste: jeśli odpowiedź nie zawiera wartości dpv_confirmation, adres nie został przesłany do potwierdzenia DPV.

string

Przypisy z weryfikacji punktu dostawy. W jednym ciągu może być połączonych wiele przypisów.

• AA: adres wejściowy dopasowany do pliku ZIP+4
• A1: adres wejściowy nie został dopasowany do pliku ZIP+4
• BB: dopasowane do DPV (wszystkie komponenty)
• CC: numer dodatkowy nie pasuje i nie jest wymagany
• C1: numer dodatkowy nie pasuje, ale jest wymagany
• N1: w wieżowcu brakuje dodatkowego numeru telefonu
• M1: brak podstawowego numeru
• M3: podstawowy numer jest nieprawidłowy
• P1: brak numeru pola wpisywania adresu PO, RR lub HC
• P3: wpisany adres PO, RR lub HC Box jest nieprawidłowy.
• F1: wpisz adres zgodny z adresem wojskowym
• G1: wpisz adres zgodny z ogólnym adresem dostawy
• U1: wpisz adres zgodny z unikalnym kodem pocztowym
• PB: adres wejściowy został dopasowany do rekordu PBSA
• RR: adres potwierdzony przez firmę DPV z informacjami PMB
• R1: potwierdzony adres przez DPV bez informacji PMB
• R7: rekord trasy operatora R777 lub R779
• IA: zidentyfikowano niedokładny adres
• TA: numer podstawowy dopasowywany przez odrzucenie końcowej litery alfa

string

Wskazuje, czy adres to CMRA (Commercial Mail Delivery Agency) – prywatna firma odbierająca pocztę w imieniu klientów. Zwraca pojedynczy znak.

• Y: adres to CMRA.
• N: adres nie należy do CMRA

string

Czy to miejsce jest puste? Zwraca pojedynczy znak.

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

string

Czy jest to adres niedostępny w statystykach czy adres aktywny? Brak adresów statystycznych to adresy, na których nikt nie jest stale zajęty, lub adresy, których USPS nie obsługuje. Zwraca pojedynczy znak.

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

int32

Wskazuje typ NoStat. Zwraca kod przyczyny jako int.

• 1: IDA (Internal Drop Address) – adresy, które nie otrzymują poczty bezpośrednio z USPS, ale są dostarczane na adres pocztowy, który służy do ich obsługi.
• 2: CDS – adresy, których nie można jeszcze dostarczyć. Dotyczy to na przykład nowego podziału, w którym zostały określone numery i numery podstawowe, ale nie ma jeszcze struktury obłożenia.
• 3: kolizja – adresy, których nie potwierdził DPV.
• 4: CMZ (College, Militaria i inne typy) – kody ZIP + 4 rekordy USPS uwzględnione w danych.
• 5: zwykłe – wskazuje, że adresy nie są dostarczane, a adresy nie są zaliczane do możliwych przesyłek.
• 6: dodatkowy wymagany – adres wymaga podania dodatkowych informacji

string

Flaga oznacza, że e-mail jest dostarczany do określonego odbiorcy w witrynie. Zwraca pojedynczy znak.

• Y: poczta jest dostarczana do jednego odbioru w witrynie.
• N: poczta nie jest dostarczana do jednego odbiorcy w witrynie.

string

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

• Y: poczta nie jest dostarczana na adres pocztowy.
• N: poczta jest dostarczana na adres pocztowy.

string

Oznaczenie flagą oznacza, że poczta nie jest dostarczana codziennie. Zwraca pojedynczy znak.

• Y: poczta nie jest dostarczana codziennie.
• N: brak oznaczenia, że poczta jest dostarczana codziennie.

int32

Liczba całkowita określająca dni, w których dostawa nie jest realizowana. Można go przesłuchać za pomocą flag: 0x40 – niedziela jest dniem niedostawy 0x20 – poniedziałek jest dniem niedostawy 0x10 – wtorek oznacza dzień niedostawy 0x08 – środa oznacza dzień niedostawy 0x04 – czwartek jest dniem niedoręczenia 0x02 – piątek to dzień niedostawy 0x02

string

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

• Y: przesyłka nie zostanie dostarczona ze względów bezpieczeństwa.
• N: nie ma informacji, że pakiet nie zostanie pozostawiony ze względów bezpieczeństwa.

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.

string

Flaga wskazuje adresy, pod którymi USPS nie może zapukać do dostarczenia poczty. Zwraca pojedynczy znak.

• Y: drzwi są niedostępne.
• N: brak oznaczenia, że drzwi są niedostępne.

string

Wskazuje, że dla danego adresu prawidłowy jest więcej niż 1 kod zwrotu DPV. Zwraca pojedynczy znak.

• Y: potwierdzono DPV dla numerów głównych i dodatkowych.
• N: nie udało się potwierdzić DPV podstawowego i dodatkowego numeru telefonu.
• S: adres został potwierdzony tylko w DPV dla numeru podstawowego, a dodatkowe informacje o numerze były widoczne jako niepotwierdzone lub pominięto jedną końcową literę alfa na numerze podstawowym, aby uzyskać dopasowanie DPV i wymagane informacje dodatkowe.
• D: adres został potwierdzony tylko w DPV jako numer główny i brakowało dodatkowych informacji o numerze.
• R: adres potwierdzony, ale przypisany do trasy Phantom R777 i R779, przy czym nie podano adresu dostawy USPS.

string

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

Prefiksy:

• C: trasa przewoźnika (lub trasa miejska).
• R: trasa wiejska
• H: trasa umowy drogowej
• B: sekcja skrytki pocztowej
• G: ogólna jednostka dostawy

string

Wskaźnik sortowania szybkości trasy przewoźnika.

bool

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

string

Główny urząd pocztowy.

string

Główny stan urzędu pocztowego.

string

Skrócona nazwa miasta.

string

Kod kraju FIPS.

string

Nazwa hrabstwa.

string

Numer eLOT (ELOT).

string

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

string

Kod zwrotny LACSLink.

string

Wskaźnik LACSLink.

bool

Kod pocztowy obejmujący tylko skrytkę pocztową.

string

Przypisy od pasującego rekordu ulicy lub wieżowca do informacji o budynku. Jeśli nazwa firmy zostanie znaleziona, zostanie zwrócony numer dodatkowy.

• A: dopasowanie rekordu SuiteLink, poprawiono adres firmy.
• 00: nie znaleziono dopasowań, adres firmy nie został poprawiony.

string

Oznaczenie jednostki PMB (Private Mail Box).

string

numer PMB (Private Mail Box);

string

Typ rekordu adresu pasującego do wpisanego adresu.

• F: FIRMA. Jest to dopasowanie z rejestrem firmowym, czyli najwyższym poziomem dopasowania dla danego adresu.
• G: DOSTAWA OGÓLNA. Jest zgodny z rekordem dostawy ogólnej.
• H: BUDOWANIE / MIEJSCE. Ta wartość pasuje do wpisu dotyczącego budynku lub mieszkania.
• P: Skrytka pocztowa. Ta skrytka pasuje do skrytki pocztowej.
• R: TRASY WIELSKOWA lub UMOWA WYSZUKIWANIA: dopasowanie do rekordu drogi na terenie wiejskim lub umowy drogowej. Oba te warunki mogą mieć powiązane zakresy numerów pól.
• S: REKORD STREET: dopasowanie do wpisu o ulicy zawierającego prawidłowy podstawowy zakres liczbowy.

bool

Wskaźnik informujący, że został znaleziony adres domyślny, ale istnieją bardziej szczegółowe adresy.

string

Komunikat o błędzie pobierania danych przez USPS. Ta wartość jest wypełniana, gdy przetwarzanie USPS zostaje zawieszone z powodu wykrywania sztucznie utworzonych adresów.

Gdy występuje ten błąd, pola danych USPS mogą nie być wypełnione.

bool

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

PostalAddress

To pole jest wymagane. Sprawdzany adres. Niesformatowane adresy należy przesyłać za pomocą parametru address_lines.

Całkowita długość pól w tych danych nie może przekraczać 280 znaków.

Listę obsługiwanych regionów znajdziesz tutaj.

Wartość language_code w adresie wejściowym jest zarezerwowana do wykorzystania w przyszłości i dziś jest ignorowana. Wyniki dotyczące zweryfikowanego adresu zostaną wypełnione na podstawie języka ustawionego przez system dla danego adresu.

Interfejs Address Verification API ignoruje wartości w recipients i organization. Wszelkie wartości w tych polach zostaną odrzucone i nie zostaną zwrócone. Nie ustawiaj ich.

string

To pole musi być puste w przypadku pierwszego żądania weryfikacji adresu. Jeśli do pełnej weryfikacji pojedynczego adresu potrzeba więcej żądań (np. zmiany wprowadzane przez użytkownika po pierwszej weryfikacji muszą być ponownie zweryfikowane), każde kolejne żądanie musi wypełnić to pole wartością response_id z pierwszej odpowiedzi w sekwencji weryfikacji.

bool

Włącza tryb zgodności USPS CASS. Ma to wpływ tylko na pole google.maps.addressvalidation.v1.ValidationResult.usps_data w google.maps.addressvalidation.v1.ValidationResult. Uwaga: w przypadku żądań z obsługą USPS CASS dla adresów w Portoryko google.type.PostalAddress.region_code z address należy podać jako „PR” lub google.type.PostalAddress.administrative_area dla address należy podać jako „Portoryko” (wielkość liter nie jest rozróżniana) lub „PR”.

Zalecamy użycie komponentu address lub określenie co najmniej 2 elementów google.type.PostalAddress.address_lines, gdzie pierwszy wiersz zawiera numer domu i nazwę, a drugi – miasto, stan i kod pocztowy.

LanguageOptions

Opcjonalnie. Podgląd: 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 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.

Włącza interfejs Address Billingation API, aby uwzględnić w odpowiedzi dodatkowe informacje.

string

Opcjonalnie. Ciąg znaków, który identyfikuje sesję autouzupełniania na potrzeby rozliczeń. Musi to być bezpieczny adres URL i bezpieczny dla nazwy pliku ciąg base64 o długości nie większej niż 36 znaków ASCII. W przeciwnym razie zwracany jest błąd INVALID_ARGUMENT.

Sesja zaczyna się, gdy użytkownik wpisze zapytanie autouzupełniania, a kończy się, gdy wybierze miejsce i prześle żądanie informacji o miejscu lub weryfikacji adresu. Każda sesja może zawierać kilka zapytań autouzupełniania, po których następuje 1 prośba o informacje o miejscu lub o weryfikację adresu. Dane logowania używane w przypadku każdego żądania w ramach sesji muszą należeć do tego samego projektu w konsoli Google Cloud. Po zakończeniu sesji token traci ważność. Aplikacja musi generować nowy token dla każdej sesji. Jeśli parametr sessionToken zostanie pominięty lub ponownie użyjesz tokena sesji, opłata za sesję zostanie naliczona tak, jakby nie podano żadnego tokena sesji (każde żądanie jest rozliczane oddzielnie).

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

ValidationResult

Wynik weryfikacji adresu.

string

Identyfikator UUID, który identyfikuje tę odpowiedź. Jeśli adres wymaga ponownej weryfikacji, ten identyfikator UUID musi dołączyć do nowego żądania.

Verdict

Flagi oceny ogólnej

Address

Informacje o adresie, a nie o geokodzie.

Geocode

Informacje o lokalizacji i miejscu, do którego został przekodowany adres.

AddressMetadata

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

UspsData

Dodatkowe oznaczenia dotyczące dostawy są dostarczane przez USPS. Podano tylko w regionach US i PR.

Address

Podgląd: 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 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łumaczonych adresów nie można wykorzystywać ponownie jako danych wejściowych przez interfejs API. Usługa zapewnia taką możliwość, dzięki czemu użytkownik może użyć swojego języka ojczystego do potwierdzenia lub odrzucenia pierwotnie podanego adresu.

Jeśli część adresu nie ma tłumaczenia na język angielski, usługa zwraca tę część w języku alternatywnym z alfabetem łacińskim. Informacje o sposobie wyboru języka alternatywnego znajdziesz tutaj. Jeśli część adresu nie ma żadnych tłumaczeń ani transliteracji w języku korzystającym z alfabetu łacińskiego, usługa zwraca tę część w lokalnym języku powiązanym z adresem.

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

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

Granularity

szczegółowość adresu wejściowego, Jest to wynik analizy adresu wejściowego i nie przekazuje żadnych sygnałów weryfikacyjnych. Sygnały weryfikacyjne znajdziesz w sekcji validation_granularity poniżej.

Jeśli na przykład podany adres zawiera konkretny numer mieszkania, w polu input_granularity wpisz tutaj wartość SUB_PREMISE. Jeśli nie możemy dopasować numeru mieszkania w bazach danych lub numer jest nieprawidłowy, validation_granularity prawdopodobnie będzie miał wartość PREMISE lub mniej.

Granularity

Poziom szczegółowości, na którym interfejs API może w pełni validate adres. Na przykład wartość validation_granularity wynosząca PREMISE oznacza, że wszystkie komponenty adresu mogą być sprawdzane na poziomie PREMISE lub wyższym.

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

Granularity

Informacje o szczegółowości geocode. Jest to semantyczne oznaczanie dokładności i dokładności geokodowanej lokalizacji.

Czasem może się różnić od wartości validation_granularity powyżej. Na przykład nasza baza danych może rejestrować istnienie numeru mieszkania, ale nie podawać dokładnej lokalizacji tego lokalu w dużym kompleksie mieszkalnym. W takim przypadku validation_granularity będzie mieć wartość SUB_PREMISE, a geocode_granularity będzie mieć wartość PREMISE.

bool

Adres jest uważany za kompletny, jeśli nie ma nierozwiązanych tokenów ani nieoczekiwanych lub brakujących komponentów adresu. Jeśli wartość nie jest skonfigurowana, wskazuje, że wartość to false. Więcej szczegółów znajdziesz w polach missing_component_types, unresolved_tokens i unexpected.

bool

Co najmniej 1 komponentu adresu nie można skategoryzować ani zweryfikować. Więcej informacji znajdziesz na stronie google.maps.addressvalidation.v1.Address.address_components.

bool

Wywnioskowano (dodano) co najmniej 1 komponent adresu, którego nie było w danych wejściowych. Szczegółowe informacje znajdziesz na stronie google.maps.addressvalidation.v1.Address.address_components.

bool

Zastąpiono co najmniej jeden komponent adresu. Szczegółowe informacje znajdziesz na stronie google.maps.addressvalidation.v1.Address.address_components.