要求本地化值

本地化回應值是額外的回應欄位 傳回的參數值的本地化文字。為 行程時間長度、距離與單位系統 (公製或英制)。你提出要求 透過欄位遮罩來本地化值,且可以指定 單位系統或使用 API 推測的值。詳情請參閱 LocalizedValues

舉例來說,如果您為德文 (de) 和英制代碼指定語言代碼 則結果會是 49889.7 的 distanceMeters 也提供本地化文字,提供德文和 英制單位,例如「31 Meile」。

以下是本地化值的內容示例:

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

如果您未指定語言或單位系統,API 會推測出 和單位,方法如下:

  • ComputeRoutes 方法會推測位置和距離 與原始路線控點之間的單位數如果是美國的轉送要求 可推斷 en-US 語言和 IMPERIAL 單位。
  • ComputeRouteMatrix 方法預設為「en-US」語言 和 METRIC 單位

要求本地化值

如要在回應中加入本地化值,您必須執行下列操作:

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

    REST

    -H X-Goog-FieldMask: routes.localized_values

    遠端程序呼叫 (RPC)

    const (fieldMask = "routes.localized_values")
  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.localized_values' \
'https://routes.googleapis.com/directions/v2:computeRoutes'

回應範例

回應會傳回 distancedurationstaticDuration 欄位:

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