ルートの概要

セクションの概要では、特定のルートセクションの長さ、所要時間、消費量、通行料金などの情報が提供されます.セクションの概要で利用可能なすべての情報に関する詳細については、「API リファレンス」の「Routes API レスポンススキーマ」を参照してください。

セクションの概要は、return=summary、return=travelSummary、またはその両方return=summary,travelSummaryを使用してリクエストできます。

summaryは、事前アクションと事後アクションを含む、セクション全体の概要情報を提供します。
travelSummaryは、セクションの移動部分についてのみ概要情報を提供します。事前アクションと事後アクションは除外されます。

この例では、ルートレスポンスでセクションの概要情報を返します。さらに、最初のセクションの最後にあるwaitポストアクションによるsummaryとtravelSummaryの違いを示します。

curl -gX GET 'https://router.hereapi.com/v8/routes?'\
'origin=52.51375,13.42462&'\
'destination=52.52332,13.42800&'\
'via=52.52426,13.43000!stopDuration=120&'\
'return=polyline,summary,travelSummary&'\
'transportMode=car&'\
'apiKey=YOUR_API_KEY'

{
  "routes": [
    {
      "id": "ceab8139-1857-48d3-9f04-40e1c993c8e1",
      "sections": [
        {
          "id": "3542b673-a1ae-4363-81cf-8326e6b10307",
          ...,
          "postActions": [
            {
              "action": "wait",
              "duration": 120
            }
          ],
          ...,
          "summary": {
            "duration": 294,
            "length": 1281,
            "baseDuration": 256
          },
          "travelSummary": {
            "duration": 174,
            "length": 1281,
            "baseDuration": 136
          },
          "polyline": "...",
          "transport": {
            "mode": "car"
          }
        },
        {
          "id": "43d61f69-5591-4dd6-81e1-ca4c76c91c27",
          ...
        }
      ]
    }
  ]
}

次のステップ

ルートセクションで取得できるさまざまな種類の所要時間情報については、「Duration、baseDuration、typicalDuration、mlDuration」を参照してください。
ルートのコストの計算方法については、「ビネット価格を除く通行料金を取得する」を参照してください。
ICE (内燃機関) 車両の詳細を取得するには、「セクションあたりの燃料消費量とCO2排出量を計算する」を参照してください。

25 日前の更新