Package google.type

Indeks

LatLng

Obiekt reprezentujący parę szerokości i długości geograficznej. Wartość ta jest wyrażana jako para podwójnej wartości reprezentującej stopnie szerokości i długości geograficznej w stopniach. O ile nie wskazano inaczej, ten obiekt musi być zgodny ze standardem WGS84. Wartości muszą mieścić się w znormalizowanych 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, na przykład adres dostawy lub płatności. Podany adres pocztowy pozwala na dostarczenie przesyłek do lokalu, skrytki pocztowej itp. Nie służy do modelowania lokalizacji geograficznych (dróg, miast, gór).

W typowym użyciu adres jest tworzony na podstawie danych wejściowych użytkownika lub importu istniejących danych, w zależności od typu procesu.

Wskazówki dotyczące wpisywania / edytowania adresu: – Używaj widżetu adresu gotowego do internacjonalizacji, np. https://github.com/google/libaddressinput). – Użytkownicy nie powinni widzieć elementów interfejsu do wprowadzania lub edytowania pól poza krajami, w których to pole jest używane.

Więcej wskazówek dotyczących korzystania z tego schematu znajdziesz na https://support.google.com/business/answer/6397478.

Pola
revision

int32

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

region_code

string

Opcjonalnie. Kod regionu CLDR kraju lub regionu adresu. Szczegółowe informacje 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 nie podasz kodu regionu, zostanie on wywnioskowany na podstawie adresu. Aby uzyskać najlepszą wydajność, zalecamy dołączenie kodu regionu, jeśli go znasz. Niespójne lub powtarzające się regiony mogą obniżyć wydajność, np. jeśli address_lines zawiera już region, nie podawaj ponownie kodu regionu w tym polu. Informacje o obsługiwanych regionach znajdziesz w odpowiedziach na najczęstsze pytania.

language_code

string

Kod języka w adresie wejściowym jest zarezerwowany do wykorzystania w przyszłości i dziś jest ignorowany. Interfejs API zwraca adres w języku odpowiednim dla lokalizacji adresu.

postal_code

string

Opcjonalnie. Kod pocztowy adresu. Nie we wszystkich krajach stosuje się kod pocztowy lub go nie wymaga, ale tam, gdzie są one używane, mogą wymagać dodatkowej weryfikacji w innych częściach adresu (np. w Stanach Zjednoczonych).

sorting_code

string

Opcjonalnie. Dodatkowy kod rozliczeniowy zależny od kraju. Ta funkcja nie jest używana w większości regionów. Ta wartość jest ciągiem znaków typu „CEDEX”, opcjonalnie po którym następuje liczba (np. „CEDEX 7”), lub sama liczba reprezentująca „kod sektora” (Jamajka), „wskaźnik obszaru dostawy” (malawi) lub „wskaźnik poczty” (np. Wybrzeże Kości Słoniowej).

administrative_area

string

Opcjonalnie. Najwyższy podział administracyjny 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 społeczność autonomiczna (np. „Barcelona”, a nie „Katalonia”). W wielu krajach nie używa się obszaru administracyjnego w adresach pocztowych. Na przykład w Szwajcarii to pole powinno pozostać puste.

locality

string

Opcjonalnie. Zwykle odnosi się do miasta/miasta adresu. Przykłady: miasto w USA, gmina IT, brytyjska poczta. W przypadku regionów, w których miejscowości nie są dobrze zdefiniowane lub nie pasują do takiej struktury, zostaw pole rejonu puste i użyj atrybutu „address_lines”.

sublocality

string

Opcjonalnie. Dzielnica adresu. Mogą to być dzielnice, dystrykty, dzielnice.

address_lines[]

string

To pole jest wymagane. Nieuporządkowane wiersze adresu opisujące niższe poziomy adresu.

Ponieważ wartości w polach address_lines nie zawierają informacji o typie i czasami mogą zawierać wiele wartości w jednym polu (np. „Austin, TX”), kolejność wierszy musi być jasna. Kolejność wierszy adresu powinna być określona jako „kolejność kopert” dla kraju lub regionu adresu.

Minimalna dozwolona reprezentacja strukturalna adresu obejmuje wszystkie informacje umieszczone w address_lines. Jeśli pole region_code nie jest podane, region jest określany na podstawie wierszy adresu.

Utworzenie adresu zawierającego tylko adres address_lines, a następnie geokodowanie jest zalecanym sposobem obsługi całkowicie nieuporządkowanych adresów (zamiast zgadywania, które części adresu powinny być nazwami miejscowości lub obszarów administracyjnych).

recipients[]

string

Nie ustawiaj tego pola. Interfejs Address Validation API obecnie nie używa tego interfejsu. Mimo że obecnie interfejs API nie odrzuca żądań z tym zestawem pól, informacje są odrzucane i nie będą zwracane w odpowiedzi.

organization

string

Nie ustawiaj tego pola. Interfejs Address Validation API obecnie nie używa tego interfejsu. Mimo że obecnie interfejs API nie odrzuca żądań z tym zestawem pól, informacje są odrzucane i nie będą zwracane w odpowiedzi.