ガイダンスの取得

ターンバイターンガイダンスを使用すると、ユーザーは段階的なアプローチで目的地に誘導できます。

ガイダンスは、言葉と視覚の要素で構成されています。 言語コンポーネントとは、次の 1 つ以上の操作についての音声指示を指します。 ビジュアルコンポーネントは、方向矢印、現在または次の通りの名前など、現在または次の操作をサポートするユーザーインターフェースエレメントを参照します。

ルート セクション は、ガイダンス指向のターンバイターン アクションのシーケンスに分割され、ルートをリクエストするときにreturn=polyline,turnbyturnactions を指定することで取得できます。

curl -X GET \
'https://router.hereapi.com/v8/routes?transportMode=car&origin=52.5308,13.3847&destination=52.5323,13.3789&return=polyline,turnbyturnactions&apikey={YOUR_API_KEY}'

{
  "routes": [
    {
      "id": "a514bfa3-e97c-407b-aa13-615a9e4244c3",
      "sections": [
        {
          "id": "d71cc8f3-76a1-4ad0-a67f-56895aecc187",
          "type": "vehicle",
          "turnByTurnActions": [
            {
              "action": "depart",
              "duration": 24,
              "length": 113,
              "offset": 0,
              "nextRoad": {
                "name": [
                  {
                    "value": "Invalidenstraße",
                    "language": "de"
                  }
                ]
              }
            },
            {
              "action": "turn",
              "duration": 53,
              "length": 321,
              "offset": 4,
              "direction": "right",
              "severity": "quite",
              "currentRoad": {
                "name": [
                  {
                    "value": "Invalidenstraße",
                    "language": "de"
                  }
                ]
              },
              "nextRoad": {
                "name": [
                  {
                    "value": "Chausseestraße",
                    "language": "de"
                  }
                ]
              }
            },
            {
              "action": "turn",
              "duration": 15,
              "length": 105,
              "offset": 18,
              "direction": "left",
              "severity": "quite",
              "currentRoad": {
                "name": [
                  {
                    "value": "Chausseestraße",
                    "language": "de"
                  }
                ]
              },
              "nextRoad": {
                "name": [
                  {
                    "value": "Habersaathstraße",
                    "language": "de"
                  }
                ]
              }
            },
            {
              "action": "arrive",
              "duration": 0,
              "length": 0,
              "offset": 21,
              "currentRoad": {
                "name": [
                  {
                    "value": "Habersaathstraße",
                    "language": "de"
                  }
                ]
              }
            }
          ],
          "departure": {
            "time": "2020-09-11T13:29:22+02:00",
            "place": {
              "type": "place",
              "location": {
                "lat": 52.5309837,
                "lng": 13.384567
              },
              "originalLocation": {
                "lat": 52.5307999,
                "lng": 13.3847
              }
            }
          },
          "arrival": {
            "time": "2020-09-11T13:30:54+02:00",
            "place": {
              "type": "place",
              "location": {
                "lat": 52.5323264,
                "lng": 13.378874
              },
              "originalLocation": {
                "lat": 52.5323,
                "lng": 13.3789
              }
            }
          },
          "polyline": "BGwynmkDu39wZvBtF3InfvHrdvHvboGzF0FnGoGvHsOvR8L3NkSnVoGjIsEzFgFvHkDrJwHrJwHrJ4NjS0ezoBjInV3N_iBzJ_Z",
          "transport": {
            "mode": "car"
          }
        }
      ]
    }
  ]
}

• severity およびその他の通知の詳細な説明について は、「通知」を参照してください。
• duration およびそのタイプについての詳細 は、「期間」を参照してください。