请求本地化的值

欧洲经济区 (EEA) 开发者

如果您的账单邮寄地址在欧洲经济区，自 2025 年 7 月 8 日起，您在使用服务时需遵守 Google Maps Platform EEA 服务条款。具体功能因区域而异。 了解详情。

本地化响应值是一个额外的响应字段，可为返回的参数值提供本地化文本。系统会提供本地化的文本，用于表示行程时长、距离和单位制（公制或英制）。您可以使用字段掩码请求本地化值，并且可以指定语言和单位制，也可以使用 API 推断的值。如需了解详情，请参阅 LocalizedValues。

例如，如果您指定德语 (de) 的语言代码和英制单位，则 distanceMeters 的值为 49889.7，但同时也会获得本地化文本，以德语和英制单位提供该距离测量值，即“31 Meile”。

注意：您会获得两个预期时长值：duration 使用您指定的流量模型，而 staticDuration 不考虑流量。因此，如果您的请求流量模型为 TRAFFIC_UNAWARE，则这两个时间相同。

如需请求本地化值，请按以下步骤操作：

1. 将 localizedValues 字段添加到 ComputeRoutesRequest 的 fields 属性中。
2. （可选）使用 ComputeRoutesRequest 的 languageCode 和 units 属性指定语言和单位制。

以下是请求本地化值的示例：

const requestWithLocalizedValues = {
  origin: 'San Diego, CA',
  destination: 'Ensenada, MX',
  travelMode: 'DRIVING',
  language: 'es',
  units: google.maps.UnitSystem.METRIC,
  fields: ['path', 'localizedValues', 'distanceMeters', 'durationMillis'],
};
  

如果您未指定语言或单位制，computeRoutes 方法会根据起点航点推断位置和距离单位。因此，对于美国境内的路线规划请求，API 会推断出 en-US 语言和 IMPERIAL 单位。

如需读取本地化值，请使用 route.localizedValues。例如：

const localizedValues = route.localizedValues;
const distance = localizedValues.distanceMeters;
const duration = localizedValues.duration;
const durationStatic = localizedValues.staticDuration;