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. Jeśli 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 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 przypadku typowego użycia 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 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.

Pola
revision

int32

Wersja schematu PostalAddress. Każda wartość inna niż 0 powoduje zwrócenie błędu INVALID_ARGUMENT przez interfejs API.
region_code

string

Opcjonalnie: Kod regionu CLDR kraju lub 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” 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. address_lines już obejmuje dany region, nie podawaj w tym polu kodu tego regionu. Listę obsługiwanych regionów znajdziesz w najczęstszych pytaniach.
language_code

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

string

Opcjonalnie: Kod pocztowy w adresie. Nie we wszystkich krajach kody pocztowe są używane lub wymagane, ale w przypadku, gdy są używane, mogą powodować dodatkowe sprawdzanie innych części adresu (np. weryfikację stanu lub kodu pocztowego w Stanach Zjednoczonych).
sorting_code

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).
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 przypadku Hiszpanii jest to prowincja, a nie wspólnota autonomiczna (np. „Barcelona”, 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 miasta w adresie. 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 atrybutu „address_lines”.
sublocality

string

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

string

Wymagane. Nieuporządkowane wiersze adresu opisujące dolne 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 być zgodna z „kolejnością na kopercie” w kraju lub regionie, w którym znajduje się adres.

Minimalna dozwolona struktura adresu obejmuje wszystkie informacje umieszczone w elementach address_lines. Jeśli nie podasz wartości region_code, region zostanie wywnioskowany 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ż obecnie interfejs API nie odrzuca żądań z tym ustawieniem pola, informacje zostaną odrzucone i nie zostaną zwrócone w odpowiedzi.