Представляет почтовый адрес, например, для почтовых адресов доставки или платежей. Имея почтовый адрес, почтовая служба может доставить отправления в помещение, почтовый ящик и т.п. Он не предназначен для моделирования географических объектов (дорог, городов, гор).
При типичном использовании адрес будет создан с помощью пользовательского ввода или путем импорта существующих данных, в зависимости от типа процесса.
Совет по вводу/редактированию адреса: - Используйте виджет адреса с поддержкой i18n, такой как 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 | Версия схемы Все новые версии должны быть обратно совместимы со старыми версиями. |
regionCode | Необходимый. Код региона CLDR страны/региона адреса. Это никогда не выводится, и пользователь должен убедиться, что значение правильное. Подробности см. на http://cldr.unicode.org/ и http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html . Пример: "CH" для Швейцарии. |
languageCode | Необязательный. Код языка BCP-47 содержимого этого адреса (если известен). Часто это язык пользовательского интерфейса формы ввода или ожидается, что он будет соответствовать одному из языков, используемых в стране/регионе адреса, или их транслитерированным эквивалентам. Это может повлиять на форматирование в некоторых странах, но не критично для правильности данных и никогда не повлияет на проверку или другие операции, не связанные с форматированием. Если это значение неизвестно, его следует опустить (вместо указания возможно неправильного значения по умолчанию). Примеры: «ж-хант», «джа», «джа-латн», «эн». |
postalCode | Необязательный. Почтовый индекс адреса. Не во всех странах используются или требуются почтовые индексы, но там, где они используются, они могут инициировать дополнительную проверку с другими частями адреса (например, проверка штата/почтового индекса в США). |
sortingCode | Необязательный. Дополнительный код сортировки для конкретной страны. В большинстве регионов не используется. Там, где он используется, значение представляет собой либо строку, например «CEDEX», за которой может следовать число (например, «CEDEX 7»), либо просто число, представляющее «код сектора» (Ямайка), «указатель области доставки». (Малави) или "указатель почтового отделения" (например, Кот-д'Ивуар). |
administrativeArea | Необязательный. Высшая административная единица, которая используется для почтовых адресов страны или региона. Например, это может быть штат, провинция, область или префектура. В частности, для Испании это провинция, а не автономное сообщество (например, «Барселона», а не «Каталония»). Многие страны не используют административный район в почтовых адресах. Например, в Швейцарии его следует оставить незаселенным. |
locality | Необязательный. Обычно относится к городской части адреса. Примеры: город США, IT-коммуна, почтовый город Великобритании. В регионах мира, где населенные пункты плохо определены или плохо вписываются в эту структуру, оставьте поле населенного пункта пустым и используйте адресные строки. |
sublocality | Необязательный. Подлокальность адреса. Например, это могут быть микрорайоны, районы, районы. |
addressLines[] | Неструктурированные адресные строки, описывающие нижние уровни адреса. Поскольку значения в addressLines не имеют информации о типе и иногда могут содержать несколько значений в одном поле (например, «Остин, Техас»), важно, чтобы порядок строк был четким. Порядок адресных строк должен быть «конвертным» для страны/региона адреса. В местах, где это может варьироваться (например, в Японии), address_language используется, чтобы сделать его явным (например, «ja» для упорядочения от большого к меньшему и «ja-Latn» или «en» для упорядочения от маленького к большому). Таким образом, наиболее конкретная строка адреса может быть выбрана в зависимости от языка. Минимально допустимое структурное представление адреса состоит из кода региона, а вся остальная информация размещается в адресных строках. Такой адрес можно было бы очень приблизительно отформатировать без геокодирования, но никакие семантические рассуждения нельзя было бы сделать ни для одного из компонентов адреса, пока он не был хотя бы частично разрешен. Создание адреса, содержащего только regionCode и addressLines, а затем геокодирование — рекомендуемый способ обработки полностью неструктурированных адресов (в отличие от угадывания, какие части адреса должны быть населенными пунктами или административными областями). |
recipients[] | Необязательный. Получатель по адресу. Это поле может при определенных обстоятельствах содержать многострочную информацию. Например, он может содержать информацию об уходе. |
organization | Необязательный. Название организации по адресу. |