地点の最適化は、ComputeRoutes
を拡張した Routes Preferred 機能です。旅行者の経路の中間地点の順序を最適化して、可能な限り最も効率的なルートを走行できるようにします。地点の最適化の ComputeRoutes
実装は、次の交通手段をサポートしています。
- 車
- オートバイ
- 自転車
- ウォーキング
地点の最適化を使用する理由
多くの地点を通るユーザーを目的地まで案内するアプリを作成する場合は、ユーザーが地点を最適な順序で通過することが重要です。これにより、旅行者は最短時間ですべての地点に到着できます。
仕組み
デフォルトでは、ComputeRoutes
は地点を通るルートを、指定された順序で計算します。中間の地点をより効率的な順序に並べ替えることで、ComputeRoutes
でルートを最適化できます。リクエスト本文の optimizeWaypointOrder
フィールドを true
に設定すると、最適化された地点を含むルートが返されます。
注: 地点の最適化は、主に移動時間に基づいて行われますが、距離や曲がり角など、他の要素も考慮されます。
並べ替えられた地点を取得する
地点の順序を変更したルートを取得するには、ComputeRoutes
に対するリクエストの本文でブール値フィールド optimizeWaypointOrder
を true
に設定します。また、フィールド マスクに optimizedIntermediateWaypointIndex
フィールドを含めます。レスポンスの本文では、最適化された地点の順序が optimizedIntermediateWaypointIndex
フィールドに格納されます。
注: optimizedIntermediateWaypointIndex
フィールドは 0 ベースの値を返します。
リクエストの例
次のリクエストの例では、スタンフォード大学のキャンパス付近のルートを指定しています。ルートの地点はリクエストで順番に指定されています。リクエストには 1 つの出発地と 1 つの目的地が含まれ、さらに 2 つの中間ウェイポイントがあります。
POST /v1alpha:computeRoutes
Host: routespreferred.googleapis.com
Content-Type: application/json
X-Server-Timeout: 10
X-Goog-Api-Key: YOUR_API_KEY
X-Goog-FieldMask: routes.optimizedIntermediateWaypointIndex,routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline
{
"origin":{
"location":{
"latLng":{
"latitude": 37.418956,
"longitude": -122.160815
}
}
},
"intermediates": [
{
"location":{
"latLng":{
"latitude": 37.4176423,
"longitude":-122.1102246
}
}
},
{
"location":{
"latLng":{
"latitude": 37.407689,
"longitude": -122.1360597
}
}
}
],
"destination":{
"location":{
"latLng":{
"latitude": 37.4032137,
"longitude": -122.0349119
}
}
},
"travelMode": "DRIVE",
"optimizeWaypointOrder": true,
"routingPreference": "TRAFFIC_AWARE"}
レスポンスの例
並べ替えられた中間地点インデックスは、レスポンス本文のルート オブジェクト内の optimizedIntermediateWaypointIndex
フィールドで確認できます。エンコードされたポリラインは、Directions API や ComputeRoutes の場合と同じです。
routes {
distance_meters: 17647
duration {
seconds: 1866
}
polyline {
encoded_polyline: "wkkcFvorhVU{@Ec@C}CG}@Mm@[}@i@y@[[g@_@Tk@BSjCgGfF|D\\Pv@Lj@@XaCTeC\\aCTs@`ByD`@k@h@e@x@Yh@GtADhBF|@G`AWpAs@lAsAdA{A`BmDr@cBmUqQoS}OyGmFiBsAgEwD}CaCU_@Og@@e@Hy@nGkO~@sBr@cBlDqIlByEp@}AjIfGnBbBHLLd@^p@~ErDfNrKrA~@DIhEeBTQ~AqDlE{KjBgE|FnEh@aAi@`A}FoE~AmD`A}BcAm@mHwFwD}CkLwIsDqCgF_EG[GKnCsDrA_BrC_CnCoBpEkD`EyClCsBcBeBIAkGkH]k@eJmKQKsAuA_@g@wCoDGQmEmFmIqROKaDuHvBkBxAgANCRH^f@v@dBHDD?`AUiBqEhBpEaATMCQYm@wAY]SIOByAfAwBjB_ByDaAwBiCeIA[c@aBqEuNOm@IQbA{c@p@aZFmCTuBLg@Tc@BUAKxOeV~Vy_@nBoDv@_BvAcDzA_EdG{RdC{HtIsY|B{Hx@mDbAuFdBsMbKsv@TaBf@}AdF{Sn@_DJq@Lo@aE`@]GUQmAmAQk@@g@RK`Ce@d@UDEPc@f@cCrAyGJs@X{AbIem@bA{JD_AIaAMg@o@{A_Ad@y@NaCLCsCK_FGI"
}
optimizedIntermediateWaypointIndex: 1
optimizedIntermediateWaypointIndex: 0
}
この例では、地点を最適化すると元の順序が逆になります。
おすすめの実装方法
ウェイポイントが最適化されたリクエストは、単純なルーティング リクエストよりも処理に時間がかかります。そのため、X-Server-Timeout
リクエスト ヘッダーの値を 10 秒以上に設定して、メソッド呼び出しのタイムアウトを長く設定することをおすすめします。タイムアウト エラーが引き続き発生する場合は、もう 1 秒追加して再試行できます。
使用制限
地点の最適化を使用するには、次の使用制限と条件に従う必要があります。
ルート上の中間地点には、使用量上限まで指定できます。
- 緯度と経度の座標のみを使用する最大 98 個のウェイポイント。
- プレイス ID を使用して地点を指定する場合は、最大 25 個の地点を指定します。
ウェイポイントはすべて「停車地」タイプである必要があります。どの地点も via タイプにはできません。
フィールド マスクに
routes.optimizedIntermediateWaypointIndex
を追加する必要があります。リクエストに 25 以上の中間地点がある場合は、次の条件も遵守する必要があります。
すべての地点間の累積直線距離は 1,000 km 未満でなければなりません。この距離には、出発地と目的地の両方が含まれます。
移動手段が「DRIVE」である必要があります。