Adres pocztowy, np. adres pocztowy lub adres do płatności. Podany adres pocztowy pozwala dostarczyć produkty do skrytki pocztowej lub do placówki. Jego zadaniem nie jest modelowanie położenia geograficznego (dróg, miast, gór).
W przypadku typowego użycia adres jest tworzony przez dane wejściowe użytkownika lub poprzez importowanie istniejących danych.
Porady dotyczące wprowadzania / edytowania adresów: – korzystaj z widżetu gotowości i18n adresu, np. https://github.com/google/libaddressinput – użytkownikom nie wolno wyświetlać elementów interfejsu do wprowadzania lub edytowania pól poza krajami, w których używane jest to pole.
Więcej wskazówek na temat korzystania ze 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 |
Wersja schematu elementu Wszystkie nowe wersje muszą być zgodne wstecznie ze starymi wersjami. |
regionCode |
Wymagany. Kod regionu CLDR kraju lub regionu adresu. Ta zmiana nie jest nigdy wywnioskowana i to użytkownik decyduje, czy wartość jest prawidłowa. Szczegółowe informacje znajdziesz na stronach http://cldr.unicode.org/ i http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html. Przykład: "CH" dla Szwajcarii. |
languageCode |
Opcjonalne. Kod języka zawartości tego adresu w formacie BCP-47 (jeśli jest znany). Jest to często język interfejsu formularza wejściowego lub powinien być zgodny z jednym z języków używanych w adresie/kraju lub jego transliteracji. Może to wpłynąć na formatowanie w niektórych krajach, ale nie ma wpływu na prawidłowość danych i nigdy nie wpływa na weryfikację ani inne powiązane operacje formatowania. 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 |
Opcjonalne. Kod pocztowy adresu. Nie wszystkie kraje korzystają z kodów pocztowych lub ich wymagają, ale mogą wymagać dodatkowych weryfikacji z innymi elementami adresu (np. weryfikacji stanu lub kodu pocztowego w Stanach Zjednoczonych). |
sortingCode |
Opcjonalne. Dodatkowy kod do sortowania w poszczególnych krajach. W większości regionów jest to niemożliwe. Tam, gdzie jest ona używana, może to być ciąg znaków w postaci ciągu "CEDEX" opcjonalnie cyfry (np. "CEDEX 7") lub tylko liczba wskazująca &"wskaźnik obszaru dostawy (Malawi) lub "3. |
administrativeArea |
Opcjonalne. Najwyższy podział administracyjny używany w przypadku adresów pocztowych w danym kraju lub regionie. Może to być np. stan, prowincja, obwód lub prefektura. W przypadku Hiszpanii jest to prowincja, a nie wspólnota autonomiczna (np. "Barcelona" & quot;Katalo"). W wielu krajach adres pocztowy nie zawiera obszaru administracyjnego. Np. w Szwajcarii to pole powinno pozostać puste. |
locality |
Opcjonalne. Adres ten jest zwykle określany przez część miasta. Przykłady: USA, gmina IT, Wielka Brytania. W regionach świata, w którym miasta nie są odpowiednio zdefiniowane lub nie pasują do tej struktury, pozostaw pole puste puste i użyj elementów AddressLine. |
sublocality |
Opcjonalne. Dzielnica adresu. Mogą to być na przykład dzielnice, dystrykty, czyli okręgi. |
addressLines[] |
Nieuporządkowane wiersze adresu opisujące niższe poziomy adresu. Wartości w adresach wierszy nie zawierają informacji o typie i czasem mogą zawierać wiele wartości w jednym polu (np. "Austin, TX"), więc kolejność elementów zamówienia musi być jasna. Wiersze adresów powinny być ustawione w określonym kraju/regionie adresu. W przypadkach, w których może się to zmieniać (np. Japonia), adres address_language jest używany do jednoznacznego wyrażenia (np. "ja" dla dużych i małych kolejności oraz "ja-Latn" lub "en" dla małych i dużych). Dzięki temu możesz wybrać najbardziej szczegółową linię adresu w zależności od języka. Minimalna dozwolona struktura, która określa adres, składa się z parametru regionCode wraz ze wszystkimi pozostałymi informacjami umieszczonymi w wierszu adresu. Można było sformatować taki adres niemal w ogóle bez geokodowania, ale o semantycznym komponentie adresu nie można w żaden sposób zadecydować, dopóki nie zostanie on co najmniej częściowo rozwiązany. Najlepiej jest utworzyć adres zawierający tylko regionregiony i wiersze adresu, a następnie geokodowanie – jest to zalecany sposób postępowania z całkowicie nieuporządkowanymi adresami (a nie tylko odgadywanie, które części adresu powinny być miejscowościami czy obszarami administracyjnymi). |
recipients[] |
Opcjonalne. Odbiorca pod adresem. To pole może w pewnych okolicznościach zawierać informacje wielowierszowe. Mogą one na przykład zawierać informacje o pielęgnacji i pielęgnacji. |
organization |
Opcjonalne. Nazwa organizacji pod adresem. |