立体交差点や狭い道路をリクエストする

Routes API は、次のルート機能に関する情報を返すことができます(既知の場合)。

  • 高架道路: 高架道路(オーバーパスや橋など)に関する情報。
  • 狭い道路: 通常よりも狭いと見なされる道路に関する情報。

地図上に視覚的なインジケーターはありません。

サポートされている国: インドのみ

この機能のメリット

フライトオーバーとルートの絞り込みオプションを使用して、これらの機能についてユーザーに通知します。たとえば、アプリを使用するドライバーがこれらのルートを簡単に予測し、それに応じて運転を調整できるように、地図にアラートや視覚的なインジケーターを表示します。

手順については、次のセクションをご覧ください。

フライトオーバー情報をリクエストする

リクエストは次の条件を満たしている必要があります。

  • インドでルートをリクエストします。
  • travelModeDRIVE または 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
        }
      }]
    }
  }]
}

狭い道路に関する情報をリクエストする

リクエストは次の条件を満たしている必要があります。

  • インドでルートをリクエストする
  • travelModeDRIVE に設定する。
  • "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 の課金について学習する。