Indeks
LatLng
(komunikat)PostalAddress
(komunikat)
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 |
Szerokość geograficzna w stopniach. Musi mieścić się w zakresie [-90,0; +90,0]. |
longitude |
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 |
Wersja schematu elementu |
region_code |
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 |
language_code |
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 |
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 |
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 |
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 |
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 |
Opcjonalnie. Dzielnica adresu. Mogą to być dzielnice, dystrykty, dzielnice. |
address_lines[] |
To pole jest wymagane. Nieuporządkowane wiersze adresu opisujące niższe poziomy adresu. |
recipients[] |
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 |
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. |