Package google.type

Индекс

Широта и долгота

Объект, представляющий пару широта/долгота. Выражается как пара чисел двойной точности для представления градусов широты и градусов долготы. Если не указано иное, этот объект должен соответствовать стандарту WGS84 . Значения должны находиться в нормализованных диапазонах.

Поля
latitude

double

Широта в градусах. Она должна быть в диапазоне [-90.0, +90.0].

longitude

double

Долгота в градусах. Она должна быть в диапазоне [-180.0, +180.0].

ПочтовыйАдрес

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

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

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

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

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

Поля
revision

int32

Пересмотр схемы PostalAddress . Любое значение, отличное от 0, приведет к тому, что API вернет ошибку INVALID_ARGUMENT .

region_code

string

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

language_code

string

Код языка во входном адресе зарезервирован для будущего использования и сегодня игнорируется. API возвращает адрес на соответствующем языке для того места, где находится адрес.

postal_code

string

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

sorting_code

string

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

administrative_area

string

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

locality

string

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

sublocality

string

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

address_lines[]

string

Обязательно. Неструктурированные строки адреса, описывающие нижние уровни адреса.

Поскольку значения в address_lines не имеют информации о типе и иногда могут содержать несколько значений в одном поле (например, "Austin, TX"), важно, чтобы порядок строк был понятным. Порядок адресных строк должен быть "порядком конверта" для страны/региона адреса.

Минимально допустимое структурное представление адреса состоит из всей информации, размещенной в address_lines . Если region_code не указан, регион выводится из адресных строк.

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

recipients[]

string

Пожалуйста, избегайте установки этого поля. API проверки адресов в настоящее время не использует его. Хотя в настоящее время API не отклоняет запросы с установленным этим полем, информация будет отброшена и не будет возвращена в ответе.

organization

string

Пожалуйста, избегайте установки этого поля. API проверки адресов в настоящее время не использует его. Хотя в настоящее время API не отклоняет запросы с установленным этим полем, информация будет отброшена и не будет возвращена в ответе.