请求本地化的值

本地化的响应值是一种额外的响应字段 返回的参数值的本地化文本。本地化文本适用于 行程时长、距离和单位制(公制或英制)。您可以使用字段掩码请求本地化值,并可以指定语言和单位制,也可以使用 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 方法会推断出位置和距离 为起点航点的单位设置值因此,对于美国的路由请求 会推断 en-US 种语言和 IMPERIAL 个单位。
  • ComputeRouteMatrix 方法默认采用“英语(美国)”语言和公制单位。

请求本地化的值

如需在响应中添加本地化值,您需要执行以下操作:

  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"
        }
    }
}