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

欧州経済領域（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 メソッドのデフォルトは、言語が「en-US」、単位がメートル法です。

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

ローカライズされた値をレスポンスに含めるには、次の操作を行う必要があります。

  1. フィールド マスクでローカライズされた値をリクエストします。次に例を示します。

    REST

    -H X-Goog-FieldMask: localizedValues

    RPC

    const (fieldMask = "localizedValues")

  2. 特定の言語または単位系でローカライズされた値を取得するには、言語コードと単位系を指定します。

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

    たとえば、次のコード スニペットでは、言語をドイツ語（de）に、単位をメートル法に指定しています。

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

    詳細については、言語サポートをご覧ください。