地点の最適化は、ComputeRoutes を拡張する Routes Preferred 機能です。旅行者の経路における中間地点の順序を最適化し、最も効率的な経路での移動を可能にします。地点最適化の ComputeRoutes 実装は、次の移動モードをサポートしています。
- 運転経路
- 電動二輪車
- サイクリング
- ウォーキング
地点の最適化を使用する理由
ユーザーが目的地までの複数の地点を案内するアプリを作成するときは、旅行者が地点を最適な順序で走査することが重要です。これにより、ユーザーは最も短時間で到着できるようになります。
仕組み
デフォルトでは、ComputeRoutes は指定された地点を元に提供された順にルートを計算します。ComputeRoutes を使用すると、中間地点をより効率的な順序に並べ替えることで、ルートを最適化できます。リクエスト本文の optimizeWaypointOrder フィールドを true に設定すると、最適化された地点を持つルートが返されます。
注: 地点の最適化の計算は主に移動時間に基づいていますが、距離や進路変更の回数なども考慮されます。
順序付けされた地点を取得する
順序付けされた地点を含むルートを取得するには、リクエストの本文でブール値フィールド optimizeWaypointOrder を true に設定します。ComputeRoutesまた、フィールド マスクに optimizedIntermediateWaypointIndex フィールドを含めます。レスポンス本文の optimizedIntermediateWaypointIndex フィールドに、最適化された地点の順序が含まれています。
注: optimizedIntermediateWaypointIndex フィールドはゼロベースの値を返します。
リクエストの例
次のサンプル リクエストでは、スタンフォード大学のキャンパス付近のルートを指定しています。ルートの地点がリクエストで順番に指定されています。リクエストには出発地と目的地に加え、中間の地点が 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 個以下である必要があります。
routes.optimizedIntermediateWaypointIndexをフィールド マスクに追加します。タイプに地点を指定することはできません。つまり、指定された地点はすべて停車地でなければなりません。
25 ～ 98 個の中間地点を含むリクエストは、次の条件を満たしている必要があります。
すべての地点間の累積直線距離は 1,000 km 未満でなければなりません。この距離には、出発地と目的地の両方が含まれます。
地点の位置は緯度と経度で指定する必要があります。
移動手段は DRIVE にする必要があります。