Используя API проверки адресов, вы можете запросить, чтобы ответ проверки также возвращал адрес, преобразованный на английский язык. Используйте эту функцию, когда вашей системе необходимо предоставить адресную информацию латинскими буквами на английском языке при получении адреса, полученного не на английском языке. Например:
- Ваша компания может выполнять заказы на доставку со всего мира и использовать английские и основанные на английском языке латинские символы для стандартизации всех адресов.
- Ваша компания может заниматься доставкой грузов в страну и из страны, в которой используется язык, отличный от языка указанного адреса.
Как вернуть адрес на английском языке
Чтобы запросить проверку адреса с включенными эквивалентными компонентами на английском языке, добавьте в тело запроса на проверку следующее:
"languageOptions": { "returnEnglishLatinAddress": "true" }
В следующем примере запрашиваются компоненты на английском языке при проверке адреса музея Прадо:
curl -X POST -d '{
"address": {
"region_code" : "ES",
"address_lines": ["C. de Ruiz de Alarcón, 23, 28014 Madrid, Spain"],
},
"languageOptions": {returnEnglishLatinAddress: true}
}' \
-H 'Content-Type: application/json' \
-H 'X-Goog-Api-Key: API_KEY' \
'https://addressvalidation.googleapis.com/v1:validateAddress'
Ответ возвращает адрес на английском языке в поле englishLatinAddress . Подробнее см. пример преобразования адреса ниже. Каждый компонент возвращаемого адреса на локальном языке преобразуется в английский максимально точно. Преобразованный адрес не может быть повторно использован в качестве входных данных API.
Поле englishLatinAddress использует тот же прототип адреса , что и поле address , со следующими исключениями:
- Нет поля
ConfirmationLevel - Нет поля
unconfirmedComponentTypes
Улучшить качество преобразования японских адресов
При отправке японского адреса для преобразования в английский язык включите пробел или разделитель (например, «-») между следующими частями адреса:
- Номер здания (помещения) и название здания .
- Номер здания (помещения) и номер субпомещения/квартиры .
- Название здания и подпомещение .
Например:
- 東京都渋谷区渋谷 ３−２１−３ 渋谷ストリーム ５階 (рекомендуется)
- 東京都渋谷区渋谷３−２１−３渋谷ストリーム５階 (Не рекомендуется)
Примеры, когда название здания отсутствует:
- 東京都渋谷区渋谷３丁目２１−３ ５階 (рекомендуется)
- 東京都渋谷区渋谷３丁目２１−３−５階 (рекомендуется)
- 東京都渋谷区渋谷３丁目２１−３５階 (Не рекомендуется)
Как работает преобразование адресов
API проверки адресов применяет преобразование в английский язык к каждому компоненту адреса. Это означает, что administrative_area , locality и другие компоненты адреса обрабатываются индивидуально. Список компонентов адреса см. в разделе AddressComponent в справочной документации.
На следующей диаграмме показано, как будет выглядеть преобразование адреса Calle Dueñas, 5, 41003 Sevilla, España в английский язык.
Для каждого компонента, оцениваемого на предмет конвертации в английский язык, служба использует процесс, описанный в следующих разделах.
По возможности используйте полностью переведенный английский язык.
Некоторые компоненты адреса могут иметь полностью переведённую версию, доступную для использования. Например, название испанской страны España будет переведено как Spain . В этом случае сервис использует английскую версию. Это обычно относится к более крупным компонентам адреса, таким как country и administrative_area_level_1 .
Использует латинизацию местного языка, если английский недоступен.
Латинизация означает, что местный язык переводится на латинскую графику с помощью транскрипции.
- If the local language of the address uses a Latin character set, and no English equivalent exists for the address component, the service replaces characters from the local language that are not English-based. For example,
Calle DueñasbecomesCalle Duenas, where ñ is substituted with n. - Если в локальном языке адреса не используется латинский набор символов, и для компонента адреса не существует английского эквивалента, сервис использует латинизированную версию локального языка, если она доступна. Например, преобразование в японский язык возвращает романизацию японского языка. Все неанглийские и нелатинские символы заменяются латинскими символами на основе английского языка. Например, 3丁目 становится 3-тёмэ.
- Обратите внимание, что японский язык пока недоступен для предварительного просмотра.
- Если латинизированная версия языка недоступна, компоненты возвращаются на местном языке.
Заменяет латинские символы, отсутствующие в английском языке
Все латинские символы, не входящие в английский алфавит, заменяются их английскими эквивалентами. Например, каждый из следующих символов будет заменен символом «o»: ð, ò, ó, ô, õ, ö, ø, ō, ŏ, ő, ơ, ṍ, ṏ, ṑ, ṓ, ọ, ỏ, ố, ồ, ổ, ỗ, ộ, ớ, ờ, ở, ỡ и ợ. Например:
Калле де Руис де Аларкон становится улицей Руис де Аларкон.
Пример преобразования адреса
В следующем примере показан ответ на запрос о Дворце Паласио-де-лас-Дуэньяс в Испании, где адрес englishLatinAddress выделен жирным шрифтом. В этом запросе использовалось поле returnEnglishLatinAddress в параметре languageOptions входных данных.
"result": { "verdict": { "inputGranularity": "PREMISE", "validationGranularity": "PREMISE", "geocodeGranularity": "PREMISE", "addressComplete": true, "hasInferredComponents": true }, "address": { "formattedAddress": "Calle Dueñas, 5, 41003 Sevilla, España", "postalAddress": { "regionCode": "ES", "languageCode": "es", "postalCode": "41003", "administrativeArea": "Sevilla", "locality": "Sevilla", "addressLines": [ "C. Dueñas, 5" ] }, "addressComponents": [ { "componentName": { "text": "Calle Dueñas", "languageCode": "es" }, "componentType": "route", "confirmationLevel": "CONFIRMED" }, { "componentName": { "text": "5", "languageCode": "es" }, "componentType": "street_number", "confirmationLevel": "CONFIRMED" }, { "componentName": { "text": "41003" }, "componentType": "postal_code", "confirmationLevel": "CONFIRMED" }, { "componentName": { "text": "Sevilla", "languageCode": "es" }, "componentType": "locality", "confirmationLevel": "CONFIRMED" }, { "componentName": { "text": "España", "languageCode": "es" }, "componentType": "country", "confirmationLevel": "CONFIRMED" }, { "componentName": { "text": "Sevilla", "languageCode": "es" }, "componentType": "administrative_area_level_2", "confirmationLevel": "CONFIRMED", "inferred": true } ] }, "geocode": { "location": { "latitude": 37.394849, "longitude": -5.9893604 }, "plusCode": { "globalCode": "8C9P92V6+W7" }, "bounds": { "low": { "latitude": 37.3948098, "longitude": -5.9894249 }, "high": { "latitude": 37.3948882, "longitude": -5.9893025 } }, "featureSizeMeters": 7.174035, "placeId": "ChIJzRDYbgRsEg0RDDgHlF80UoI", "placeTypes": [ "premise" ] }, "metadata": { "business": true, "residential": false }, "englishLatinAddress": { "formattedAddress": "Calle Duenas, 5, 41003 Seville, Spain", "postalAddress": { "regionCode": "ES", "languageCode": "en", "postalCode": "41003", "administrativeArea": "Seville", "locality": "Seville", "addressLines": [ "C. Duenas, 5" ] }, "addressComponents": [ { "componentName": { "text": "Calle Duenas", "languageCode": "es" }, "componentType": "route", }, { "componentName": { "text": "5", "languageCode": "es" }, "componentType": "street_number", }, { "componentName": { "text": "41003" }, "componentType": "postal_code", }, { "componentName": { "text": "Seville", "languageCode": "en" }, "componentType": "locality", }, { "componentName": { "text": "Spain", "languageCode": "en" }, "componentType": "country", }, { "componentName": { "text": "Seville", "languageCode": "en" }, "componentType": "administrative_area_level_2", "inferred": true } ] } }, "responseId": "e874d263-7d0d-413f-9213-119a784765ed"
Варианты поддержки для предварительных версий
Хотя Google не предоставляет поддержку предварительных версий, функций или возможностей Сервисов, мы рассматриваем запросы на этих этапах разработки в индивидуальном порядке.
Используйте эти рекомендации для версий до GA:
На функции Pre-GA не распространяется соглашение об уровне обслуживания платформы Google Карт .
Используйте механизмы отката, особенно если вы используете функцию, не относящуюся к GA, в производственной среде. Примеры ситуаций отката: превышение квоты, непредвиденные коды ответов и задержка, а также непредвиденные ответы по сравнению с текущим поведением.
Вы можете использовать систему отслеживания проблем, чтобы запросить новые функции или предложить изменения к существующим. Обязательно укажите в запросе следующую информацию:
Опишите конкретную функцию или поведение, которые вы хотели бы добавить, а также причины, по которым вы считаете это важным.
Если возможно, включите конкретные сведения о вашем варианте использования и новых возможностях, которые предоставит эта функция.
Чтобы оставить отзыв или задать другие вопросы о функциях, отправьте электронное письмо на горячую линию проверки адресов: address-validation-hotline@google.com.