要求本地化值

歐洲經濟區 (EEA) 開發人員

本地化回應值是額外的回應欄位，可提供傳回參數值的本地化文字。系統會提供行程時間、距離和單位系統 (公制或英制) 的本地化文字。您可以使用欄位遮罩要求本地化值，並指定語言和單位系統，或使用 API 推斷的值。詳情請參閱「LocalizedValues」。

舉例來說，如果您指定德文 (de) 的語言代碼和英制單位，系統會提供 distanceMeters 值 49889.7，以及以德文和英制單位表示距離的本地化文字，也就是「31 Meile」。

以下是本地化值的顯示範例：

{ "localized_values":
  {
    "distance": { "text": "31,0 Meile/n" },
    "duration": { "text": 38 Minuten}.
    "static_duration": { "text": 36 Minuten}.
  }
}

如果未指定語言或單位系統，API 會依下列方式推斷語言和單位：

  • ComputeRoutes 方法會從起點航點推斷位置和距離單位。因此，如果是在美國發出路徑規劃要求，API 會推斷 en-US 語言和 IMPERIAL 單位。
  • ComputeRouteMatrix 方法預設為「en-US」語言和公制單位。

要求本地化值

如要在回應中加入本地化值，請執行下列操作：

  1. 在欄位遮罩中要求本地化值。例如：

    REST

    -H X-Goog-FieldMask: routes.localizedValues

    RPC

    const (fieldMask = "routes.localizedValues")

  2. 如要取得特定語言或單位系統的本地化值，請指定語言代碼和單位系統：

    "languageCode": "language_code",
"units": "METRIC | IMPERIAL",

    舉例來說，以下程式碼片段會將語言指定為德文 (de)，並使用 METRIC 單位：

    "languageCode": "de",
"units": "METRIC",

    詳情請參閱語言支援。

要求範例

curl -X POST -d '{
  "origin": { "location": {
    "latLng": { "latitude": 37.7873146, "longitude": -122.4159327 } }
  },
  "destination": { "location": {
    "latLng": { "latitude": 37.7621008, "longitude": -122.4382503 } }
  },
  "travelMode": "DRIVE",
  "computeAlternativeRoutes": true,
  "languageCode": "de",
  "units": "METRIC"
}' \
-H 'Content-Type: application/json' \
-H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: routes.localizedValues' \
'https://routes.googleapis.com/directions/v2:computeRoutes'

回應範例

回應會傳回 distance、duration 和 staticDuration 欄位的本地化值：

{
    "localizedValues": {
        "distance": {
            "text": "15,5 km"
         },
        "duration": {
            "text": "16 Minuten"
        },
        "staticDuration": {
            "text": "16 Minuten"
        }
    }
}