ガイドAPIリファレンス
ガイド
  1. HERE Routing API V8 - 開発者ガイド
  2. 概念

アクションの概要

アクションは、ルート上の特定の地点または特定の区間で実行する必要がある操作を指定します。

アクションの例：

  • 右に曲がる。
  • フェリーに乗る。
  • ロータリーの4番目の出口を出る
  • 目的地に到着する

セクション内のアクションは次のように分類されます。

  • preActions：アクションは、セクションを出発する前に実行されます。
  • postActions：アクションは、セクションに到着した後に実行されます。
  • actions、turnByTurnActions：アクションは、セクションを出発してから到着するまでの間に実行されます。
📘

注

出発時間と到着時間もactionsです。

セクションの詳細については、こちらのトピックを参照してください。

使用可能なアクション

セクションで使用可能なアクションは、セクションのタイプ (PedestrianSection、VehicleSection、TransitSection) によって異なります。 アクションのリストはいつでも拡張される可能性があり、クライアントアプリケーションはそのような場合に適切に対処できるようにしてください。

現在使用可能なアクションのリストを取得するには、「HERE Routing V8 APIリファレンス」を参照してください。次の手順を実行します。

  1. /openapiエンドポイントから完全なAPIリファレンスを取得します。
curl -gX GET "https://router.hereapi.com/v8/openapi"
  1. 目的のセクションタイプに対応するアクションカテゴリー (PedestrianAction、VehicleAction、TransitAction) を探します。
  2. discriminatorプロパティのmapping辞書には、指定された交通機関タイプで使用可能なすべてのアクションが含まれ、それぞれの対応するスキーマにリンクされます。
📘

注

または、HEREドキュメントポータルでホストされているAPIリファレンスを使用することもできます。これについては、「HERE Routing API v8 APIリファレンス」を参照してください。

ターン・バイ・ターンアクション

クライアントは、セクションの出発から到着までの間に、ターン・バイ・ターンアクションのリストをリクエストすることもできます。 これらのアクションには、各操作の道路情報が含まれており、ターン・バイ・ターンガイダンスをサポートします。 この情報には、道路名、住居番号などが含まれます。

ターン・バイ・ターンアクションの詳細およびそれらをガイダンスに使用する方法については、ターン・バイ・ターンナビの手順のチュートリアルを参照してください。

道路名と言語の優先設定

一部の地域では、複数の言語で道路名と道路番号を表示できます。

道路名と道路番号は、次の要素で確認できます。

  • ターン・バイ・ターンアクション：currentRoadおよびnextRoadのnameおよびnumber属性
  • スパン：namesおよびrouteNumbers

道路名と番号の属性は配列になっており、複数の要素を含めることができます。 配列の最初の要素には、優先度が最も高い名前または番地が含まれます。

langパラメーターで指定された言語の名前と番号は最も高い優先度です。 langパラメーターで設定された言語で使用できない場合、名前または番号はいずれかのローカル言語で指定されます。

詳細については、「サポートされている言語」を参照してください。

例

次の例は、レスポンス本文のフラグメントとサンプルアクションを示しています。

方向転換

direction属性は、曲がる方向を指定します。この例は左折を示しています。

"actions": [
  {...},
  {
    "action": "turn",
    "direction": "left",
    "duration": 167,
    "offset": 85,
    "severity": "light"
  },
  {...}
]

電気自動車の充電

ブロックpostActionsで電気自動車 (EV) の充電を指定できます。

"postActions": [
  {
    "action": "chargingSetup",
    "duration": 300
  },
  {
    "action": "charging",
    "arrivalCharge": 8.9334,
    "consumablePower": 50.0,
    "duration": 5045,
    "targetCharge": 72.0
  }
]

詳細な道路情報

turnByTurnActionsブロックには詳細な道路情報を含めることができます。

"turnByTurnActions": [
  {...},
  {
    "action": "turn",
    "duration": 393,
    ...,
    "currentRoad": {
    "name": [
      {
        "value": "Otto-Braun-Straße",
        "language": "de"
      }
    ],
    "number": [
      {
        "value": "B2",
        "language": "de"
      }
    ]
    },
    "nextRoad": {
    "name": [
      {
        "value": "Alexanderstraße",
        "language": "de"
      }
    ],
    "number": [
      {
        "value": "B2",
        "language": "de"
      },
      {
        "value": "B5",
        "language": "de"
      }
    ]
    }
  },
  {...}
]

25 日前の更新