歩行速度をカスタマイズするには

デフォルトでは、Routing APIは1秒あたり1メートルという控えめな歩行速度を想定しています。これは、レスポンス内のsummary情報で確認できます。

たとえば、この15 kmのルートを見てみましょう。

curl -gX GET 'https://router.hereapi.com/v8/routes?'\
'origin=52.547019,13.328605&'\
'destination=52.541812,13.334422&'\
'return=summary,polyline&'\
'spans=dynamicSpeedInfo&'\
'transportMode=pedestrian&'\
'apiKey=YOUR_API_KEY'

レスポンスでは、baseSpeedが1秒あたり1メートルであることがわかります。ルートにturnTimeが含まれていないため、duration (秒単位) もlength (メートル単位) と同一です。

"sections": [
  {
    ...,
    "summary": {
      "duration": 770,
      "length": 770,
      "baseDuration": 770
    },
    "polyline": "...",
    "spans": [
      {
        "offset": 0,
        "dynamicSpeedInfo": {
          "trafficSpeed": 1,
          "baseSpeed": 1,
          "turnTime": 0
        }
      }
    ],
    "transport": {
      "mode": "pedestrian"
    }
  }
]

ユーザー定義の歩行速度を設定する

歩くペースは人によって違うため、リクエストでpedestrian[speed]パラメーターを使用して歩行速度を調整できます。次のリクエストでは、より楽観的な歩行速度1.42メートル/秒に設定します。

curl -gX GET 'https://router.hereapi.com/v8/routes?'\
'origin=52.547019,13.328605&'\
'destination=52.541812,13.334422&'\
'return=summary,polyline&'\
'spans=dynamicSpeedInfo&'\
'transportMode=pedestrian&'\
'pedestrian[speed]=1.42&'\
'apiKey=YOUR_API_KEY'

ご覧のとおり、durationの値は大幅に低くなっています。770メートルでわずか544秒です。baseSpeedは1.42メートル/秒に増加しています。

"sections": [
  {
    "summary": {
      "duration": 544,
      "length": 770,
      "baseDuration": 544
    },
    "polyline": "...",
    "spans": [
      {
        "offset": 0,
        "dynamicSpeedInfo": {
          "trafficSpeed": 1.42,
          "baseSpeed": 1.42,
          "turnTime": 0
        }
      }
    ],
    ...
  }
]

25 日前の更新