此页面由 Cloud Translation API 翻译。

将地址转换为英语

使用 Address Validation API 时，您可以请求对该地址进行验证也会返回转换为英文的地址。请在以下情况下使用此功能：您的系统需要提供以英语为母语的地址信息字符。例如：

您的公司可能会满足世界各地的发货请求，并使用英文和英文拉丁字符，用于对所有地址进行标准化。
您的商家可能负责处理往返以下国家/地区的货物：与所提供地址的语言不同。

如何发回英语地址

如需请求使用包含的英文等效组件进行地址验证，请执行以下操作：将以下内容添加到验证请求正文：

languageOptions: { returnEnglishLatinAddress: "true" }.

以下示例在验证普拉多博物馆的地址

curl -X POST -d '{
  "regionCode" : ["ES"],
  "addressLines": ["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 字段使用相同的地址 proto，但有以下例外情况：address

否 ConfirmationLevel 字段
否 unconfirmedComponentTypes 字段

。 <ph type="x-smartling-placeholder">

地址转换的运作方式

Address Validation API 会应用英文转换来对地址。这意味着，administrative_area、locality 和其他地址的各个组成部分都会被单独处理。请参阅 AddressComponent 。

下图展示了以英文表示的转换结果地址：Calledueñas, 5, 41003 Sevilla, España。

翻译的地址组成部分，包括“路线”、“国家/地区”和“市行政区”

对于评估为英文转换的每个组成部分，该服务会使用此过程。

尽可能使用全文翻译

某些地址组成部分可能有完整的翻译版本，可供使用。例如，西班牙语国家/地区 España 可以翻译成 Spain。在在这种情况下，该服务将使用英文版。这通常属于较大的地址组成部分，例如 country 和 administrative_area_level_1。

如果未提供英语版本，则使用当地语言的拉丁语拼音

拉丁化意味着将当地语言转换为拉丁文字来生成文本。

如果地址的本地语言使用拉丁字符但地址组成部分没有对应的英语版本，则服务用于替换当地语言中非英语的字符。例如，Calle Dueñas 会变为 Calle Duenas，其中 ñ 是替换为 n。
如果地址的当地语言没有以拉丁字母表示且不存在与地址组成部分对应的英文版本，服务使用当地语言的拉丁语版本（如果有）。例如，日语转换会返回日语的罗马拼音。所有非英语、非拉丁字符都会替换为英语字符拉丁字符。例如：“3 丁目”变为“3-chome”。
- 请注意，此预览尚不支持日语
如果没有该语言的拉丁化版本，这些组件并以当地语言返回。

替换非英文拉丁字符

所有非英文拉丁字符都会被替换为其英文字符对等项。例如，以下每个字符都将替换为字符“o”：动态 - 电话 - ???、??、??、??、??、????????????????????????????????例如：

Calle de Ruiz de Alarcón 将变成 Calle de Ruiz de Alarcon

地址转换示例

以下示例展示了 Palacio 请求返回的验证响应 de lasdueñas，其中englishLatinAddress以粗体显示。此请求使用了以下参数中 languageOptions 参数中的 returnEnglishLatinAddress 字段：输入。

"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 并不为 Preview 版本，功能，我们会将此类请求视为根据具体情况而定。

对于正式发布前的版本，请参阅以下建议：

正式发布前的功能不在 Google Maps Platform 服务等级协议 (SLA)。
使用后备机制，尤其是在您使用正式发布前功能。后备的一些示例包括超出配额、意外响应代码和延迟、或意外响应（与现有行为相比）。

您可以使用问题跟踪器请求新功能或提出修改建议现有功能。请务必在您的请求中提供以下信息：

说明您希望添加的具体功能或行为，以及并将其设为重要的原因
如果可以，请提供有关您的应用场景和新变化的具体细节可增加多少机会

如有任何反馈或有关功能的任何其他问题，请发送电子邮件至地址验证热线：address-validation-hotline@google.com。