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

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

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

Compute Routes で生成されたルートのルートトークンを返すようにリクエストするには、次の手順を行います。

1. ルートトークンを返すために必要な次のパラメータを設定します。
   • travelMode を DRIVE または TWO_WHEELER に設定します。
   • routingPreference を TRAFFIC_AWARE または TRAFFIC_AWARE_OPTIMAL に設定します。
2. 出発地と目的地の位置を指定します。緯度経度座標、住所文字列、ナビゲーション ポイント トークン、プレイス ID を使用して、ユースケースに合わせた位置を指定できます。位置指定のオプションをご覧ください。
3. ルートの経由地が Via 経由地でないことを確認します。

4. ルートトークンを返すように routes.routeToken フィールド マスクを指定します。

   X-Goog-FieldMask: routes.routeToken
   

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

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

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

ルートトークンの例

出発地が 1 つ、目的地が 1 つのルートの 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 リファレンスをご覧ください。