Action

Actionは、ルートの特定の部分で、または特定の部分で行う必要がある処理を指定します。

Actionの例 :

  • 右折します
  • フェリーに乗る
  • 目的地に到着しました

セクション内のAction は、Action、Pre-Action、およびPost-Actionに分けられます。

  • Sectionの出発前に、Pre-Actionが実行されます。
  • Sectionの到着後に、Post-Actionが実行されます。
  • Sectionの出発と到着の間に、Actionが実行されます。

ユーザーは、Sectionの出発と到着の間に、ターンバイターンActionの個別のリストを要求することもできます。 これらの操作には、ターンバイターンガイダンスをサポートするために、各操作の道路情報 ( 道路名や番地など ) も含まれています。

道路名と言語の設定

特定の地域では、道路名と道路番号が複数の言語で利用できます。

道路名と番地は、次の要素で検索できます。

  • ターンバイターンアクション : currentRoadnextRoadの属性nameと、number
  • Spans: names および routeNumbers

いずれの場合も、道路名と番地の属性は配列であり、複数の要素を含めることができます。 配列の最初の要素には、最も優先度の高い名前 ( または番号 ) が含ま れます。この名前は、パラメーターlangで指定された優先言語、その言語の名前が使用可能な場合、またはローカル言語のいずれかで指定されます。 サポートされている言語については 、「言語」を参照してください。

ガイダンスユースケースのターンバイターンActionの詳細について は、ターンバイターンガイダンスのチュートリアルを参照してください。

Actionおよび人間が読める形式の命令の表示について詳しく は、 指示の取得 を参照してください。

以下は、サンプルActionを含むレスポンス本文です。

左に曲がるように指定するに は、パラメーター directionを使用します。

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

レスポンスで は、ブロックpostActions内の電気自動車の充電を指定できます。

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

レスポンスでは、詳細な道路情報をブロック turnByTurnActions 単位で指定できます。

...
"turnByTurnActions": [
  ...T
  {
    "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"
      }
    ]
    }
  }
  ...
]
...

」に一致する結果は 件です

    」に一致する結果はありません