アクション

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

アクションの例 :

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

セクション内のアクション は、アクション、プリアクション、およびポストアクションに分けられます。

• セクションが出発する前に、事前アクションが実行されます。
• 事後処理は、セクションの到着後に実行されます。
• アクションは、セクションの出発と到着の間に実行されます。

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

道路名と言語の設定

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

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

• ターンバイターンアクション : currentRoad および nextRoadの属性namenumber
• Spans: names および routeNumbers

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

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

アクションおよび人間が読める形式の命令の返信について詳しく は、 get instructions を参照してください。

以下は、サンプルアクションを含むレスポンス本文です。

左に曲がるように指定するに 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"
      }
    ]
    }
  }
  ...
]
...