ルートトークンを取得する

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

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

Compute Routes が生成されたルートのルートトークンを返すようにリクエストする手順は次のとおりです。

1. ルートトークンを返すために必要な次のパラメータを設定します。

   • travelMode を DRIVE に設定します。
   • routingPreference を TRAFFIC_AWARE または TRAFFIC_AWARE_OPTIMAL に設定します。

2. ルートの経由地が経由地になっていないことを確認します。

3. ルートトークンを返すには、routes.routeToken フィールド マスクを指定します。

   X-Goog-FieldMask: routes.routeToken
   

注: 道路状況は常に変化するため、特定のトークンで生成されたルートが計画ルートと異なる場合があります。差異を最小限に抑えるため、トークンは生成後数分以内に使用してください。

Navigation SDK で、計画したルートのルートトークンを使用できます。詳しくは、以下をご覧ください。

• ルートを計画する（Android）
• ルートを計画する（iOS）

ルートトークンの例

単一の出発地と単一の目的地のルートの curl リクエストの本文の例を次に示します。フィールド マスクを使用して、ルートの所要時間、距離、ルートのポリラインとともにルートトークンをリクエストします。

curl -X POST -d
{"origin":{
    "location": {
        "latLng":{
            "latitude":  -37.8167,
            "longitude": 144.9619
        }
    }
},
"destination":{
    "location": {
        "latLng":{
            "latitude":-37.8155,
            "longitude": 144.9663
        }
    }
},
"routingPreference":"TRAFFIC_AWARE",
"travelMode":"DRIVE"
}
-H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H X-Goog-FieldMask: routes.routeToken,routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline
'https://routes.googleapis.com/directions/v2:computeRoutes'

詳細については、Compute Routes API リファレンスをご覧ください。