PostalAddress

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

W typowym przypadku adres jest tworzony na podstawie danych wprowadzonych przez użytkownika lub zaimportowanych z istniejących danych, w zależności od typu procesu.

Wskazówki dotyczące wpisywania lub edytowania adresu:

  • Użyj widżetu adresu przygotowanego do internacjonalizacji, takiego jak https://github.com/google/libaddressinput.
  • Użytkownicy nie powinni widzieć elementów interfejsu do wprowadzania lub edytowania pól poza krajami, w których dane pole jest 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. Musi mieć wartość 0, czyli najnowszą wersję.

Wszystkie nowe wersje muszą być zgodne wstecznie ze starymi wersjami.
regionCode

string

Wymagane. Kod regionu CLDR kraju lub regionu adresu. Ta wartość nigdy nie jest określana automatycznie i użytkownik musi upewnić się, że jest prawidłowa. 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.
languageCode

string

Opcjonalnie. Kod języka BCP-47 treści tego adresu (jeśli jest znany). Często jest to język interfejsu formularza wejściowego lub powinien odpowiadać jednemu z języków używanych w kraju/regionie adresu albo ich transliterowanym odpowiednikom. Może to mieć wpływ na formatowanie w niektórych krajach, ale nie jest to kluczowe dla poprawności danych i nigdy nie wpłynie na weryfikację ani inne operacje niezwiązane z formatowaniem.

Jeśli ta wartość jest nieznana, należy ją pominąć (zamiast podawać potencjalnie nieprawidłową wartość domyślną).

Przykłady: „zh-Hant”, „ja”, „ja-Latn”, „en”.
postalCode

string

Opcjonalnie. Kod pocztowy w adresie. Nie wszystkie kraje używają kodów pocztowych lub ich wymagają, ale tam, gdzie są one używane, mogą powodować dodatkową weryfikację z innymi częściami adresu (np. weryfikację stanu lub kodu pocztowego w Stanach Zjednoczonych).
sortingCode

string

Opcjonalnie. Dodatkowy kod banku zależny od kraju. W większości regionów nie jest on używany. Wartość ta jest ciągiem znaków, np. „CEDEX”, po którym opcjonalnie może następować liczba (np. „CEDEX 7”), lub samą liczbą, która reprezentuje „kod sektora” (Jamajka), „wskaźnik obszaru dostawy” (Malawi) lub „wskaźnik urzędu pocztowego” (Wybrzeże Kości Słoniowej).
administrativeArea

string

Opcjonalnie. Najwyższy poziom podziału administracyjnego, który jest używany w adresach pocztowych kraju lub regionu. 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”, a nie „Katalonia”). W wielu krajach nie używa się regionu w adresach pocztowych. Na przykład w Szwajcarii to pole powinno pozostać puste.
locality

string

Opcjonalnie. Zwykle odnosi się do części adresu zawierającej nazwę miasta lub miejscowości. Przykłady: miasto w USA, gmina we Włoszech, miasto pocztowe 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 pola addressLines.
sublocality

string

Opcjonalnie. Dzielnica w adresie. Może to być na przykład dzielnica, okręg lub dystrykt.
addressLines[]

string

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

Wartości w pliku addressLines nie zawierają informacji o typie i czasami mogą zawierać wiele wartości w jednym polu (np. „Austin, TX”), dlatego ważne jest, aby kolejność wierszy była jasna. Kolejność wierszy adresu powinna być zgodna z „kolejnością na kopercie” w kraju lub regionie adresu. W miejscach, gdzie może się to różnić (np. w Japonii), używany jest parametr address_language, aby wyraźnie to określić (np. „ja” w przypadku kolejności od największego do najmniejszego i „ja-Latn” lub „en” w przypadku kolejności od najmniejszego do największego). W ten sposób można wybrać najbardziej szczegółowy wiersz adresu na podstawie języka.

Minimalna dozwolona reprezentacja strukturalna adresu składa się z pola regionCode, a wszystkie pozostałe informacje są umieszczone w polu addressLines. Możliwe byłoby sformatowanie takiego adresu w przybliżeniu bez kodowania geograficznego, ale nie można by było wyciągnąć żadnych wniosków semantycznych dotyczących żadnego z komponentów adresu, dopóki nie zostałby on przynajmniej częściowo rozpoznany.

Zalecanym sposobem postępowania z całkowicie nieustrukturyzowanymi adresami jest utworzenie adresu zawierającego tylko regionCode i addressLines, a następnie geokodowanie (zamiast zgadywania, które części adresu powinny być miejscowościami lub regionami).
recipients[]

string

Opcjonalnie. Odbiorca pod adresem. W pewnych okolicznościach to pole może zawierać informacje w kilku wierszach. Może na przykład zawierać informacje o osobie, do której należy dostarczyć przesyłkę.
organization

string

Opcjonalnie. Nazwa organizacji pod adresem.