请求本地化的值

欧洲经济区 (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 方法默认采用“英语(美国)”语言和公制单位。

如需请求本地化值,请执行以下操作:

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

  1. 在字段掩码中请求本地化值。例如:

    REST

    -H X-Goog-FieldMask: localizedValues

    RPC

    const (fieldMask = "localizedValues")
  2. 如果您希望本地化值采用特定语言或单位制,请指定语言代码和单位制:

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

    例如,以下代码段将语言指定为德语 (de),并使用公制单位:

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

    如需了解详情,请参阅语言支持