Method: validateAddress

Weryfikuje adres.

Żądanie HTTP

POST https://addressvalidation.googleapis.com/v1:validateAddress

Adres URL używa składni transkodowania gRPC.

Treść żądania

Treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "address": {
    object (PostalAddress)
  },
  "previousResponseId": string,
  "enableUspsCass": boolean,
  "languageOptions": {
    object (LanguageOptions)
  },
  "sessionToken": string
}
Pola
address

object (PostalAddress)

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

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

Obsługiwane regiony znajdziesz tutaj.

Wartość languageCode w adresie wejściowym jest zarezerwowana na przyszłość i jest ignorowana. Wyniki dotyczące zweryfikowanego adresu zostaną zapełnione na podstawie preferowanego języka danego adresu określonego przez system.

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

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ą responseId z pierwszej odpowiedzi w sekwencji weryfikacji.
enableUspsCass

boolean

Włącza tryb zgodności 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.
languageOptions

object (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.
sessionToken

string

Opcjonalnie: Ciąg tekstowy identyfikujący sesję automatycznego uzupeł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 DOCUMENT_AR.

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ć wiele zapytań autouzupełniania, po których następuje jedno żądanie Szczegółów miejsca lub weryfikacji adresu. Identyfikatory zastosowane do każdego żądania w ramach sesji muszą należeć do tego samego projektu w Google Cloud Console. Po zakończeniu sesji token traci 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 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.

Treść odpowiedzi

Odpowiedź na żądanie weryfikacji adresu.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "result": {
    object (ValidationResult)
  },
  "responseId": string
}
Pola
result

object (ValidationResult)

Wynik weryfikacji adresu.
responseId

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.

PostalAddress

Reprezentuje adres pocztowy, np. adres pocztowy lub adres do płatności. Na podstawie adresu pocztowego usługa pocztowa może dostarczyć produkty do budynku, skrytki pocztowej lub podobnego miejsca. Nie jest ona przeznaczona do modelowania lokalizacji geograficznych (drogi, miast, gór).

W większości przypadków adres jest tworzony na podstawie danych wejściowych użytkownika lub importowanych istniejących danych, w zależności od typu procesu.

Porady dotyczące wprowadzania i edytowania adresu: – Użyj widżetu adresu gotowego do użycia w różnych krajach, np. https://github.com/google/libaddressinput. – Użytkownicy nie powinni widzieć elementów interfejsu służących do wprowadzania ani edytowania pól poza krajami, w których są one używane.

Więcej informacji o korzystaniu z tego schematu znajdziesz na stronie https://support.google.com/business/answer/6397478.

Zapis JSON 
{
  "revision": integer,
  "regionCode": string,
  "languageCode": string,
  "postalCode": string,
  "sortingCode": string,
  "administrativeArea": string,
  "locality": string,
  "sublocality": string,
  "addressLines": [
    string
  ],
  "recipients": [
    string
  ],
  "organization": string
}
Pola
revision

integer

Wersja schematu PostalAddress. Każda wartość inna niż 0 spowoduje, że interfejs API zwróci błąd INVALID_ARGUMENT.
regionCode

string

Opcjonalnie: Kod regionu CLDR kraju/regionu adresu. Szczegółowe informacje można znaleźć na stronach https://cldr.unicode.org/ i https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html. Przykład: „CH” w przypadku Szwajcarii. Jeśli kod regionu nie zostanie podany, zostanie wywnioskowany na podstawie adresu. Aby uzyskać najlepszą wydajność, zalecamy podanie kodu regionu, jeśli go znasz. Niespójność lub powtarzanie się regionów może prowadzić do niskiej skuteczności. Jeśli np. addressLines już obejmuje dany region, nie podawaj w tym polu kodu tego regionu. Informacje o obsługiwanych regionach znajdziesz w sekcji Najczęstsze pytania.
languageCode

string

