Эта страница переведена с помощью Cloud Translation API.

Преобразование адресов в английский язык

При использовании 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 , что и поле address , за исключением следующих случаев:

Поле ConfirmationLevel отсутствует
Поле unconfirmedComponentTypes отсутствует.

Улучшить качество преобразования японских адресов.

При переводе японского адреса на английский, между следующими частями адреса следует использовать пробел или разделитель (например, '-'):

Номер здания (помещения) и название здания .
Номер здания (помещения) и номер подпомещения/блока .
Название здания и его подобъект .

Например:

東京都渋谷区渋谷３−２１−３渋谷ストリーム５階 (рекомендуется)
東京都渋谷区渋谷３−２１−３渋谷ストリーム５階 (Не рекомендуется)

Примеры случаев, когда название здания отсутствует:

東京都渋谷区渋谷３丁目２１−３５階 (рекомендуется)
東京都渋谷区渋谷３丁目２１−３−５階 (рекомендуется)
東京都渋谷区渋谷３丁目２１−３５階 (Не рекомендуется)

Как работает преобразование адресов

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

Следующая диаграмма иллюстрирует, как будет выглядеть перевод адреса Calle Dueñas, 5, 41003 Sevilla, España на английский язык.

Переведены компоненты адреса, включая маршрут, страну и населенный пункт.

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

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

Для некоторых компонентов адреса может быть доступна полностью переведенная версия. Например, испанское название страны España будет переведено как Spain . В этом случае сервис использует английскую версию. Обычно это относится к более крупным компонентам адреса, таким как country и administrative_area_level_1 .

Использует латинизацию местного языка, если английский недоступен.

Латинизация означает преобразование местного языка в латинский алфавит с помощью транскрипции.

Если в адресе используется латинский алфавит, и для элемента адреса нет английского эквивалента, служба заменяет символы местного языка, не являющиеся английскими. Например, Calle Dueñas становится Calle Duenas , где ñ заменяется на n.
Если в локальном языке адреса не используется латинская кодировка, и для компонента адреса нет английского эквивалента, служба использует латинизированную версию локального языка, если таковая имеется. Например, при преобразовании с японского языка возвращается романизация слова «Japanese». Любые неанглийские символы, не являющиеся латинскими, заменяются английскими латинскими символами. Например: 3丁目 становится 3-chome.
- Обратите внимание, что японский язык пока недоступен в предварительной версии.
Если латинизированная версия языка недоступна, компоненты возвращаются на местном языке.

Заменяет латинские символы, отсутствующие в английском языке.

Любые латинские символы, не являющиеся английскими, заменяются их английскими эквивалентами. Например, каждый из следующих символов будет заменен символом «o»: ð, ò, ó, ô, õ, ö, ø, ō, ŏ, ő, ơ, ṍ, ṏ, ṑ, ṓ, ọ, ỏ, ố, ồ, ổ, ỗ, ộ, ớ, ờ, ở, ỡ и ợ. Например:

Калле де Руис де Аларкон становится улицей Руис де Аларкон.

Пример преобразования адреса

В следующем примере показан ответ на запрос проверки данных о Palacio de las Dueñas в Испании, где поле 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 не оказывает поддержку предварительным версиям, функциям или возможностям Сервисов, мы рассматриваем запросы на этих этапах разработки в индивидуальном порядке.

Для версий, предшествующих общедоступным, используйте следующие рекомендации:

Функции, доступные до официального запуска, не покрываются соглашением об уровне обслуживания платформы Google Maps .
Используйте механизмы резервного копирования, особенно если вы используете функцию, находящуюся на стадии предварительной разработки, в производственной среде. Примерами ситуаций, требующих резервного копирования, являются: превышение квоты, неожиданные коды ответов и задержка, или неожиданные ответы по сравнению с существующим поведением.

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

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

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