本頁面由 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敬上欄位

，瞭解如何調查及移除這項存取權。

地址轉換的運作方式

Address Validation API 將英文轉換為網址。這表示 administrative_area、locality 等地址的元件會個別處理。詳情請見 AddressComponent 。

下圖說明英文轉換的樣貌地址：Calle Rideñas, 5, 41003 Sevilla, España。

已翻譯的地址元件，包括路線、國家/地區和縣市

對於評估為英文轉換的每個元件，服務會使用程序。

盡可能使用完整翻譯的英文內容

某些地址元件可能提供完整翻譯版本，以供使用。舉例來說，España 的西班牙國家/地區會翻譯成Spain。於在此情況下，服務會使用英文版。這通常是因為以及大型地址元件，例如 country 和 administrative_area_level_1

在未提供英文的情況下，使用當地語言進行初始化

拉丁字母表示當地語言會轉換為拉丁字母使用語音轉錄功能

如果地址的當地語言使用拉丁字元且地址元件 (service) 沒有英文版的對等項目取代非英文字元的當地語言。舉例來說，Calle Dueñas 會變為 Calle Duenas，而 ñ 是替代為 n。
如果地址的當地語言不是使用拉丁語但地址元件中沒有對等的英文字元此服務會使用當地語言的拉丁版本 (如有)。例如，日文轉換會傳回日文的拼音。凡是非英文、非拉丁字母字元，都會替換為英文拉丁字元。例如：3 號星球會變成 3-chome。
- 請注意，預覽時尚未啟用日文
如果語言沒有中文版本，則元件為以當地語言傳回。

替換英文的拉丁字元

任何非英文的拉丁字元都會替換成英文字元。舉例來說，系統會將下列字元各替換成例如：

Rae de Ruiz de Alarcón 變成 Calle de Ruiz de Alarcon

地址轉換範例

以下範例顯示 Palacio 要求中的驗證回應西班牙的 de las Duetñ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 不會為預覽版本，「服務」的特色或功能，我們會考量這類要求依個案情況而定，建立開發階段。

針對正式發布前版本，請採用下列建議：

正式發布前的功能不在 Google 地圖平台服務水準協議。
建議您採用備用機制，特別是當您使用。備用範例包括配額超過配額、非預期的回應代碼和延遲時間或非預期的回應

您可以透過 Issue Tracker 要求新功能或提出修改建議現有功能請務必在要求中附上以下資訊：

請說明您希望新增的特定功能或行為，以及指出重要性
盡可能詳述您的用途和這項功能可以帶來哪些好處

如果對這項功能有任何意見，或有任何功能相關問題，請傳送電子郵件至地址驗證熱線：address-validation-hotline@google.com。