ローカライズされた値をリクエストする

欧州経済領域（EEA）のデベロッパー

請求先住所が欧州経済領域内にある場合は、2025 年 7 月 8 日より、 Google Maps Platform の EEA における利用規約がこのサービスの利用に適用されます。機能は地域によって異なります。詳細

ローカライズされたレスポンス値は、返されたパラメータ値のローカライズされたテキストを提供する追加のレスポンス フィールドです。移動時間、距離、単位系（メートル法またはヤードポンド法）のローカライズされたテキストが提供されます。ローカライズされた値はフィールド マスクを使用してリクエストします。言語と単位系を指定するか、API によって推測された値を使用できます。詳しくは、LocalizedValues をご覧ください。

たとえば、ドイツ語（de）の言語コードとヤードポンド法を指定すると、distanceMeters の値として 49889.7 が返されるだけでなく、ドイツ語とヤードポンド法で距離を測定した「31 Meile」というローカライズされたテキストも返されます。

注: 予想所要時間には 2 つの値が返されます。duration は指定したトラフィック モデルを使用し、staticDuration はトラフィックを考慮しません。したがって、リクエストされたトラフィック モデルが TRAFFIC_UNAWARE の場合、これらの時間は同じになります。

ローカライズされた値をリクエストする手順は次のとおりです。

1. ComputeRoutesRequest の fields プロパティに localizedValues フィールドを追加します。
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;