Kod języka w adresie wejściowym jest zarezerwowany do użycia w przyszłości i jest obecnie ignorowany. Interfejs API zwraca adres w odpowiednim języku.
postalCode

string

Opcjonalnie: Kod pocztowy w adresie. Nie wszystkie kraje używają kodów pocztowych lub ich wymagają, ale tam, gdzie są używane, mogą powodować dodatkową weryfikację innych części adresu (np. stan lub kod pocztowy w Stanach Zjednoczonych).
sortingCode

string

Opcjonalnie: Dodatkowy kod sortowania dla danego kraju. Nie jest on używany w większości regionów. W przypadku jego użycia wartość jest ciągiem znaków, np. „CEDEX”, opcjonalnie z numerem (np. „CEDEX 7”), lub tylko numerem, który reprezentuje „kod sektora” (Jamajka), „wskaźnik obszaru dostawy” (Malawi) lub „wskaźnik urzędu pocztowego” (np. Wybrze Kości Słoniowej).
administrativeArea

string

Opcjonalnie: Najwyższy podział administracyjny stosowany w przypadku adresów pocztowych kraju lub regionu. Może to być na przykład stan, prowincja, obwód lub prefektura. W Hiszpanii jest to prowincja, a nie wspólnota autonomiczna (np. „Barcelona”, a nie „Katalonia”). W wielu krajach w adresach pocztowych nie podaje się obszaru administracyjnego. Np. w Szwajcarii pole powinno pozostać puste.
locality

string

Opcjonalnie: Zwykle odnosi się do miasta w adresie. Przykłady: miasto w USA, miasto w Włoszech, miejscowość w Wielkiej Brytanii. W regionach świata, w których miejscowości nie są dobrze zdefiniowane lub nie pasują do tej struktury, pozostaw pole „Locality” puste i użyj atrybutów „addressLines”.
sublocality

string

Opcjonalnie: Dzielnica adresu. Mogą to być na przykład dzielnice, okręgi czy gminy.
addressLines[]

string

Wymagane. Nieuporządkowane wiersze adresu opisujące niższe poziomy adresu.

Ponieważ wartości w elementach addressLines nie zawierają informacji o typie i czasami mogą zawierać kilka wartości w pojedynczym polu (np. „Austin, TX”), ważne jest, aby kolejność wierszy była jasna. Kolejność wierszy adresu powinna być zgodna z „kolejnością na kopercie” w kraju lub regionie, w którym znajduje się adres.

Minimalna dozwolona struktura adresu składa się ze wszystkich informacji umieszczonych w elementach addressLines. Jeśli regionCode nie zostanie podany, region jest ustalany na podstawie wierszy adresu.

Utworzenie adresu zawierającego tylko ciąg addressLines, a następnie geokodowanie jest zalecanym sposobem obsługi adresów całkowicie nieuporządkowanych (zamiast zgadywania, które części adresu powinny należeć do miejscowości lub obszaru administracyjnego).
recipients[]

string

Nie ustawiaj tego pola. Interfejs API do weryfikacji adresu obecnie go nie używa. Chociaż obecnie interfejs API nie odrzuca żądań z tym ustawieniem pola, informacje zostaną odrzucone i nie zostaną zwrócone w odpowiedzi.
organization

string

Nie ustawiaj tego pola. Interfejs API do weryfikacji adresu obecnie go nie używa. Chociaż w tej chwili interfejs API nie odrzuca żądań z tym polem ustawionym, informacje zostaną odrzucone i nie zostaną zwrócone w odpowiedzi.

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.

Zapis JSON 
{
  "returnEnglishLatinAddress": boolean
}
Pola
returnEnglishLatinAddress

boolean

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

ValidationResult

Wynik weryfikacji adresu.

