Package google.maps.addressvalidation.v1

string

Адрес после постобработки, отформатированный как однострочный адрес в соответствии с правилами форматирования адреса региона, в котором расположен адрес.

PostalAddress

Адрес после обработки, представленный как почтовый адрес.

AddressComponent

Неупорядоченный список. Отдельные компоненты адреса отформатированного и исправленного адреса, а также информация проверки. Это предоставляет информацию о статусе проверки отдельных компонентов.

Компоненты адреса не упорядочены определенным образом. Не делайте никаких предположений относительно порядка компонентов адреса в списке.

string

Типы компонентов, которые должны были присутствовать в правильно отформатированном почтовом адресе, но не были найдены во входных данных И не могли быть определены. Компоненты этого типа отсутствуют в formatted_address , postal_address или address_components . Примером может быть ['street_number', 'route'] для ввода типа «Боулдер, Колорадо, 80301, США». Список возможных типов можно найти здесь .

string

Типы компонентов, которые присутствуют в address_components , но их правильность не подтверждена. Это поле предоставлено для удобства: его содержимое эквивалентно перебору address_components для поиска типов всех компонентов, у которых confirmation_level не CONFIRMED или inferred флаг не установлен в true . Список возможных типов можно найти здесь .

string

Любые токены во входных данных, которые не удалось разрешить. Это может быть ввод, который не был распознан как допустимая часть адреса (например, при вводе типа «123235253253 Main St, San Francisco, CA, 94105» неразрешенные токены могут выглядеть как ["123235253253"] поскольку это не так. не похож на действительный номер улицы.

ComponentName

Имя этого компонента.

string

Тип компонента адреса. Список возможных типов см. в Таблице 2: Дополнительные типы, возвращаемые службой Places .

ConfirmationLevel

Указывает уровень нашей уверенности в том, что компонент правильный.

bool

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

bool

Указывает на исправление ошибки в названии компонента. API не всегда отмечает изменения одного варианта написания на другой, например, при изменении «центра» на «центр». Он также не всегда отмечает распространенные орфографические ошибки, например, при замене «Амфитеатр Пкви» на «Амфитеатр Пкви».

bool

Указывает, что имя компонента было заменено совершенно другим, например, неправильный почтовый индекс был заменен на правильный для адреса. Это не косметическое изменение, входной компонент изменен на другой.

bool

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

bool

Указывает, что это адрес компании. Если значение не установлено, это означает, что значение неизвестно.

bool

Указывает, что это адрес почтового ящика. Если значение не установлено, это означает, что значение неизвестно.

bool

Указывает, что это адрес проживания. Если значение не установлено, это означает, что значение неизвестно.

string

Текст имени. Например, «5th Avenue» для названия улицы или «1253» для номера улицы.

string

Код языка BCP-47. Его не будет, если имя компонента не связано с языком, например, с номером улицы.

LatLng

Геокодированное местоположение входных данных.

Использование идентификаторов мест предпочтительнее использования адресов, координат широты/долготы или плюсовых кодов. Использование координат при маршрутизации или расчете направлений движения всегда приводит к привязке точки к дороге, ближайшей к этим координатам. Это может быть не дорога, которая быстро или безопасно приведет к месту назначения, и она может находиться не рядом с точкой доступа к объекту. Кроме того, когда местоположение подвергается обратному геокодированию, нет никакой гарантии, что возвращаемый адрес будет соответствовать оригиналу.

PlusCode

Плюс-код, соответствующий location .

Viewport

Границы геокодированного места.

float

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

string

PlaceID места, куда геокодируется этот ввод.

Дополнительную информацию об идентификаторах мест смотрите здесь .

string

Тип(ы) места, к которому геокодированы входные данные. Например, ['locality', 'political'] . Полный список типов можно найти здесь .

bool

Предварительная версия: возврат адреса google.maps.addressvalidation.v1.Address на английском языке. Подробности см. google.maps.addressvalidation.v1.ValidationResult.english_latin_address .

string

Глобальный (полный) код места, например «9FWM33GV+HQ», представляющий площадь 1/8000 на 1/8000 градусов (~ 14 на 14 метров).

string

Составной код места, например «33GV+HQ, Рамберг, Норвегия», содержащий суффикс глобального кода и заменяющий префикс форматированным именем ссылочного объекта.

ValidationConclusion

Необходимый. Результат последовательности попыток проверки.

Если для этого поля установлено значение VALIDATION_CONCLUSION_UNSPECIFIED , будет возвращена ошибка INVALID_ARGUMENT .

string

Необходимый. Идентификатор ответа, для которого предназначен этот отзыв. Это должен быть [response_id][google.maps.addressvalidation.v1.ValidateAddressRequest.response_id] из первого ответа в серии попыток проверки адреса.

string

Первая адресная строка.

string

Название фирмы.

string

Вторая адресная строка.

string

Название урбанизации Пуэрто-Рико.

string

Город + штат + почтовый индекс.

string

Название города.

string

Двухбуквенный код штата.

string

Почтовый индекс, например, 10009.

string

Расширение почтового индекса из 4 цифр, например 5023.

UspsAddress

Стандартизированный адрес USPS.

string

2-значный код пункта доставки

string

Контрольная цифра пункта доставки. Этот номер добавляется в конец Delivery_point_barcode для механически сканированной почты. Сложение всех цифр Delivery_point_barcode, Delivery_point_check_digit, почтового индекса и ZIP+4 вместе должно дать число, кратное 10.

string

Возможные значения для подтверждения DPV. Возвращает один символ или не возвращает никакого значения.

• N : информация о первичном и дополнительном номере не была подтверждена DPV.
• D : Адрес был подтвержден DPV только для основного номера, а информация о дополнительном номере отсутствовала.
• S : Адрес был подтвержден DPV только для основного номера, а информация о дополнительном номере присутствовала, но не была подтверждена.
• Y : Адрес был подтвержден DPV для основных и дополнительных номеров.
• Пусто: если ответ не содержит значения dpv_confirmation , адрес не был отправлен для подтверждения DPV.

string

Сноски к проверке точки доставки. Несколько сносок могут быть объединены в одну строку.

• AA : входной адрес соответствует файлу ZIP+4.
• A1 : Входной адрес не соответствует файлу ZIP+4.
• BB : соответствует DPV (все компоненты).
• CC : Вторичный номер не совпадает и не требуется.
• C1 : Вторичный номер не совпадает, но требуется.
• N1 : В адресе высотного здания отсутствует дополнительный номер.
• M1 : отсутствует основной номер.
• M3 : Основной номер недействителен.
• P1 : отсутствует номер ящика PO, RR или HC адреса ввода.
• P3 : Входной адрес PO, RR или HC Номер ящика недействителен.
• F1 : Входной адрес соответствует военному адресу.
• G1 : Входной адрес соответствует общему адресу доставки.
• U1 : Входной адрес соответствует уникальному почтовому индексу.
• PB : Входной адрес соответствует записи PBSA.
• RR : адрес, подтвержденный DPV, с информацией PMB.
• R1 : адрес, подтвержденный DPV, без информации PMB.
• R7 : запись маршрута несущей R777 или R779.
• IA : Информированный адрес определен
• TA : основной номер, сопоставленный с отбрасыванием завершающей альфа.

string

Указывает, является ли адрес CMRA (Коммерческое агентство по приему почты) — частной компанией, получающей почту для клиентов. Возвращает один символ.

• Y : адрес является CMRA.
• N : адрес не является CMRA.

string

Это место свободно? Возвращает один символ.

• Y : адрес свободен.
• N : Адрес не свободен.

string

Это адрес без статистики или активный адрес? Статистические адреса – это адреса, которые не заняты постоянно, или адреса, которые USPS не обслуживает. Возвращает один символ.

• Y : адрес не активен
• N : адрес активен.

int32

Указывает тип NoStat. Возвращает код причины в виде int.

• 1 : IDA (внутренний адрес пересылки) — адреса, которые не получают почту напрямую от USPS, но доставляются на адрес пересылки, который их обслуживает.
• 2 : CDS — адреса, которые еще не доставлены. Например, новый микрорайон, в котором лоты и первичные номера определены, но структуры по заселению пока нет.
• 3 : Коллизия — адреса, которые фактически не подтверждаются DPV.
• 4 : CMZ (для колледжей, военных и других типов) — ZIP + 4 записи, включенные USPS в данные.
• 5 : Обычный — указывает на адреса, которые не получают доставку, и адреса не учитываются как возможные доставки.
• 6 : Требуется вторичная информация. Для адреса требуется вторичная информация.

string

Флаг указывает, что почта доставляется к одному получателю на сайте. Возвращает один символ.

• Y : почта доставляется к одному получателю на объекте.
• N : Почта не доставляется ни одному получателю на объекте.

string

Указывает, что почта не доставляется по указанному адресу. Возвращает один символ.

• Y : Почта не доставляется по указанному адресу.
• N : Почта доставляется по указанному адресу.

string

Флаг указывает, что доставка почты осуществляется не каждый день недели. Возвращает один символ.

• Y : Доставка почты осуществляется не каждый день недели.
• N : Нет указания, что доставка почты осуществляется не каждый день недели.

int32

Целое число, обозначающее дни недоставки. Его можно запросить с помощью битовых флагов: 0x40 – воскресенье – день недоставки 0x20 – понедельник – день недоставки 0x10 – вторник – день недоставки 0x08 – среда – день недоставки 0x04 – четверг – день недоставки -день доставки 0x02 – пятница – нерабочий день 0x01 – суббота – недоставочный день

string

Флаг указывает на то, что дверь доступна, но посылка не будет оставлена ​​из соображений безопасности. Возвращает один символ.

• Y : Посылка не будет оставлена ​​из соображений безопасности.
• N : Нет никаких указаний на то, что посылка не будет оставлена ​​из соображений безопасности.

string

Указывает, что адрес соответствует записи PBSA. Возвращает один символ.

• Y : адрес соответствует записи PBSA.
• N : адрес не соответствует записи PBSA.

string

Флаг указывает адреса, по которым USPS не может постучать в дверь для доставки почты. Возвращает один символ.

• Y : Дверь недоступна.
• N : Нет указания на то, что дверь недоступна.

string

Указывает, что для адреса допустимо более одного кода возврата DPV. Возвращает один символ.

• Y : Адрес был подтвержден DPV для основных и дополнительных номеров.
• N : информация о первичном и дополнительном номере не была подтверждена DPV.
• S : Адрес был подтвержден DPV только для основного номера, а информация о дополнительном номере присутствовала, но не была подтверждена, или одна конечная буква в основном номере была удалена, чтобы обеспечить совпадение DPV и необходимость вторичной информации.
• D : Адрес был подтвержден DPV только для основного номера, а информация о дополнительном номере отсутствовала.
• R : Адрес подтвержден, но назначен фантомному маршруту R777 и R779, доставка USPS не осуществляется.

string

Код маршрута перевозчика. Четырехзначный код, состоящий из однобуквенного префикса и трехзначного обозначения маршрута.

Префиксы:

• C : Маршрут перевозчика (или городской маршрут)
• R : Сельский маршрут
• H : Контрактный маршрут шоссе
• B : Секция почтового ящика
• G : Общая единица поставки

string

Индикатор сортировки тарифов маршрута оператора связи.

bool

Адрес доставки сопоставляется, но файл EWS указывает, что точное совпадение скоро будет доступно.

string

Главпочтамт города.

string

Состояние Главпочтамта.

string

Сокращенный город.

string

Код страны ФИПС.

string

Название округа.

string

Номер расширенной линии путешествия (eLOT).

string

eLOT восходящий/нисходящий флаг (A/D).

string

Код возврата LACSLink.

string

Индикатор LACSLink.

bool

Почтовый ящик только почтовый индекс.

string

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

• A : Соответствие записей SuiteLink, улучшен адрес компании.
• 00 : Нет совпадений, адрес компании не улучшен.

string

Обозначение единицы PMB (частный почтовый ящик).

string

номер PMB (личного почтового ящика);

string

Тип записи адреса, соответствующий входному адресу.

• F : ФИРМ. Это соответствие фирменной записи, которая является наивысшим уровнем соответствия, доступным для адреса.
• G : ОБЩАЯ ДОСТАВКА. Это соответствует записи общей доставки.
• H : ЗДАНИЕ/КВАРТИРА. Это соответствие записи здания или квартиры.
• P : ПОЧТОВЫЙ ЯЩИК. Это соответствует почтовому ящику.
• R : СЕЛЬСКИЙ МАРШРУТ или ДОГОВОР НА ШОССЕ: это соответствует записи либо Сельского маршрута, либо записи Контракта на автомагистраль, обе из которых могут иметь связанные диапазоны номеров ящиков.
• S : ЗАПИСЬ УЛИЦ: Это соответствие записи улицы, содержащей действительный диапазон основных номеров.

bool

Индикатор того, что найден адрес по умолчанию, но существуют более конкретные адреса.

string

Сообщение об ошибке при получении данных USPS. Он заполняется, когда обработка USPS приостанавливается из-за обнаружения искусственно созданных адресов.

При наличии этой ошибки поля данных USPS могут быть не заполнены.

bool

Индикатор того, что запрос CASS обработан.

PostalAddress

Необходимый. Адрес проверяется. Неформатированные адреса следует отправлять через address_lines .

Общая длина полей в этом вводе не должна превышать 280 символов.

Поддерживаемые регионы можно найти здесь .

Значение language_code во входном адресе зарезервировано для будущего использования и сегодня игнорируется. Результат проверки адреса будет заполнен на основе предпочтительного языка для данного адреса, определенного системой.

API проверки адреса игнорирует значения recipients и organization . Любые значения в этих полях будут отброшены и не возвращены. Пожалуйста, не устанавливайте их.

string

Это поле должно быть пустым для первого запроса на проверку адреса. Если для полной проверки одного адреса необходимо больше запросов (например, если изменения, внесенные пользователем после первоначальной проверки, необходимо повторно проверить), то каждый последующий запрос должен заполнить это поле с помощью response_id из самого первого ответа в последовательность проверки.

bool

Включает режим совместимости с USPS CASS. Это влияет только на поле google.maps.addressvalidation.v1.ValidationResult.usps_data в google.maps.addressvalidation.v1.ValidationResult . Примечание. Для запросов адресов в Пуэрто-Рико с поддержкой USPS CASS google.type.PostalAddress.region_code address должен быть указан как «PR», или google.type.PostalAddress.administrative_area address должен быть указан как «Puerto». Рико» (без учета регистра) или «PR».

Рекомендуется использовать компонентный address или указать как минимум две строки google.type.PostalAddress.address_lines , где первая строка содержит номер улицы и название, а вторая строка – город, штат и почтовый индекс.

LanguageOptions

Необязательный. Предварительная версия. Эта функция находится в предварительной версии (до GA). Продукты и функции Pre-GA могут иметь ограниченную поддержку, а изменения в продуктах и ​​функциях Pre-GA могут быть несовместимы с другими версиями Pre-GA. На предложения Pre-GA распространяются Особые условия обслуживания платформы Google Maps . Дополнительную информацию см. в описании этапов запуска .

Позволяет API проверки адреса включать дополнительную информацию в ответ.

string

Необязательный. Строка, которая идентифицирует сеанс автозаполнения для целей выставления счетов. Должна быть строкой в ​​формате Base64, безопасной для URL и имени файла, длиной не более 36 символов ASCII. В противном случае возвращается ошибка INVALID_ARGUMENT.

Сеанс начинается, когда пользователь выполняет запрос автозаполнения, и завершается, когда он выбирает место и вызывает функцию «Подробности о месте» или «Проверка адреса». В каждом сеансе может быть несколько запросов автозаполнения, за которыми следует один запрос сведений о месте или проверки адреса. Учетные данные, используемые для каждого запроса в рамках сеанса, должны принадлежать одному и тому же проекту Google Cloud Console. После завершения сеанса токен больше не действителен; ваше приложение должно генерировать новый токен для каждого сеанса. Если параметр sessionToken опущен или если вы повторно используете токен сеанса, сеанс взимается так, как если бы токен сеанса не был предоставлен (каждый запрос оплачивается отдельно).

Примечание. Проверка адреса может использоваться только в сеансах с API автозаполнения (нового), а не с API автозаполнения. Дополнительную информацию см. на странице https://developers.google.com/maps/documentation/places/web-service/session-pricing .

ValidationResult

Результат проверки адреса.

string

UUID, идентифицирующий этот ответ. Если адрес необходимо повторно проверить, этот UUID должен сопровождать новый запрос.

Verdict

Общие флаги вердикта

Address

Информация о самом адресе в отличие от геокода.

Geocode

Информация о местоположении и месте, к которому геокодирован адрес.

AddressMetadata

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

UspsData

Дополнительные флаги доставки, предоставляемые USPS. Предоставляется только в регионе US и PR .

Address

Предварительная версия. Эта функция находится в предварительной версии (до GA). Продукты и функции Pre-GA могут иметь ограниченную поддержку, а изменения в продуктах и ​​функциях Pre-GA могут быть несовместимы с другими версиями Pre-GA. На предложения Pre-GA распространяются Особые условия обслуживания платформы Google Maps . Дополнительную информацию см. в описании этапов запуска .

Адрес переведен на английский.

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

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

Включите этот вывод, используя флаг google.maps.addressvalidation.v1.LanguageOptions.return_english_latin_address .

Примечание. Поле google.maps.addressvalidation.v1.Address.unconfirmed_component_types в english_latin_address и поля google.maps.addressvalidation.v1.AddressComponent.confirmation_level в english_latin_address.address_components не заполняются.

Granularity

Детализация входного адреса. Это результат анализа входного адреса, который не дает никаких сигналов проверки. Сигналы проверки см. в разделе validation_granularity ниже.

Например, если входной адрес включает конкретный номер квартиры, то input_granularity здесь будет SUB_PREMISE . Если мы не можем сопоставить номер квартиры в базах данных или номер квартиры недействителен, то validation_granularity , скорее всего, будет PREMISE или ниже.

Granularity

Уровень детализации, на котором API может полностью проверить адрес. Например, validation_granularity PREMISE указывает, что все компоненты адреса на уровне PREMISE или более грубом уровне могут быть проверены.

Результат проверки компонента адреса можно найти в google.maps.addressvalidation.v1.Address.address_components .

Granularity

Информация о детализации geocode . Это можно понимать как семантическое значение того, насколько грубым или точным является геокодированное местоположение.

Иногда это может отличаться от приведенного выше validation_granularity . Например, наша база данных может фиксировать наличие номера квартиры, но не иметь точного местоположения квартиры в большом жилом комплексе. В этом случае validation_granularity будет SUB_PREMISE , а geocode_granularity будет PREMISE .

bool

Адрес считается полным, если нет неразрешенных токенов, неожиданных или отсутствующих компонентов адреса. Если значение не установлено, это указывает на то, что значение равно false . Дополнительные сведения см. в missing_component_types , unresolved_tokens или unexpected поля.

bool

По крайней мере один компонент адреса не может быть классифицирован или проверен. Подробности см. google.maps.addressvalidation.v1.Address.address_components .

bool

Был выведен (добавлен) по крайней мере один компонент адреса, которого не было во входных данных. Подробности см. google.maps.addressvalidation.v1.Address.address_components .

bool

По крайней мере один компонент адреса был заменен. Подробности см. google.maps.addressvalidation.v1.Address.address_components .

string

Адрес после постобработки, отформатированный как однострочный адрес в соответствии с правилами форматирования адреса региона, в котором расположен адрес.

PostalAddress

Адрес после обработки, представленный как почтовый адрес.

AddressComponent

Неупорядоченный список. Отдельные компоненты адреса отформатированного и исправленного адреса, а также информация проверки. Это предоставляет информацию о статусе проверки отдельных компонентов.

Компоненты адреса не упорядочены определенным образом. Не делайте никаких предположений относительно порядка компонентов адреса в списке.

string

Типы компонентов, которые должны были присутствовать в правильно отформатированном почтовом адресе, но не были найдены во входных данных И не могли быть определены. Компоненты этого типа отсутствуют в formatted_address , postal_address или address_components . Примером может быть ['street_number', 'route'] для ввода типа «Боулдер, Колорадо, 80301, США». Список возможных типов можно найти здесь .

string

Типы компонентов, которые присутствуют в address_components , но их правильность не подтверждена. Это поле предоставлено для удобства: его содержимое эквивалентно перебору address_components для поиска типов всех компонентов, у которых confirmation_level не CONFIRMED или inferred флаг не установлен в true . Список возможных типов можно найти здесь .

string

Любые токены во входных данных, которые не удалось разрешить. Это может быть ввод, который не был распознан как допустимая часть адреса (например, при вводе типа «123235253253 Main St, San Francisco, CA, 94105» неразрешенные токены могут выглядеть как ["123235253253"] поскольку это не так. не похож на действительный номер улицы.

ComponentName

Имя этого компонента.

string

Тип компонента адреса. Список возможных типов см. в Таблице 2: Дополнительные типы, возвращаемые службой Places .

ConfirmationLevel

Указывает уровень нашей уверенности в том, что компонент правильный.

bool

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

bool

Указывает на исправление ошибки в названии компонента. API не всегда отмечает изменения одного варианта написания на другой, например, при изменении «центра» на «центр». Он также не всегда отмечает распространенные орфографические ошибки, например, при замене «Амфитеатр Пкви» на «Амфитеатр Пкви».

bool

Указывает, что имя компонента было заменено совершенно другим, например, неправильный почтовый индекс был заменен на правильный для адреса. Это не косметическое изменение, входной компонент изменен на другой.

bool

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

bool

Указывает, что это адрес компании. Если значение не установлено, это означает, что значение неизвестно.

bool

Указывает, что это адрес почтового ящика. Если значение не установлено, это означает, что значение неизвестно.

bool

Указывает, что это адрес проживания. Если значение не установлено, это означает, что значение неизвестно.

string

Текст имени. Например, «5th Avenue» для названия улицы или «1253» для номера улицы.

string

Код языка BCP-47. Этого не будет, если имя компонента не связано с языком, например, с номером улицы.

LatLng

Геокодированное местоположение входных данных.

Использование идентификаторов мест предпочтительнее использования адресов, координат широты/долготы или плюсовых кодов. Использование координат при маршрутизации или расчете направлений движения всегда приводит к привязке точки к дороге, ближайшей к этим координатам. Это может быть не дорога, которая быстро или безопасно приведет к месту назначения, и она может находиться не рядом с точкой доступа к объекту. Кроме того, когда местоположение подвергается обратному геокодированию, нет никакой гарантии, что возвращаемый адрес будет соответствовать оригиналу.

PlusCode

Плюс-код, соответствующий location .

Viewport

Границы геокодированного места.

float

Размер геокодированного места в метрах. Это еще одна мера грубости геокодированного местоположения, но в физическом размере, а не в семантическом значении.

string

Плосеид этого места в этом входном геокоде.

Для получения дополнительной информации о идентификаторах места см. Здесь .

string

Тип (ы) места, которое входные геокодировали. Например, ['locality', 'political'] . Полный список типов можно найти здесь .

bool

Предварительный просмотр: вернуть google.maps.addressvalidation.v1.Address на английском языке. См. google.maps.addressvalidation.v1.ValidationResult.english_latin_address для деталей.

string

Глобальный (полный) код Place, такой как «9FWM33GV+HQ», представляющий площадь 1/8000 на 1/8000 градусов (~ 14 на 14 метров).

string

Составной код Place, такой как «33GV+HQ, Ramberg, Norway», содержащий суффикс глобального кода и замена префикса с форматированным именем эталонной объекта.

ValidationConclusion

Необходимый. Результат последовательности попыток проверки.

Если это поле установлено на VALIDATION_CONCLUSION_UNSPECIFIED , будет возвращена ошибка INVALID_ARGUMENT .

string

Необходимый. Идентификатор ответа, для которого предназначен этот отзыв. Это должно быть [response_id] [google.maps.addressvalidation.v1.validateaddressrequest.response_id] из первого ответа в серии попыток проверки адреса.

string

Первая адресная строка.

string

Название фирмы.

string

Вторая адресная строка.

string

Пуэрториканское имя урбанизации.

string

Город + государство + почтовый код.

string

Название города.

string

2 буквенного состояния код.

string

Почтовый код, например, 10009.

string

4-значное расширение почтового кода, например, 5023.

UspsAddress

USPS стандартизированный адрес.

string

2 -значный код точки доставки

string

Цифровая цифра с доставкой. Этот номер добавляется к окончанию доставки_POINT_BARCODE для механического сканируемого почты. Добавление всех цифр доставки_point_barcode, Deliver_point_check_digit, почтовый код и Zip+4 вместе должны дать число делится на 10.

string

Возможные значения для подтверждения DPV. Возвращает один символ или не возвращает значения.

• N : Первичная и любая информация о вторичном номере не удалось подтвердить DPV.
• D : адрес был подтвержден DPV только для первичного номера, а информация о вторичном номере отсутствовала.
• S : Адрес был подтвержден DPV только для первичного номера, а информация о вторичном номере присутствовала, но не подтверждена.
• Y : Адрес был подтвержден DPV для первичных и любых вторичных чисел.
• Пусто: если ответ не содержит значения dpv_confirmation , адрес не был представлен для подтверждения DPV.

string

Сноски от проверки точки доставки. Несколько сносков могут быть связаны вместе в одной струне.

• AA : входной адрес, соответствующий файлу Zip+4
• A1 : Входной адрес не был сопоставлен с файлом ZIP+4
• BB : соответствует DPV (все компоненты)
• CC : вторичное число не соответствует и не требуется
• C1 : вторичное число не соответствует, но требуется
• N1 : Высотный адрес отсутствует вторичный номер
• M1 : Отсутствие первичного номера отсутствует
• M3 : первичный номер недействителен
• P1 : входной адрес PO, RR или HC -номер.
• P3 : входной адрес PO, RR или HC Numm
• F1 : входной адрес, соответствующий военному адресу
• G1 : входной адрес, соответствующий общему адресу доставки
• U1 : входной адрес, сопоставленный с уникальным почтовым индексом
• PB : входной адрес, сопоставленный с записи PBSA
• RR : DPV подтвержденный адрес с информацией PMB
• R1 : DPV подтвержденный адрес без информации PMB
• R7 : raintrier route R777 или R779
• IA : информированный адрес выявлено
• TA : Первичный номер, сопоставленный путем сброса зацепленной альфа

string

Указывает, является ли адрес CMRA (агентство по получению коммерческой почты)-частное бизнес, получающий почту для клиентов. Возвращает одного персонажа.

• Y : Адрес - CMRA
• N : Адрес не CMRA

string

Это место свободным? Возвращает одного персонажа.

• Y : адрес вакантный
• N : адрес не вакантный

string

Это адрес без статистики или активный адрес? Никакие адреса статистики не являются те, которые не постоянно заняты или адреса, которые USP не обслуживают. Возвращает одного персонажа.

• Y : Адрес не активен
• N : Адрес активен

int32

Указывает тип ностата. Возвращает код причины как int.

• 1 : IDA (внутренний адрес падения) - адреса, которые не получают почту непосредственно от USPS, но доставляются по адресу Drop, который их обслуживает.
• 2 : CDS - адреса, которые еще не стали результатом. Например, новое подразделение, в котором были определены лоты и первичные числа, но структура пока не существует для занятости.
• 3 : столкновение - адреса, которые на самом деле не подтверждают DPV.
• 4 : CMZ (колледж, военные и другие типы) - ZIP + 4 Records USPS включил в данные.
• 5 : Регулярно - указывает на адреса, не получающие доставки, а адреса не подсчитываются в качестве возможных поставки.
• 6 : Вторичное требуется - адрес требует вторичной информации.

string

Флаг указывает, что почта доставляется в один восприимчивый на сайте. Возвращает одного персонажа.

• Y : Почта доставляется в один восприимчивый на сайте.
• N : почта не доставляется ни одному восприимчивому на сайте.

string

Указывает, что почта не доставляется по адресу улицы. Возвращает одного персонажа.

• Y : Почта не доставлена ​​по адресу улицы.
• N : Почта доставляется по адресу улицы.

string

Флаг указывает, что доставка почты не выполняется каждый день недели. Возвращает одного персонажа.

• Y : Доставка почты не выполняется каждый день недели.
• N : нет указания, что доставка почты не выполняется каждый день недели.

int32

Целое число идентифицирует дни без доставки. Его можно допросить с использованием битовых флагов: 0x40-воскресенье-день без доставки 0x20-понедельник-день без доставки 0x10-вторник-день без доставки 0x08-среда-день без доставки 0x04-четверг не является нон. -Длевина День 0x02-пятница-день без доставки 0x01-Суббота-день без доставки

string

Флаг указывает, что дверь доступна, но пакет не останется из -за проблем безопасности. Возвращает одного персонажа.

• Y : Пакет не останется из -за проблем безопасности.
• N : нет указания, что пакет не останется из -за проблем безопасности.

string

Указывает, что адрес был сопоставлен с записью PBSA. Возвращает одного персонажа.

• Y : Адрес был сопоставлен с записью PBSA.
• N : Адрес не был сопоставлен с записью PBSA.

string

Флаг указывает адреса, где USPS не может постучать в дверь для доставки почты. Возвращает одного персонажа.

• Y : Дверь недоступна.
• N : нет указания, что дверь недоступна.

string

Указывает, что для адреса действительнее более одного кода возврата DPV. Возвращает одного персонажа.

• Y : Адрес был подтвержден DPV для первичных и любых вторичных чисел.
• N : Первичная и любая информация о вторичном номере не удалось подтвердить DPV.
• S : Адрес был подтвержден DPV только для первичного номера, а информация о вторичном номере присутствовала, но не подтверждена, или единственная альфа -альфа по первичному номеру была отброшена, чтобы сделать матч DPV и необходимую вторичную информацию.
• D : адрес был подтвержден DPV только для первичного номера, а информация о вторичном номере отсутствовала.
• R : Адрес подтвержден, но назначен на Phantom Route R777 и R779 и доставка USPS не предоставлен.

string

Код маршрута перевозчика. Четыре кода символа, состоящий из префикса одной буквы и трехзначного обозначения маршрута.

Префиксы:

• C : маршрут перевозчика (или городской маршрут)
• R : сельский маршрут
• H : Контрактный маршрут шоссе
• B : раздел «почтовый офис»
• G : Общая единица доставки

string

Индикатор сортировки скорости маршрута перевозчика.

bool

Адрес доставки подходит, но файл EWS указывает, что в ближайшее время будет доступно точное совпадение.

string

Главное почтовое отделение города.

string

Основное государство почтового отделения.

string

Сокращенный город.

string

Кодекс округа Фипс.

string

Имя округа.

string

Усовершенствованная линия путешествия (ELOT).

string

ЭКОЛОТ АНЦИПАНСКИЙ/УГОДНЫЙ ФЛАГ (A/D).

string

Код возврата lacslink.

string

Индикатор LACSLINK.

bool

Ящик для почтового ящика.

string

Сноски от сопоставления уличной или высокой записи с информацией. Если сопоставление названия бизнеса найдено, второстепенное число возвращается.

• A : SuiteLink Record Match, бизнес -адрес улучшен.
• 00 : нет матча, бизнес -адрес не улучшен.

string

PMB (Private Mail Box) Устройство устройства.

string

PMB (частный почтовый ящик) номер;

string

Тип адресной записи, которая соответствует входному адресу.

• F : фирма. Это совпадение с твердой записью, которая является лучшим уровнем совпадения, доступным для адреса.
• G : Общая доставка. Это совпадение с общей записью доставки.
• H : Здание / Квартира. Это матч с зданием или квартирой.
• P : почтовое ящик. Это совпадение с почтовым ящиком.
• R : сельский маршрут или контракт на шоссе: это совпадает либо с сельским маршрутом, либо с контрактной записью на шоссе, оба из которых могут иметь ассоциированные диапазоны номера коробки.
• S : Street Record: это совпадение с уличной записью, содержащей действительный диапазон первичных номеров.

bool

Индикатор того, что адрес по умолчанию был найден, но существуют более конкретные адреса.

string

Сообщение об ошибке для поиска данных USPS. Это заполнено, когда обработка USPS приостановлена ​​из -за обнаружения искусственно созданных адресов.

Поля данных USPS не могут быть заполнены, когда присутствует эта ошибка.

bool

Индикатор того, что запрос был обработан CASS.

PostalAddress

Необходимый. Адрес подтвержден. Неформатированные адреса должны быть отправлены через address_lines .

Общая длина полей на этом входе не должна превышать 280 символов.

Поддерживаемые регионы можно найти здесь .

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

API проверки адреса игнорирует значения у recipients и organization . Любые значения в этих областях будут отброшены и не возвращены. Пожалуйста, не устанавливайте их.

string

Это поле должно быть пустым для первого запроса проверки адреса. Если необходимо больше запросов для полной проверки одного адреса (например, если изменения, response_id пользователь вносит после начальной проверки последовательность проверки.

bool

Включает USPS CASS -совместимый режим. Это влияет только на google.maps.addressvalidation.v1.ValidationResult.usps_data google.maps.addressvalidation.v1.ValidationResult . ПРИМЕЧАНИЕ. Для USPS CASS включенные запросы на адреса в Пуэрто -Рико, google.type.PostalAddress.region_code address должен быть предоставлен как «pr» или google.type.PostalAddress.administrative_area address должен быть предоставлен как "puerto. RICO "(CASE нечувствительный) или" PR ".

Рекомендуется использовать компонентный address или альтернативно указать как минимум два google.type.PostalAddress.address_lines , где первая строка содержит номер улицы и имя, а вторая строка содержит город, штат и почтовый индекс.

LanguageOptions

Необязательный. Предварительный просмотр: эта функция находится в предварительном просмотре (Pre-GA). Продукты и функции Pre-GA могут иметь ограниченную поддержку, а изменения в продуктах и ​​функциях Pre-GA могут быть совместимы с другими версиями до GA. Предложения предварительного GA охватываются специфическими условиями службы платформы Google Maps . Для получения дополнительной информации см. Описания этапа запуска .

Позволяет API проверки адреса включить дополнительную информацию в ответ.

string

Необязательный. Строка, которая идентифицирует сеанс автозаполнения для выставления счетов. Должен быть url и имен файла безопасной базовой 64 строки с максимум 36 символов ASCII в длину. В противном случае возвращается ошибка valud_argument.

Сеанс начинается, когда пользователь делает автозаполненный запрос, и завершается, когда он выбирает место, и вызов для размещения данных или проверки адреса. Каждый сеанс может иметь несколько автозаполненных запросов, за которыми следуют сведения об одном месте или запрос на проверку адреса. Учетные данные, используемые для каждого запроса в сеансе, должны принадлежать к одному и тому же проекту Cloud Console Google. Как только сессия завершится, токен больше не является действительным; Ваше приложение должно генерировать свежий токен для каждого сеанса. Если параметр sessionToken опущен, или если вы повторно используете токен сеанса, сеанс взимается так, как если бы токен сеанса не был предоставлен (каждый запрос выставлен отдельно).

ПРИМЕЧАНИЕ. Проверка адреса может использоваться только в сеансах с API автозаполнения (нового), а не API автозаполнения. См .

ValidationResult

Результат проверки адреса.

string

UUID, который идентифицирует этот ответ. Если адрес должен быть повторно оценен, этот UUID должен сопровождать новый запрос.

Verdict

Общие флаги вердикта

Address

Информация об самом адресе, в отличие от геокода.

Geocode

Информация о местоположении и размещении, к которому адресовал адрес.

AddressMetadata

Другая информация, относящаяся к доставке. metadata не гарантированно будут полностью заполнены для каждого адреса, отправленного в API проверки адреса.

UspsData

Дополнительные флаги доставки, предоставленные USPS. Предоставлено только в регионе US и PR .

Address

Предварительный просмотр: эта функция находится в предварительном просмотре (Pre-GA). Продукты и функции Pre-GA могут иметь ограниченную поддержку, а изменения в продуктах и ​​функциях Pre-GA могут быть совместимы с другими версиями до GA. Предложения предварительного GA охватываются специфическими условиями службы платформы Google Maps . Для получения дополнительной информации см. Описания этапа запуска .

Адрес переведен на английский.

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

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

Включите этот вывод, используя google.maps.addressvalidation.v1.LanguageOptions.return_english_latin_address .

Примечание. Поле google.maps.addressvalidation.v1.Address.unconfirmed_component_types в english_latin_address и google.maps.addressvalidation.v1.AddressComponent.confirmation_level Fields в english_latin_address.address_components .

Granularity

Гранулярность входного адреса. Это результат анализа входного адреса и не дает никаких сигналов валидации. Для сигналов проверки см. В соответствии с validation_granularity ниже.

Например, если входной адрес включает в себя конкретный номер квартиры, то input_granularity здесь будет SUB_PREMISE . Если мы не можем сопоставить номер квартиры в базах данных, или номер квартиры недействителен, validation_granularity , вероятно, будет PREMISE или ниже.

Granularity

Уровень детализации, на который API может полностью подтвердить адрес. Например, validation_granularity PREMISE указывает на все компоненты адреса на уровне PREMISE или более грубых.

Результат проверки компонента адреса можно найти в google.maps.addressvalidation.v1.Address.address_components .

Granularity

Информация о гранулярности geocode . Это можно понимать как семантическое значение того, насколько грубо или прекрасно находится геокодированное местоположение.

Это может отличаться от validation_granularity . Например, наша база данных может зафиксировать существование номера квартиры, но не имеет точного места для квартиры в большом квартире. В этом случае validation_granularity будет SUB_PREMISE но geocode_granularity будет PREMISE .

bool

Адрес считается завершенным, если нет неразрешенных токенов, нет неожиданных компонентов или недостающих адресов. Если нет, указывает, что значение false . См. missing_component_types , unresolved_tokens или unexpected поля для получения более подробной информации.

bool

По крайней мере, один компонент адреса не может быть классифицирован или проверен, см. google.maps.addressvalidation.v1.Address.address_components для получения подробной информации.

bool

По крайней мере, один компонент адреса был выведен (добавлен), который не был в вводе, см. google.maps.addressvalidation.v1.Address.address_components для подробностей.

bool

По крайней мере, один компонент адреса был заменен, см. google.maps.addressvalidation.v1.Address.address_components для получения подробной информации.