PostalAddress

Представляет почтовый адрес, например, для почтовой доставки или оплаты. С помощью почтового адреса почтовая служба может доставлять товары на объект, в абонентский ящик и т.п. Почтовый адрес не предназначен для моделирования географических объектов, таких как дороги, города или горы.

При типичном использовании адрес создается путем ввода данных пользователем или путем импорта существующих данных, в зависимости от типа процесса.

Советы по вводу или редактированию адреса:

  • Используйте готовый к интернационализации виджет адреса, например https://github.com/google/libaddressinput .
  • Пользователям не должны предоставляться элементы пользовательского интерфейса для ввода или редактирования полей за пределами стран, где это поле используется.

Дополнительные инструкции по использованию этой схемы см. по адресу: https://support.google.com/business/answer/6397478 .

JSON-представление 
{
  "revision": integer,
  "regionCode": string,
  "languageCode": string,
  "postalCode": string,
  "sortingCode": string,
  "administrativeArea": string,
  "locality": string,
  "sublocality": string,
  "addressLines": [
    string
  ],
  "recipients": [
    string
  ],
  "organization": string
}
Поля
revision

integer

Версия схемы PostalAddress . Должна быть установлена на 0, что соответствует последней версии.

Все новые версии должны быть обратно совместимы со старыми версиями.

regionCode

string

Обязательно. Код региона CLDR страны/региона адреса. Он никогда не определяется логически, и пользователь должен сам убедиться в правильности значения. Подробнее см. https://cldr.unicode.org/ и https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html . Пример: «CH» для Швейцарии.

languageCode

string

Необязательно. Код языка BCP-47 содержимого этого адреса (если известен). Часто это язык пользовательского интерфейса формы ввода или, как ожидается, один из языков, используемых в стране/регионе адреса, или их транслитерированные эквиваленты. Это может повлиять на форматирование в некоторых странах, но не критично для корректности данных и никогда не повлияет на проверку или другие операции, не связанные с форматированием.

Если это значение неизвестно, его следует опустить (вместо указания возможно неверного значения по умолчанию).

Примеры: «ж-Хант», «джа», «джа-Латн», «ен».

postalCode

string

Необязательно. Почтовый индекс адреса. Не во всех странах используются или требуются почтовые индексы, но там, где они используются, может потребоваться дополнительная проверка с другими частями адреса (например, проверка штата или почтового индекса в США).

sortingCode

string

Необязательный. Дополнительный сортировочный код, специфичный для страны. Используется не в большинстве регионов. В тех случаях, когда используется, значение представляет собой либо строку типа «CEDEX», за которой может следовать число (например, «CEDEX 7»), либо просто число, представляющее собой «код сектора» (Ямайка), «код зоны доставки» (Малави) или «код почтового отделения» (Кот-д'Ивуар).

administrativeArea

string

Необязательно. Высшая административная единица, используемая для почтовых адресов страны или региона. Например, это может быть штат, провинция, область или префектура. В Испании это провинция, а не автономное сообщество (например, «Барселона», а не «Каталония»). Во многих странах административные районы в почтовых адресах не используются. Например, в Швейцарии этот район не следует указывать.

locality

string

Необязательно. Обычно относится к части адреса, указывающей город. Примеры: город в США, коммуна в США, почтовый город в Великобритании. В регионах мира, где населённые пункты нечётко определены или плохо вписываются в эту структуру, оставьте locality пустым и используйте addressLines .

sublocality

string

Необязательно. Укажите район (подрайон) адреса. Например, это может быть район, округ или район.

addressLines[]

string

Неструктурированные адресные строки, описывающие нижние уровни адреса.

Поскольку значения в addressLines не содержат информации о типе и иногда могут содержать несколько значений в одном поле (например, «Остин, Техас»), важно, чтобы порядок строк был понятным. Строки адреса должны располагаться в порядке «конверта» для страны или региона адреса. В местах, где порядок может варьироваться (например, в Японии), для его уточнения используется address_language (например, «ja» для упорядочивания от большего к меньшему и «ja-Latn» или «en» для упорядочивания от меньшего к большему). Таким образом, можно выбрать наиболее конкретную строку адреса на основе языка.

Минимально допустимое структурное представление адреса состоит из regionCode , а вся остальная информация помещена в addressLines . Такой адрес можно было бы отформатировать очень приблизительно без геокодирования, но семантическое суждение о компонентах адреса невозможно, пока он не будет хотя бы частично распознан.

Для обработки полностью неструктурированных адресов рекомендуется создать адрес, содержащий только regionCode и addressLines , а затем выполнить геокодирование (в отличие от угадывания того, какие части адреса должны быть населенными пунктами или административными районами).

recipients[]

string

Необязательно. Получатель по адресу. В некоторых случаях это поле может содержать многострочную информацию. Например, оно может содержать информацию о получателе.

organization

string

Необязательно. Название организации по адресу.