Package google.type

Indeks

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 określono inaczej, obiekt musi być zgodny ze standardem WGS84. Wartości muszą mieścić się w normalizowanych zakresach.

Pola
latitude

double

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

double

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

PostalAddress

Reprezentuje adres pocztowy, np. adres do dostawy lub adres do płatności. Dzięki adresowi pocztowemu usługa pocztowa może dostarczyć produkty do budynku, skrytki pocztowej lub podobnego miejsca. Adres pocztowy nie służy do modelowania lokalizacji geograficznych, takich jak drogi, miasta czy góry.

W zwykłym przypadku adres jest tworzony przez użytkownika lub importowany z dotychczasowych danych, w zależności od typu procesu.

Porady dotyczące wprowadzania i edytowania adresu:

  • Użyj elementu obsługi adresu gotowego do międzynarodowego użycia, takiego jak https://github.com/google/libaddressinput.
  • Użytkownicy nie powinni mieć możliwości wprowadzania danych ani edytowania pól poza krajami, w których są one używane.

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

Pola
revision

int32

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

string

Opcjonalnie. Kod regionu CLDR kraju/regionu adresu. Więcej informacji znajdziesz na stronach https://cldr.unicode.org/ i https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html. Przykład: „CH” dla 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. address_lines już obejmuje region, nie podawaj w tym polu kodu regionu ponownie. Obsługiwane regiony znajdziesz w często zadawanych pytaniach.
language_code

string

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

string

Opcjonalnie. Kod pocztowy w adresie. Nie we wszystkich krajach stosuje się kody pocztowe lub wymaga się ich podawania, ale tam, gdzie są używane, mogą one powodować dodatkową weryfikację innych części adresu (np. weryfikację stanu lub kodu pocztowego w Stanach Zjednoczonych).
sorting_code

string

Opcjonalnie. Dodatkowy kod sortowania w danym kraju. Nie jest on używany w większości regionów. W przypadku, gdy jest używany, wartość to ciąg znaków, np. „CEDEX”, opcjonalnie z dodatkowym numerem (np. „CEDEX 7”), lub tylko liczba, która reprezentuje „kod sektora” (Jamajka), „wskaźnik obszaru dostawy” (Malawi) lub „wskaźnik urzędu pocztowego” (Wybrzeże Kości Słoniowej).
administrative_area

string

Opcjonalnie. Najwyższy podział administracyjny, który jest używany w przypadku adresów pocztowych w kraju lub regionie. Może to być na przykład stan, prowincja, obwód lub prefektura. W Hiszpanii jest to prowincja, a nie autonomiczna społeczność (np. „Barcelona”, a nie „Katalonia”). W wielu krajach w adresach pocztowych nie podaje się obszaru administracyjnego. Na przykład w Szwajcarii nie należy wypełniać tego pola.
locality

string

Opcjonalnie. Zwykle odnosi się do części adresu zawierającej nazwę miasta. Przykłady: miasto w USA, miasto w Włoszech, miejscowość w Wielkiej Brytanii. W regionach świata, w których lokalizacja nie jest dobrze zdefiniowana lub nie pasuje do tej struktury, pozostaw pole locality puste i użyj pola address_lines.
sublocality

string

Opcjonalnie. Podjednostka adresu. Może to być na przykład dzielnica, okręg lub region.
address_lines[]

string

Wymagane. Nieustrukturyzowane wiersze adresu opisujące niższe poziomy adresu.

Ponieważ wartości w polu address_lines nie zawierają informacji o typie i czasami mogą zawierać wiele wartości w pojedynczym polu (np. „Austin, TX”), ważne jest, aby kolejność wierszy była jasna. Kolejność wierszy adresu powinna odpowiadać „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 address_lines. Jeśli nie podasz wartości region_code, region zostanie określony na podstawie wierszy adresu.

 Utworzenie adresu zawierającego tylko address_lines, a następnie geokodowanie jest zalecanym sposobem postępowania w przypadku całkowicie nieustrukturyzowanych adresów (zamiast zgadywania, które części adresu powinny być miejscowościami lub obszarami administracyjnymi).
recipients[]

string

Nie ustawiaj tego pola. Interfejs Address Validation API 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.
organization

string

Nie ustawiaj tego pola. Interfejs Address Validation API 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.