Индекс
-
LatLng
(сообщение) -
PostalAddress
(сообщение)
Широта и долгота
Объект, представляющий пару широта/долгота. Выражается как пара чисел двойной точности для представления градусов широты и градусов долготы. Если не указано иное, этот объект должен соответствовать стандарту WGS84 . Значения должны находиться в нормализованных диапазонах.
Поля | |
---|---|
latitude | Широта в градусах. Она должна быть в диапазоне [-90.0, +90.0]. |
longitude | Долгота в градусах. Она должна быть в диапазоне [-180.0, +180.0]. |
ПочтовыйАдрес
Представляет почтовый адрес, например, для почтовой доставки или платежных адресов. С почтовым адресом почтовая служба может доставлять товары на территорию, в почтовый ящик или в подобное место. Почтовый адрес не предназначен для моделирования географических местоположений, таких как дороги, города или горы.
При типичном использовании адрес создается путем ввода данных пользователем или путем импорта существующих данных, в зависимости от типа процесса.
Советы по вводу или редактированию адреса:
- Используйте готовый к интернационализации виджет адреса, например https://github.com/google/libaddressinput .
- Пользователям не должны предоставляться элементы пользовательского интерфейса для ввода или редактирования полей за пределами стран, где это поле используется.
Дополнительные инструкции по использованию этой схемы см. по адресу: https://support.google.com/business/answer/6397478 .
Поля | |
---|---|
revision | Пересмотр схемы |
region_code | Необязательно. Код региона CLDR страны/региона адреса. Подробности см. на https://cldr.unicode.org/ и https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html . Например: «CH» для Швейцарии. Если код региона не указан, он будет выведен из адреса. Для лучшей производительности рекомендуется включить код региона, если вы его знаете. Наличие несогласованных или повторяющихся регионов может привести к низкой производительности, например, если |
language_code | Код языка во входном адресе зарезервирован для будущего использования и сегодня игнорируется. API возвращает адрес на соответствующем языке для того места, где находится адрес. |
postal_code | Необязательно. Почтовый индекс адреса. Не все страны используют или требуют указания почтовых индексов, но там, где они используются, они могут вызывать дополнительную проверку с другими частями адреса (например, проверку штата или почтового индекса в Соединенных Штатах). |
sorting_code | Необязательно. Дополнительный, специфичный для страны, код сортировки. В большинстве регионов он не используется. Там, где он используется, значение представляет собой либо строку типа «CEDEX», за которой может следовать число (например, «CEDEX 7»), либо просто число, представляющее «код сектора» (Ямайка), «индикатор зоны доставки» (Малави) или «индикатор почтового отделения» (Кот-д'Ивуар). |
administrative_area | Необязательно. Высшая административная единица, которая используется для почтовых адресов страны или региона. Например, это может быть штат, провинция, область или префектура. Для Испании это провинция, а не автономное сообщество (например, «Барселона», а не «Каталония»). Во многих странах административная область в почтовых адресах не используется. Например, в Швейцарии ее следует оставить незаселенной. |
locality | Необязательно. Обычно относится к части адреса, обозначающей город или населенный пункт. Примеры: город в США, коммуна в IT, почтовый город в Великобритании. В регионах мира, где населенные пункты не определены четко или не вписываются в эту структуру, оставьте |
sublocality | Необязательно. Подрайон адреса. Например, это может быть район, округ или район. |
address_lines[] | Обязательно. Неструктурированные строки адреса, описывающие нижние уровни адреса. |
recipients[] | Пожалуйста, избегайте установки этого поля. API проверки адресов в настоящее время не использует его. Хотя в настоящее время API не отклоняет запросы с установленным этим полем, информация будет отброшена и не будет возвращена в ответе. |
organization | Пожалуйста, избегайте установки этого поля. API проверки адресов в настоящее время не использует его. Хотя в настоящее время API не отклоняет запросы с установленным этим полем, информация будет отброшена и не будет возвращена в ответе. |