Routes API は、次のルート機能に関する情報を返すことができます(既知の場合)。
- 高架道路: 高架道路(オーバーパスや橋など)に関する情報。
- 狭い道路: 通常よりも狭いと見なされる道路に関する情報。
地図上に視覚的なインジケーターはありません。
サポートされている国: インドのみ
この機能のメリット
フライトオーバーとルートの絞り込みオプションを使用して、これらの機能についてユーザーに通知します。たとえば、アプリを使用するドライバーがこれらのルートを簡単に予測し、それに応じて運転を調整できるように、地図にアラートや視覚的なインジケーターを表示します。
手順については、次のセクションをご覧ください。
フライトオーバー情報をリクエストする
リクエストは次の条件を満たしている必要があります。
- インドでルートをリクエストします。
travelMode
をDRIVE
またはTWO-WHEELER
に設定します。"extraComputations": ["FLYOVER_INFO_ON_POLYLINE"]
を含めます。- 以下のフィールドのフィールド マスクを含めます。
routes.polyline_details.flyover_info
routes.polyline
optimizeWaypointOrder
パラメータは含めないでください。
詳しくは、PolylineDetails.FlyoverInfo
をご覧ください。
リクエストの例: フライトオーバー情報
curl -X POST -d '{ "origin": { "location": { "latLng": { "latitude": 28.57580734159006, "longitude": 77.02719067373043 } } }, "destination": { "location": { "latLng": { "latitude": 28.595737365438477, "longitude": 77.16870453065245 } } }, "travelMode": "DRIVE", "extraComputations": ["FLYOVER_INFO_ON_POLYLINE"] }\ -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \ -H 'X-Goog-FieldMask: routes.polyline_details.flyover,routes.polyline' \ 'https://routes.googleapis.com/directions/v2:computeRoutes'
レスポンスの例: フライトオーバー情報
{
"routes": [{
"polyline": {
"encodedPolyline": "selmD}jcuM?oBcDAqEF}DCOOZuCfAwJFMJM\\_Cd@mEv@gFHQF_C?eIGe@_@{@g@u@MY@Wz@cCp@}AF_@MeC?kLFy@xZpBxRlAdJj@zCPlBRxPfApP|@`@MVUHQv@iF~@aFfAeEnA_EpAgD`@kAjCeF~FiKPa@NOx@iApAyCtA{C`@wAEg@Ba@Xq@TU`@MZCLY^QPQx@kAn@cAh@s@^YZ]fA{@lAs@bBy@`DiAtDwAdB_ARCP@z@m@dAeAbA_BpAcCd@oAr@eBRe@nEsIjAiBdAuBZw@n@{BTsANi@p@wAJ]h@wCr@oEr@yEvAwI`AuGt@gG`@oEt@wFr@}FpB_N`CiQ`AqGVoAbEcP^_Br@uDr@yEPqA^cEj@iERyCReEf@}GvBkQXwATgC@_@AYK]u@wAGa@IoHFaEFoAXuDVqBdBsLb@qDRuCRaELu@Rs@d@u@lBaC\\o@Tm@VwANcAHmADuCCsAKo@YkAU}@AQ@WHa@iJyTs@uAe@q@c@i@oA_AuAw@kBu@iEwAuDoA_JeDiB}@qAaA]a@u@gAeAoB_CoG}@eCgAoCw@wAsByCe@i@iCmDmAmB}BeDu@aAaHyJ_BwBCEyBaD}AkBu@u@uAy@gBw@yAc@gFoAiKmC}E{@eCk@sF}@YCwDIqDG{Tq@mB@_Ne@k@AoBGkAKaB]{Am@gBkAcAgAcBeCmAwBwAwCmDeGq@yAcAwCmCgJQu@i@gAw@mAaAkA{@u@oAu@eAe@kAa@}GcBEAkDq@aAWkKaBqDq@oMuBuBc@e@Ok@Wm@e@_AaAm@aA[}@a@uAy@aDmCmJSi@cAmDsEyNgAaDcDeKEo@gAkDkD{I_AyCg@qBeAqEU_AgA_D[{@gBoGaDaIqDaIYs@"
},
"polylineDetails": {
"flyoverInfo": [{
"flyoverPresence": "EXISTS",
"polylinePointIndex": {
"startIndex": 153,
"endIndex": 173
}
}, {
"flyoverPresence": "EXISTS",
"polylinePointIndex": {
"startIndex": 190,
"endIndex": 213
}
}]
}
}]
}
狭い道路に関する情報をリクエストする
リクエストは次の条件を満たしている必要があります。
- インドでルートをリクエストする
travelMode
をDRIVE
に設定する。"extraComputations": ["NARROW_ROAD_INFO_ON_POLYLINE"]
を含む次のフィールドのフィールドマスクを含めます。
routes.polyline_details.narrow_road_info
routes.polyline
。
optimizeWaypointOrder
パラメータは含めないでください。
詳しくは、PolylineDetails.NarrowRoadInfo
をご覧ください。
リクエストの例: 狭い道路の情報
curl -X POST -d '{ "origin": { "location": { "latLng": { "latitude": 12.9598336, "longitude": 80.1659834 } } }, "destination": { "location": { "latLng": { "latitude": 12.9593739, "longitude": 80.1723585 } } }, "travelMode": "DRIVE", "extraComputations": ["NARROW_ROAD_INFO_ON_POLYLINE"] }\ -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \ -H 'X-Goog-FieldMask: `routes.polyline_details.narrow_road_info`,routes.polyline' \ '[https://routes.googleapis.com/directions/v2:computeRoutes](https://routes.googleapis.com/directions/v2:computeRoutes)'
レスポンスの例: 狭い道路
{
"routes": [{
"polyline": {
"encodedPolyline": "{ebnA_mhhNqAGGeD?aAFq@Xy@Re@Jm@FmABOHOTQBYWgIBiHBo@j@@d@@"
},
"polylineDetails": {
"narrowRoadInfo": [{
"narrowRoadPresence": "EXISTS",
"polylinePointIndex": {
"startIndex": 15,
"endIndex": 16
}
}]
}
}]
}
サポートされているリージョン
高架道路と狭い道路はインドでのみサポートされています。
課金
Google Maps Platform では、試験運用版機能の使用に対して追加料金は発生しません。設定した他のパラメータに基づいて、API の使用量に応じて課金されます。
Routes API の課金について学習する。