ガイドAPIリファレンス
ガイド

歩行者ユースケースの等値線の要求方法

歩行者の等値線ルートは歩行者が利用できる道路と車道のみを使用します。これらには、歩道、森林の小道、公園、フェリー、建物を通る近道、階段などが含まれます。

transportMode=pedestrianを設定することで、歩行者等値線ルーティングを有効にすることができます。

歩行者ルーティングには次の2種類の等値線があります。

  • range[type]=distancerange[values] (メートル単位) のパラメーターで移動可能な距離を制限。
  • range[type]=timerange[values] (秒)、pedestrian[speed] (m/s) のパラメーターで走行可能な時間を制限。

avoid[features]パラメーターを使用し、tunneldirtRoadferryなど望ましくない道路タイプの値を挿入することで、特定の道路機能を回避することができます。

次のリクエストは、ベルリンの出発地点からトンネルを回避ししつつ、歩行速度が1メートルあたり1.5秒の歩行者が最大で10分間歩ける距離を示しています。

curl -gX GET 'https://isoline.router.hereapi.com/v8/isolines?'\
'origin=52.559248,13.389417&'\
'range[type]=time&'\
'range[values]=1200&'\
'transportMode=pedestrian&'\
'pedestrian[speed]=1.5&'\
'apiKey=YOUR_API_KEY'

レスポンスには、歩行者がこれらの前提条件で到達できるポリゴンが含まれています。ポリゴンは柔軟なポリラインとしてエンコードされます。

