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

欧州経済領域（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: routes.localizedValues

    RPC

    const (fieldMask = "routes.localizedValues")

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

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

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

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

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

リクエスト例

curl -X POST -d '{
  "origin": { "location": {
    "latLng": { "latitude": 37.7873146, "longitude": -122.4159327 } }
  },
  "destination": { "location": {
    "latLng": { "latitude": 37.7621008, "longitude": -122.4382503 } }
  },
  "travelMode": "DRIVE",
  "computeAlternativeRoutes": true,
  "languageCode": "de",
  "units": "METRIC"
}' \
-H 'Content-Type: application/json' \
-H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: routes.localizedValues' \
'https://routes.googleapis.com/directions/v2:computeRoutes'

レスポンスの例

レスポンスは、distance、duration、staticDuration フィールドのローカライズされた値を返します。

{
    "localizedValues": {
        "distance": {
            "text": "15,5 km"
         },
        "duration": {
            "text": "16 Minuten"
        },
        "staticDuration": {
            "text": "16 Minuten"
        }
    }
}