要求本地化值

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

如果您的帳單地址位於歐洲經濟區，自 2025 年 7 月 8 日起，使用服務時將適用《 Google 地圖平台歐洲經濟區服務條款》。功能會因區域而異。 瞭解詳情。

本地化回應值是額外的回應欄位，可為傳回的參數值提供本地化文字。系統會提供本地化文字，顯示行程時間、距離和單位系統 (公制或英制)。您可以使用欄位遮罩要求本地化值，並指定語言和單位制，或使用 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;