地点の最適化は、ComputeRoutes
を拡張した Routes Preferred 機能です。ユーザーのルートにおける中間地点の順序を最適化し、可能な限り最も効率的なルートを移動できるようにします。地点の最適化の ComputeRoutes
実装では、次の移動手段がサポートされています。
- 車
- オートバイ
- 自転車
- ウォーキング
地点の最適化を使用する理由
目的地に向かう途中で多くの地点を案内するアプリを構築する場合、旅行者が地点を最適な順序で通過することが重要です。これにより、旅行者はすべての地点に最短の時間で到着できます。
仕組み
デフォルトでは、ComputeRoutes
は最初に指定された順序でウェイポイントを通過するルートを計算します。ComputeRoutes
を使用すると、中間ウェイポイントをより効率的な順序に並べ替えてルートを最適化できます。リクエスト本文の optimizeWaypointOrder
フィールドを true
に設定すると、最適化された地点を含むルートを取得できます。
注: 地点の最適化の計算は主に移動時間に基づいていますが、この機能は距離や曲がり角などの要素も考慮されます。
並べ替えたウェイポイントを取得する
地点が並べ替えられたルートを取得するには、ComputeRoutes
へのリクエストの本文でブール値フィールド optimizeWaypointOrder
を true
に設定します。また、フィールド マスクに optimizedIntermediateWaypointIndex
フィールドを含めます。レスポンスの本文では、optimizedIntermediateWaypointIndex
フィールドに最適化された地点の順序が含まれています。
注: optimizedIntermediateWaypointIndex
フィールドは 0 ベースの値を返します。
リクエスト例
次のリクエストの例では、スタンフォード大学のキャンパス付近のルートを指定します。ルートの地点は、リクエストで順番に指定されています。リクエストには、出発地と目的地、および 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 個まで指定できます。
すべてのウェイポイントは stopover タイプである必要があります。どの地点も via にできません。
フィールド マスクに
routes.optimizedIntermediateWaypointIndex
を追加する必要があります。リクエストに 25 個以上の中間地点がある場合は、次の条件も満たす必要があります。
すべての地点間の直線距離の累積が 1,000 km 未満であることが必要です。この距離には、出発地と目的地の両方が含まれます。
移動手段がドライブである必要があります。