{
  "departure":
  {
    "time": "2023-06-27T09:00:37+00:00",
    "place":
    {
      "type": "place",
      "location":
      {
        "lat": 52.55946,
        "lng": 13.38971
      },
      "originalLocation":
      {
        "lat": 52.559248,
        "lng": 13.389417
      }
    }
  },
  "isolines": [
    {
      "range":
      {
        "type": "time",
        "value": 1200
      },
      "polygons": [
        {
          "outer": "BGoxjokD028vZA4SrFkQlgB2K3KmgB1K4KrFiQA81CsFiQiQsFkQrF2K3KkQpF8qBAkQrFmgBlgB2KAsFiQAsgCsFkQkQsFuVAiQqFA4KlgB4KtVuVrFkQAuVsFiQkQsFiQrF4K1K2KAsFiQrFkQhQsFtVAjQqFA4K4K4KsFiQA2rFqFiQkQsFiQrFsFhQAvVsFhQkQrF8qBAkQsF2K4KmgB2KsFkQrFiQ1K4KrFiQsFkQiQsFuVAkQsFuVuVA4KhQqFvVAhQsF3K4K1KA3K3K3KAlgBmgB1KA3KlgB3KApFkQA8qBrFkQvVuVhQsFtVrFjQrFrF4KAuVsFwV4KuVsFuVA-qBqFiQsgCsgCmgB4K4K4KkQsFqgCAkQrFsFjQAtVrFjQ3K1K1KlgB3K3KrFhQA9qBsFjQ4KA2KmgB4K4KsFkQAuVsFiQ2K4KsFkQAuVsFiQmgB4K4K4KiQsFkQrFuVvV4KlgB2KAsFkQAuVrFkQ1K2K3KmgB3KA1K1KjQrFhQsFvVuVrFkQA8qBpFkQ3K2KrFkQAsgCrFiQ1K4KA4K2K2KsFkQAuVsFkQ4K2KqFkQAuVsFkQ4KA4KlgB2K3K4KlgB4K3K2KlgB4K1K4KlgBuVvV4KAqFkQAorDpFkQ3K4KA2K4K4KqFiQAwVpFuV3KuVAkQ4K2KqFkQpFiQ3K4KA4KmgB2KA4KjQsFtVAhQsF3KmgB3K2KrFkQA61CpFkQ3KA3KlgBhQrFvVAhQsFtVuVrFkQA8qBsFkQmgB2KmgBmgBmgB4K2K4K4KAsFjQAnrDsFjQ2KAsFkQAuVsFiQ4K4KA4K3K2KrFkQAuVsFkQiQqFwVAiQsFwVwVqFiQAuVpFkQ3KAlgBlgBjQrFhQsFrFiQAwVsFiQ4K4KqFiQAwVpFiQ3K4KrFiQA-qBrFkQhQqFjQpFrFjQA51CpFjQ3KA3K4KhQsFvVAhQrFA3KmgBlgBsFhQrFjQ9qB7qB1KA3KmgB3K2K1KmgBlgBmgB3KmgB3K4KpFiQA-qBqFkQkQqFuVAkQsFA4KjQsFtVAjQqFpFkQAuVqFkQ4K2KA4K3K4K1KmgBjQsFhQrFrFjQsFhQ2K3KsFhQAvVrFhQ1K3KrFhQsFjQ2K1KsFjQA9qBrFhQhQrFjQsF1K4KjQqFhQpFrFjQAtVsFjQ2K1KA3KlgB3KA1KmgB3KsFjQA7qBrFjQ1KA9qB-qB3KmgBlgB4KtVuVrFiQA-qBrFkQ1KAvVvVpFhQAn2ErFhQ3KA1KmgBlgB4K3K2KlgB4K3KiQrFkQsF4KwVuV2KmgB4K4K4KmgB2K2KsFkQAuVrFuV1KwV3KiQjQsFhQrF3KlgB1KArFkQAuVrFiQ3KArFhQA51CpFjQ3K1K3KlgB1KArFiQA-qBrFiQ3K4KrFiQAwVsFiQ4K4KA2KjQsFhQrFrFhQA3gEsFhQ4K3KqFjQAtVpFhQvVvVhQrFl2EAjQsFrFkQA61CrFkQtVuV3KApFjQA51CqFhQ4K3KA3KhQrFjQsF3K4K1KArFjQsFhQiQrFwVAiQrFsFhQAvVrFhQlgB3K3KlgB1KA3KmgBtVwVjQqFtVAtVpFjQrF3KsF1KArFjQsFhQmgBlgBsFjQA7qBrFjQlgB3KA1KmgB3KA3K3K1KrFjQsFhQ4K3KA3K3K1K3KlgB1K3KrFhQsFjQiQrFkQsF2K4K4KAsFjQAtVrFjQlgB1K3K3KhQrFtVAjQsFrFkQA61CrFiQ1KArFhQAtVrFjQtVtV3KAz1B01BjQsFhQrFA3K4K1K2KlgBmgB3KsFhQAvVrFhQ1K3KrFhQsFjQiQrFkQsF2KmgB4KAsFhQAn2ErFhQ3KArFiQA-qBpFkQjQqFhQpFrFjQAtVrFjQlgB1KrFjQAtVsFjQ4K1K2KlgB4K3KsFjQA51CrFhQ3K3K1KlgB3K3KrFhQAtVsFjQiQrFwVAiQsFsFkQAuVsFiQ-qB-qB2KA4KlgBmgBlgB2KlgB4K3KsFhQAtVrFjQ3KA1KmgB3KA7qB9qBrFhQA51CrFjQ3KA1KmgB3K4KrFiQAwVrFiQ1K4KrFiQAwVrFiQ3KArFhQAprDpFhQ3K3KA3KiQrFwVAiQpF4KlgBmgBlgBsFjQrFhQ3K3K1KlgBlgB3KvVtVrFjQAtVpFhQ3K3KrFjQAtVrFhQ1K3KA3KiQpFkQqFmgBmgB2KAmgBlgBkQpFuVAiQqF4KmgBuVwV4KAsFjQArgCsFhQiQrFkQsF8qB8qB4KmgB4K4K2KmgB4KAsFjQA7qBsFjQ2K1KsFjQAl2EsFjQkQpFiQqFsFkQA-qBrFiQ3K4KpFiQA4gErFkQ3K2KrFkQsFiQ4KAuVtV4KlgBygDxgD2KlgB4K3KsFhQrFjQlgB1K9qB9qBA3K4K1K4KlgB2KAsFiQAwVsFiQiQsFkQrFsFhQA3gEsFjQuVtViQrFkQsFsFiQAwVrFiQ3K4KrFiQAqrDsFiQ4KAuVtV4KlgB01Bz1B4KlgB4K3KqFhQAvVpFhQlgBlgBrFjQAtVsFhQ2KAwVuV2KmgB4K4K4KmgB2KA4KlgB61C71C4K1CsFiIAuN"
        }
      ]
    }
  ]
}

使用されるパラメーターの詳細については、「HERE Isoline Routing API v8 APIリファレンス」を参照してください。

次の画像は、トンネルを回避することで得られる等値線の形状がどのように変化するかを示しています。avoid[features]=tunnelを回避する場合の等値線と、回避しない場合の等値線を2つ重ねて表示します。

トンネルを回避する場合と回避しない場合の歩行者等値線ポリゴン