Action
Actionは、ルートの特定の部分で、または特定の部分で行う必要がある処理を指定します。
Actionの例 :
セクション内のAction は、Action、Pre-Action、およびPost-Actionに分けられます。
- Sectionの出発前に、Pre-Actionが実行されます。
- Sectionの到着後に、Post-Actionが実行されます。
- Sectionの出発と到着の間に、Actionが実行されます。
ユーザーは、Sectionの出発と到着の間に、ターンバイターンActionの個別のリストを要求することもできます。 これらの操作には、ターンバイターンガイダンスをサポートするために、各操作の道路情報 ( 道路名や番地など ) も含まれています。
道路名と言語の設定
特定の地域では、道路名と道路番号が複数の言語で利用できます。
道路名と番地は、次の要素で検索できます。
- ターンバイターンアクション :
currentRoad
と nextRoad
の属性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"
}
]
}
}
...
]
...