Zapis JSON 
{
  "verdict": {
    object (Verdict)
  },
  "address": {
    object (Address)
  },
  "geocode": {
    object (Geocode)
  },
  "metadata": {
    object (AddressMetadata)
  },
  "uspsData": {
    object (UspsData)
  },
  "englishLatinAddress": {
    object (Address)
  }
}
Pola
verdict

object (Verdict)

Flagi ogólnej oceny
address

object (Address)

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

object (Geocode)

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

object (AddressMetadata)

inne informacje istotne dla skuteczności przesyłania. 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.
uspsData

object (UspsData)

Dodatkowe flagi dostawy dostarczane przez USPS. Dostępne tylko w regionach US i PR.
englishLatinAddress

object (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 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. 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: pola google.maps.addressvalidation.v1.Address.unconfirmed_component_types w englishLatinAddress i google.maps.addressvalidation.v1.AddressComponent.confirmation_level w englishLatinAddress.address_components nie są wypełnione.

Wynik

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

Zapis JSON 
{
  "inputGranularity": enum (Granularity),
  "validationGranularity": enum (Granularity),
  "geocodeGranularity": enum (Granularity),
  "addressComplete": boolean,
  "hasUnconfirmedComponents": boolean,
  "hasInferredComponents": boolean,
  "hasReplacedComponents": boolean
}
Pola
inputGranularity

enum (Granularity)

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

Jeśli na przykład adres wejściowy zawiera konkretny numer mieszkania, wartość inputGranularity 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ść validationGranularity będzie prawdopodobnie równa PREMISE lub mniejsza.
validationGranularity

enum (Granularity)

Poziom szczegółowości, na którym interfejs API może w pełni weryfikować adres. Na przykład validationGranularity 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.
geocodeGranularity

enum (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 validationGranularity. Na przykład nasza baza danych może zawierać numer mieszkania, ale nie precyzyjne informacje o jego lokalizacji w ramach dużego kompleksu mieszkaniowego. W takim przypadku validationGranularity będzie równe SUB_PREMISE, a geocodeGranularity będzie równe PREMISE.
addressComplete

boolean

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 wartość to false. Więcej informacji znajdziesz w polach missingComponentTypes, unresolvedTokens lub unexpected.
hasUnconfirmedComponents

boolean

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

boolean

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.
hasReplacedComponents

boolean

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. 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” wskazuje na PREMISE, a „Redwood City, CA, 94061” na LOCALITY. Jeśli jednak nie uda nam się znaleźć geokodu dla adresu „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ć.

Adres

Szczegóły adresu po przetworzeniu. Przetwarzanie wsteczne obejmuje poprawianie błędnie zapisanych części adresu, zastępowanie niewłaściwych części i uzyskiwanie brakujących części.

Zapis JSON 
{
  "formattedAddress": string,
  "postalAddress": {
    object (PostalAddress)
  },
  "addressComponents": [
    {
      object (AddressComponent)
    }
  ],
  "missingComponentTypes": [
    string
  ],
  "unconfirmedComponentTypes": [
    string
  ],
  "unresolvedTokens": [
    string
  ]
}
Pola
formattedAddress

string

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

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

object (PostalAddress)

Adres po przetworzeniu w postaci adresu pocztowego.
addressComponents[]

object (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.
missingComponentTypes[]

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ć. Komponenty tego typu nie występują w sekcjach formattedAddress, postalAddress ani addressComponents. 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.
unconfirmedComponentTypes[]

string

Typy komponentów, które występują w polu addressComponents, ale nie udało się potwierdzić ich poprawności. To pole jest dostępne dla wygody użytkowników. Jego zawartość jest równoważna z przeszukiwaniem addressComponents w celu znalezienia typów wszystkich komponentów, w których confirmationLevel nie jest CONFIRMED lub flaga inferred nie jest ustawiona na true. Listę możliwych typów znajdziesz tutaj.
unresolvedTokens[]

string

Wszystkie tokeny w danych wejściowych, 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 dla danych wejściowych takich jak „Parcel 0000123123 & 0000456456 Str # Guthrie Center IA 50115 US”, nierozstrzygnięte tokeny mogą wyglądać tak: ["Parcel", "0000123123", "&", "0000456456"].

AddressComponent

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

Zapis JSON 
{
  "componentName": {
    object (ComponentName)
  },
  "componentType": string,
  "confirmationLevel": enum (ConfirmationLevel),
  "inferred": boolean,
  "spellCorrected": boolean,
  "replaced": boolean,
  "unexpected": boolean
}
Pola
componentName

object (ComponentName)

Nazwa tego komponentu.
componentType

string

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

enum (ConfirmationLevel)

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

boolean

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.
spellCorrected

boolean

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

boolean

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

boolean

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.

NazwaKomponentu

Otoczka dla nazwy komponentu.

Zapis JSON 
{
  "text": string,
  "languageCode": string
}
Pola
text

string

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

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.

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ć obecności 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.

Geokodowanie

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

Zapis JSON 
{
  "location": {
    object (LatLng)
  },
  "plusCode": {
    object (PlusCode)
  },
  "bounds": {
    object (Viewport)
  },
  "featureSizeMeters": number,
  "placeId": string,
  "placeTypes": [
    string
  ]
}
Pola
location

object (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 może nie znajdować się w pobliżu punktu dostępu do obiektu. Ponadto w przypadku odwrotnego kodowania geograficznego nie ma gwarancji, że zwrócony adres będzie zgodny z oryginałem.
plusCode

object (PlusCode)

Plus Code odpowiadający location.
bounds

object (Viewport)

Granice miejsca z geokodem.
featureSizeMeters

number

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

string

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

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

string

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

LatLng

Obiekt reprezentujący parę szerokości i długości geograficznej. Jest to para liczb podwójnie po przecinku, która reprezentuje stopnie szerokości i długości geograficznej. O ile nie wskazano inaczej, ten obiekt musi być zgodny ze standardem WGS84. Wartości muszą mieścić się w normalizowanych zakresach.

Zapis JSON 
{
  "latitude": number,
  "longitude": number
}
Pola
latitude

number

Szerokość geograficzna w stopniach. Musi mieścić się w zakresie [-90,0, +90,0].
longitude

number

Długość geograficzna w stopniach. Musi mieścić się w zakresie [-180,0, +180,0].

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.

Zapis JSON 
{
  "globalCode": string,
  "compoundCode": string
}
Pola
globalCode

string

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

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.

Widoczny obszar

Strefa widoczna współrzędnych szerokości i długości geograficznej, reprezentowana przez 2 punkty low i high, leżące na przekątnej w przeciwnych kierunkach. Widok jest uważany za zamknięty obszar, czyli obejmuje swoją granicę. Granice szerokości geograficznej muszą mieścić się w zakresie od -90 do 90 stopni, a granice długości geograficznej – od -180 do 180 stopni. Przykładowe etui:

  • Jeśli low = high, widoczny obszar składa się z tego pojedynczego punktu.

  • Jeśli low.longitude > high.longitude, zakres długości geograficznej jest odwrócony (widoczny obszar przecina linię długości geograficznej 180°).

  • Jeśli low.longitude = -180 stopni, a high.longitude = 180 stopni, widoczny obszar obejmuje wszystkie długości geograficzne.

  • Jeśli low.longitude = 180 stopni, a high.longitude = -180 stopni, zakres długości geograficznej jest pusty.

  • Jeśli low.latitude > high.latitude, zakres szerokości geograficznej jest pusty.

Wartości low i high muszą być wypełnione, a pole reprezentowane przez te wartości nie może być puste (zgodnie z definicjami podanymi powyżej). Pusty widok spowoduje błąd.

Na przykład ten widoczny obszar w całości obejmuje Nowy Jork:

{ "low": { "latitude": 40.477398, "longitude": -74.259087 }, "high": { "latitude": 40.91618, "longitude": -73.70018 } }

Zapis JSON 
{
  "low": {
    object (LatLng)
  },
  "high": {
    object (LatLng)
  }
}
Pola
low

object (LatLng)

Wymagane. Najniższy punkt widocznego obszaru.
high

object (LatLng)

Wymagane. Najwyższy punkt w obszarze widoku.

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.

Zapis JSON 
{
  "business": boolean,
  "poBox": boolean,
  "residential": boolean
}
Pola
business

boolean

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

boolean

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

boolean

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

UspsData

Dane USPS dla adresu. Nie ma gwarancji, że pole uspsData będzie wypełnione w pełni w przypadku każdego adresu w Stanach Zjednoczonych lub kraju, który został wysłany do interfejsu Address Validation API. Jeśli w odpowiedzi używasz danych uspsData jako głównej części odpowiedzi, zalecamy zintegrowanie pól adresu zapasowego.

Zapis JSON 
{
  "standardizedAddress": {
    object (UspsAddress)
  },
  "deliveryPointCode": string,
  "deliveryPointCheckDigit": string,
  "dpvConfirmation": string,
  "dpvFootnote": string,
  "dpvCmra": string,
  "dpvVacant": string,
  "dpvNoStat": string,
  "dpvNoStatReasonCode": integer,
  "dpvDrop": string,
  "dpvThrowback": string,
  "dpvNonDeliveryDays": string,
  "dpvNonDeliveryDaysValues": integer,
  "dpvNoSecureLocation": string,
  "dpvPbsa": string,
  "dpvDoorNotAccessible": string,
  "dpvEnhancedDeliveryCode": string,
  "carrierRoute": string,
  "carrierRouteIndicator": string,
  "ewsNoMatch": boolean,
  "postOfficeCity": string,
  "postOfficeState": string,
  "abbreviatedCity": string,
  "fipsCountyCode": string,
  "county": string,
  "elotNumber": string,
  "elotFlag": string,
  "lacsLinkReturnCode": string,
  "lacsLinkIndicator": string,
  "poBoxOnlyPostalCode": boolean,
  "suitelinkFootnote": string,
  "pmbDesignator": string,
  "pmbNumber": string,
  "addressRecordType": string,
  "defaultAddress": boolean,
  "errorMessage": string,
  "cassProcessed": boolean
}
Pola
standardizedAddress

object (UspsAddress)

Znormalizowany adres USPS.
deliveryPointCode

string

2-cyfrowy kod punktu dostawy
deliveryPointCheckDigit

string

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

string

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

  • N: nie udało się potwierdzić informacji o numerze głównym ani dodatkowym za pomocą usługi DPV.
  • D: adres został potwierdzony przez dostawcę tylko w przypadku numeru głównego, a informacje o numerze dodatkowym były niekompletne.
  • S: adres został potwierdzony w ramach weryfikacji dokumentów tożsamości 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 dpvConfirmation, adres nie został przesłany do potwierdzenia przez dostawcę.
dpvFootnote

string

Uwagi dotyczące 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 został znaleziony, ale jest wymagany
  • N1: brak numeru dodatkowego w adresie budynku
  • M1: brak głównego numeru
  • 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 dostawy ogólnym
  • U1: adres wejściowy dopasowany do unikalnego kodu pocztowego
  • PB: adres wejściowy dopasowany do rekordu PBSA
  • RR: potwierdzony adres firmy zewnętrznej z informacjami o PMB
  • R1: adres potwierdzony w DPV bez informacji z PMB
  • R7: rekord trasy R777 lub R779 operatora
  • IA: zidentyfikowano świadomy adres
  • TA: numer główny dopasowany przez odrzucenie ostatniej litery alfabetu
dpvCmra

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 zgodny z CMRA
dpvVacant

string

Czy to miejsce jest wolne? Zwraca pojedynczy znak.

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

string

Czy to jest adres bez danych statystycznych 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 jest nieaktywny
  • N: adres jest aktywny
dpvNoStatReasonCode

integer

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ó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: 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: dodatkowy wymagany – adres wymaga informacji dodatkowych.
dpvDrop

string

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

  • Y: e-mail jest dostarczany do jednej skrzynki, którą można odbierać w witrynie.
  • N: poczta nie jest dostarczana do jednego miejsca odbioru w witrynie.
dpvThrowback

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.
dpvNonDeliveryDays

string

Flaga wskazuje, że dostawa poczty nie jest realizowana w każdy dzień tygodnia. Zwraca pojedynczy znak.

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

integer

Liczba całkowita określająca dni niedostarczenia. 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
dpvNoSecureLocation

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: nie oznacza, że pakiet nie zostanie pozostawiony ze względów bezpieczeństwa.
dpvPbsa

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.
dpvDoorNotAccessible

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.
dpvEnhancedDeliveryCode

string

Wskazuje, że dla danego adresu prawidłowy może być więcej niż 1 kod zwrotu od dostawcy zewnętrznego. 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 o numerze głównym ani dodatkowym za pomocą usługi DPV.
  • 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ż w numerze głównym usunięto jedną końcową literę, aby dopasowanie w ramach weryfikacji danych osobowych było wymagane tylko w przypadku numeru dodatkowego.
  • D: adres został potwierdzony przez dostawcę 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 dostawa przez USPS nie została uwzględniona.
carrierRoute

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: trasa zakontraktowana na autostradę
  • B: sekcja skrzynki pocztowej
  • G: ogólna jednostka dostawy
carrierRouteIndicator

string

Wskaźnik sortowania stawki przewoźnika.
ewsNoMatch

boolean

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

string

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

string

Stan głównego urzędu pocztowego.
abbreviatedCity

string

Skrót nazwy miasta.
fipsCountyCode

string

Kod FIPS hrabstwa.
county

string

Nazwa hrabstwa.
elotNumber

string

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

string

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

boolean

Kod pocztowy tylko w przypadku skrytki pocztowej.
pmbDesignator

string

PMB (Private Mail Box) – identyfikator jednostki.
pmbNumber

string

Numer PMB (Private Mail Box);
addressRecordType

string

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

  • F: FIRMA. Jest to dopasowanie do rekordu firmy, czyli najlepszego możliwego poziomu dopasowania dla adresu.
  • G: OGÓLNA DOSTAWA. Jest to dopasowanie do rekordu ogólnego.
  • H: BUDOWANIE / Apartament. Dopasowanie do rekordu budynku lub mieszkania.
  • P: Skrzynka pocztowa. Pasuje do skrzynki pocztowej.
  • 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: to dopasowanie do rekordu ulicy zawierającego prawidłowy podstawowy zakres numerów.
defaultAddress

boolean

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

string

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

W przypadku wystąpienia tego błędu pola danych USPS mogą nie zostać wypełnione.
cassProcessed

boolean

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

UspsAddress

Dokument reprezentujący adres USPS w Stanach Zjednoczonych.

Zapis JSON 
{
  "firstAddressLine": string,
  "firm": string,
  "secondAddressLine": string,
  "urbanization": string,
  "cityStateZipAddressLine": string,
  "city": string,
  "state": string,
  "zipCode": string,
  "zipCodeExtension": string
}
Pola
firstAddressLine

string

Pierwszy wiersz adresu.
firm

string

Nazwa firmy.
secondAddressLine

string

Drugi wiersz adresu.
urbanization

string

Nazwa portorykańskiej aglomeracji miejskiej.
cityStateZipAddressLine

string

Miasto + stan + kod pocztowy.
city

string

Nazwa miasta.
state

string

2-literowy kod stanu.
zipCode

string

Kod pocztowy, np. 10009.
zipCodeExtension

string

4-cyfrowy kod pocztowy, np. 5023.