Route - Get Route Directions
指定した始点と目的地の間のルートを計算し、指定したウェイポイントを通過するには、 を使用します。
Get Route Directions
API は、配信元と宛先の間のルートを返し、指定されている場合はウェイポイントを通過する HTTP GET
要求です。 ルートでは、現在のトラフィックや、要求された曜日と時刻の一般的な道路速度などの要因が考慮されます。
返される情報には、距離、推定移動時間、ルート ジオメトリの表現が含まれます。 選択したオプションに応じて、最適化されたウェイポイント注文やターンバイターン命令などの追加のルーティング情報も利用できます。
ルーティング サービスには、車両固有の消費モデルの詳細な説明に関するパラメーターのセットが用意されています。 詳細については、「 従量課金モデル」を参照してください。
GET https://atlas.microsoft.com/route/directions/{format}?api-version=1.0&query={query}
GET https://atlas.microsoft.com/route/directions/{format}?api-version=1.0&query={query}&maxAlternatives={maxAlternatives}&alternativeType={alternativeType}&minDeviationDistance={minDeviationDistance}&arriveAt={arriveAt}&departAt={departAt}&minDeviationTime={minDeviationTime}&instructionsType={instructionsType}&language={language}&computeBestOrder={computeBestOrder}&routeRepresentation={routeRepresentation}&computeTravelTimeFor={computeTravelTimeFor}&vehicleHeading={vehicleHeading}&report=effectiveSettings§ionType={sectionType}&vehicleAxleWeight={vehicleAxleWeight}&vehicleWidth={vehicleWidth}&vehicleHeight={vehicleHeight}&vehicleLength={vehicleLength}&vehicleMaxSpeed={vehicleMaxSpeed}&vehicleWeight={vehicleWeight}&vehicleCommercial={vehicleCommercial}&windingness={windingness}&hilliness={hilliness}&travelMode={travelMode}&avoid={avoid}&traffic={traffic}&routeType={routeType}&vehicleLoadType={vehicleLoadType}&vehicleEngineType={vehicleEngineType}&constantSpeedConsumptionInLitersPerHundredkm={constantSpeedConsumptionInLitersPerHundredkm}¤tFuelInLiters={currentFuelInLiters}&auxiliaryPowerInLitersPerHour={auxiliaryPowerInLitersPerHour}&fuelEnergyDensityInMJoulesPerLiter={fuelEnergyDensityInMJoulesPerLiter}&accelerationEfficiency={accelerationEfficiency}&decelerationEfficiency={decelerationEfficiency}&uphillEfficiency={uphillEfficiency}&downhillEfficiency={downhillEfficiency}&constantSpeedConsumptionInkWhPerHundredkm={constantSpeedConsumptionInkWhPerHundredkm}¤tChargeInkWh={currentChargeInkWh}&maxChargeInkWh={maxChargeInkWh}&auxiliaryPowerInkW={auxiliaryPowerInkW}
URI パラメーター
名前 | / | 必須 | 型 | 説明 |
---|---|---|---|---|
format
|
path | True |
応答の目的の形式。 値には json または xml のいずれかを指定できます。 |
|
api-version
|
query | True |
string |
Azure Maps API のバージョン番号。 |
query
|
query | True |
string |
コロンで区切られたルートの計算に使用される座標。 少なくとも 2 つの座標が必要です。 1 つ目は配信元、最後はルートの宛先です。 中間のオプションの座標は、ルート内の WayPoint として機能します。 最大 150 個の WayPoint を渡すことができます。 |
acceleration
|
query |
number double |
車両が加速したときに燃料に格納されている化学エネルギーを運動エネルギーに変換する効率を指定します (例: KineticEnergyGained/ChemicalEnergyConsumed)。ChemicalEnergyConsumed は、 fuelEnergyDensityInMJoulesPerLiter を使用して、消費された燃料を化学エネルギーに変換することによって得られます。 減速効率と組み合わせて使用 する必要があります。 使用できる値の範囲は、0.0 から 1/減速効率です。 良識値 : 燃焼モデル の場合 : 0.33, 電気モデル : 0.66 |
|
alternative
|
query |
指定された計画基準に関して、参照ルートと比較して計算された代替案の最適性を制御します。 |
||
arrive
|
query |
string date-time |
RFC 3339 セクション 5.6 で定義されている値として 例 :
パラメーターは |
|
auxiliary
|
query |
number double |
補助システムを維持するために消費される電力の量をキロワット (kW) 単位で指定します。 ACシステム、無線、暖房などのデバイスやシステムによる消費を指定するために使用できます。 賢明な値: 1.7 |
|
auxiliary
|
query |
number double |
車両の補助システムを維持するために消費される燃料の量を 1 時間あたりのリットル単位で指定します。 ACシステム、無線、暖房などのデバイスやシステムによる消費を指定するために使用できます。 賢明な値: 0.2 |
|
avoid
|
query |
ルートの決定時にルート計算で回避する必要のあるものを指定します。 "&avoid=motorways&avoid=tollRoads&avoid=ferrys" など、1 つの要求で複数回指定できます。 ルート範囲要求では、既にUsedRoads の値を使用することはできません。 |
||
compute
|
query |
boolean |
高速ヒューリスティック アルゴリズムを使用してルート ウェイポイントを再順序付けし、ルートの長さを短縮します。 routeType 最短と組み合わせて使用すると 、最適な結果が得られます。 配信元と宛先が最適化されたウェイポイント インデックスから除外されていることに注意してください。 応答に配信元と宛先を含めるには、すべてのインデックスを 1 ずつ増やして配信元を考慮し、最後のインデックスとして宛先を追加してください。 指定できる値は、true または false です。 True の場合、より適切な順序が計算されますが、0 より大きい maxAlternatives 値と組み合わせて使用したり、円のウェイポイントと組み合わせて使用したりすることはできません。 False は指定された順序で場所を使用し、routeRepresentation none と組み合わせて使用することはできません。 |
|
compute
|
query |
さまざまな種類の交通情報 (なし、履歴、ライブ) と既定の最適な推定移動時間を使用して、追加の移動時間を返すかどうかを指定します。 |
||
constant
|
query |
string |
消費の速度に依存するコンポーネントを指定します。 速度と消費レートのペアの順序なしのリストとして提供されます。 この一覧では、消費曲線上のポイントを定義します。 一覧にない速度の従量課金レートは次のとおりです。
リストには 1 ~ 25 ポイント (両端を含む) が含まれている必要があり、同じ速度の重複するポイントが含まれていない可能性があります。 1 つのポイントのみが含まれている場合は、そのポイントの消費率がそれ以上処理されずに使用されます。 最大速度に対して指定される消費量は、最後の最大速度以上である必要があります。 これにより、外挿によって消費率がマイナスにならないことが保証されます。 同様に、一覧の 2 つの最小速度に対して指定された従量課金の値は、速度が小さい場合に負の消費率を招くことはできません。 消費値 (kWh/100km で表される) の有効な範囲は、0.01 から 100000.0 の間です。 賢明な値: 50,8.2:130,21.3 このパラメーターは、 電力消費モデルに必要です。 |
|
constant
|
query |
string |
消費の速度に依存するコンポーネントを指定します。 コロンで区切られた速度 & 従量課金制ペアの順序なしのリストとして提供されます。 この一覧では、消費曲線上のポイントを定義します。 一覧にない速度の従量課金レートは次のとおりです。
リストには 1 ~ 25 ポイント (両端を含む) が含まれている必要があり、同じ速度の重複するポイントが含まれていない可能性があります。 1 つのポイントのみが含まれている場合は、そのポイントの消費率がそれ以上処理されずに使用されます。 最大速度に対して指定される消費量は、最後の最大速度以上である必要があります。 これにより、外挿によって消費率がマイナスにならないことが保証されます。 同様に、一覧の 2 つの最小速度に対して指定された従量課金の値は、速度が小さい場合に負の消費率を招くことはできません。 従量課金値 (l/100km で表される) の有効な範囲は、0.01 から 100000.0 の間です。 賢明な値: 50,6.3:130,11.5 注 : このパラメーターは 、燃焼消費モデルに必要です。 |
|
current
|
query |
number double |
現在の電力供給量をキロワット時 (kWh) 単位で指定します。 このパラメーターは maxChargeInkWh パラメーターと共に存在します。 使用できる値の範囲は、0.0 ~ maxChargeInkWh です。 賢明な値: 43 |
|
current
|
query |
number double |
燃料の現在の供給量をリットル単位で指定します。 賢明な値: 55 |
|
deceleration
|
query |
number double |
車両が減速した場合 (つまり、ChemicalEnergySaved/KineticEnergyLost)、運動エネルギーを節約 (消費されない) 燃料に変換する効率を指定します。ChemicalEnergySaved は、 fuelEnergyDensityInMJoulesPerLiter を使用して、保存された (消費されていない) 燃料をエネルギーに変換することによって取得されます。 accelerationEfficiency とペアにする必要があります。 使用できる値の範囲は、0.0 ~ 1/accelerationEfficiency です。 良識値: 燃焼モデル の場合: 0.83、 電気モデル の場合: 0.91 |
|
depart
|
query |
string date-time |
RFC 3339 セクション 5.6 で定義されている値として
例 :
パラメーターを |
|
downhill
|
query |
number double |
車両が標高を失ったとき (つまり、ChemicalEnergySaved/PotentialEnergyLost) に対して、潜在的なエネルギーを節約 (消費されていない) 燃料に変換する効率を指定します。ChemicalEnergySaved は、 fuelEnergyDensityInMJoulesPerLiter を使用して、保存された (消費されていない) 燃料をエネルギーに変換することによって取得されます。 uphillEfficiency とペアにする必要があります。 使用できる値の範囲は 0.0 ~ 1/uphillEfficiency です。 良識値 : 燃焼モデル の場合 : 0.51, 電気モデル : 0.73 |
|
fuel
|
query |
number double |
メガジュール (MJ) 内の 1 リットルの燃料に格納される化学エネルギーの量を指定します。 これは、保存または消費されたエネルギーと燃料の間の変換のために*効率 パラメータと組み合わせて使用されます。 たとえば、エネルギー密度はガソリンの場合は 34.2 MJ/l、ディーゼル燃料の場合は 35.8 MJ/l です。 *Efficiency パラメーターが設定されている場合は、このパラメーターが必要です。 賢明な値: 34.2 |
|
hilliness
|
query |
スリリングなルートのためのヒルネスの程度。 このパラメーターは、=thrilling と |
||
instructions
|
query |
指定した場合は、ガイダンスの手順が返されます。 instructionsType パラメーターは routeRepresentation=none と組み合わせて使用できないことに注意してください |
||
language
|
query |
string |
language パラメーターは、ガイダンス メッセージの言語を決定します。 固有名詞 (通り、広場などの名前) は、指定された言語で返されます。使用できない場合は、それに近い使用可能な言語で返されます。 使用できる値は、IETF 言語タグ (のサブセット) です。 現在サポートされている言語は、「サポートされている言語」 セクションに一覧表示されています。 既定値: en-GB |
|
max
|
query |
integer |
計算する必要な代替ルートの数。 既定値: 0、最小: 0、最大: 5 |
|
max
|
query |
number double |
車両のバッテリーに格納できる最大電力供給量をキロワット時 (kWh) 単位で指定します。 このパラメーターは currentChargeInkWh パラメーターと共に存在します。 最小値は currentChargeInkWh 以上である必要があります。 賢明な値: 85 |
|
min
|
query |
integer |
返されるすべての代替ルートは、少なくともこのメーター数の calculateRoute 要求の起点からの参照ルート (POST 要求に関するセクションを参照) に従います。 ルートを再構築する場合にのみ使用できます。 minDeviationDistance パラメーターを arriveAt と組み合わせて使用することはできません |
|
min
|
query |
integer |
返されるすべての代替ルートは、少なくともこの秒数だけ calculateRoute 要求の起点からの参照ルート (POST 要求に関するセクションを参照) に従います。 ルートを再構築する場合にのみ使用できます。 minDeviationTime パラメーターは、arriveAt と組み合わせて使用することはできません。 既定値は 0 です。 )minDeviationTime_を 0 より大きい値に設定すると、次のような結果になります。
|
|
report
|
query |
診断目的で報告するデータを指定します。 有効な値は effectiveSettings のみです。 API を呼び出すときに使用される有効なパラメーターまたはデータを報告します。 既定のパラメーターの場合、パラメーターが呼び出し元によって指定されなかった場合、既定値が反映されます。 |
||
route
|
query |
応答として提供されるルートのセットの表現を指定します。 このパラメーター値は、computeBestOrder=true と組み合わせてのみ使用できます。 |
||
route
|
query |
要求されたルートの種類。 |
||
section
|
query |
ルート応答で報告されるセクションの種類を指定します。 |
||
traffic
|
query |
boolean |
指定できる値
|
|
travel
|
query |
要求されたルートの移動モード。 定義されていない場合、既定値は 'car' です。 要求された travelMode がルート全体で使用できない場合があることに注意してください。 要求された travelMode が特定のセクションで使用できない場合、そのセクションの応答の travelMode 要素は "other" になります。 移動モードバス、オートバイ、タクシー、バンはベータ機能であることに注意してください。 すべての領域で完全な制限データを使用できるわけではありません。 |
||
uphill
|
query |
number double |
車両が昇格したときに、燃料に格納されている化学エネルギーを潜在的なエネルギーに変換する効率を指定します (つまり、PotentialEnergyGained/ChemicalEnergyConsumed)。ChemicalEnergyConsumed は、 fuelEnergyDensityInMJoulesPerLiter を使用して、消費された燃料を化学エネルギーに変換することによって得られます。 ダウンヒル効率性と組み合わせて使用する必要があります。 使用できる値の範囲は 0.0 ~ 1/分の 1 です。非効率性です。 良識値 : 燃焼モデル の場合 : 0.27, 電気モデル : 0.74 |
|
vehicle
|
query |
integer |
車両の車軸あたりの重量 (kg)。 値が 0 の場合、車軸あたりの重量制限は考慮されません。 |
|
vehicle
|
query |
boolean |
車両が商用目的で使用されているかどうか。 一部の道路では、商用車両の運転が許可されない場合があります。 |
|
vehicle
|
query |
車両のエンジンタイプ。 詳細な従量課金モデルを指定する場合は、 vehicleEngineType の値と一致している必要があります。 |
||
vehicle
|
query |
integer |
真北から時計回りの方向に進む車両の方向見出しを度単位で指定します。 北は 0 度、東は 90 度、南は 180 度、西は 270 度です。 使用可能な値 0 から 359 |
|
vehicle
|
query |
number double |
車両の高さ (メートル単位)。 値が 0 の場合、高さの制限は考慮されません。 |
|
vehicle
|
query |
number double |
車両の長さ (メートル単位)。 値が 0 の場合、長さの制限は考慮されません。 |
|
vehicle
|
query |
危険物として分類され、一部の道路から制限される可能性のある貨物の種類。 使用可能な vehicleLoadType 値は、US Hazmat クラス 1 から 9 に加えて、他の国/地域で使用するための一般的な分類です。 USHazmat で始まる値は米国のルーティング用ですが、otherHazmat は他のすべての国/地域に使用する必要があります。 vehicleLoadType は複数回指定できます。 このパラメーターは現在、travelMode=truck でのみ考慮されています。 |
||
vehicle
|
query |
integer |
km/時間の車両の最高速度。 車両プロファイルの最大速度は、高速道路で車両が許可されているかどうかをチェックするために使用されます。
|
|
vehicle
|
query |
integer |
車両の重量 (kg 単位)。
賢明な値 : 燃焼モデル の場合 : 1600, 電気モデル : 1900 |
|
vehicle
|
query |
number double |
車両の幅 (メートル単位)。 値が 0 の場合、幅の制限は考慮されません。 |
|
windingness
|
query |
スリリングなルートのためのターンのレベル。 このパラメーターは、=thrilling と |
要求ヘッダー
名前 | 必須 | 型 | 説明 |
---|---|---|---|
x-ms-client-id |
string |
Microsoft Entra ID セキュリティ モデルと組み合わせて使用するアカウントを指定します。 Azure Maps アカウントの一意の ID を表し、Azure Maps管理プレーン アカウント API から取得できます。 Azure MapsでMicrosoft Entra IDセキュリティを使用するには、次の記事を参照してください。 |
応答
名前 | 型 | 説明 |
---|---|---|
200 OK |
OK |
|
Other Status Codes |
予期しないエラーが発生しました。 |
セキュリティ
AADToken
これらは OAuth 2.0 フロー Microsoft Entraです。 Azure ロールベースのアクセス制御と組み合わせて使用すると、Azure Maps REST API へのアクセスを制御できます。 Azure ロールベースのアクセス制御は、1 つ以上のAzure Mapsリソース アカウントまたはサブリソースへのアクセスを指定するために使用されます。 REST API に対する 1 つ以上のアクセス許可で構成される組み込みロールまたはカスタム ロールを使用して、任意のユーザー、グループ、またはサービス プリンシパルにアクセス権 Azure Mapsを付与できます。
シナリオを実装するには、 認証の概念を表示することをお勧めします。 要約すると、このセキュリティ定義は、特定の API とスコープに対するアクセス制御が可能なオブジェクトを使用してアプリケーションをモデル化するためのソリューションを提供します。
メモ
- このセキュリティ定義では、 ヘッダーを使用して、
x-ms-client-id
アプリケーションがアクセスを要求しているリソースAzure Maps示す必要があります。 これは、 Maps 管理 API から取得できます。
Authorization URL
は、Azure パブリック クラウド インスタンスに固有です。 ソブリン クラウドには、固有の承認 URL とMicrosoft Entra ID構成があります。
* Azure ロールベースのアクセス制御は、Azure portal、PowerShell、CLI、Azure SDK、または REST API を介して Azure 管理プレーンから構成されます。
* Azure Maps Web SDK を使用すると、複数のユース ケースに対してアプリケーションを構成ベースで設定できます。
- Microsoft ID プラットフォームの詳細については、「Microsoft ID プラットフォームの概要」を参照してください。
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
名前 | 説明 |
---|---|
https://atlas.microsoft.com/.default | https://atlas.microsoft.com/.default |
subscription-key
これは、Azure portalでAzure Maps アカウントをCreateするとき、または PowerShell、CLI、Azure SDK、または REST API を使用するときにプロビジョニングされる共有キーです。
このキーを使用すると、すべてのアプリケーションがすべての REST API にアクセスできます。 つまり、このキーは、発行されたアカウントのマスター キーとして使用できます。
公開されているアプリケーションの場合は、機密クライアント アプリケーションのアプローチを使用して、キーを安全に格納できるように、Azure Maps REST API にアクセスすることをお勧めします。
Type:
apiKey
In:
query
SAS Token
これは、Azure portal、PowerShell、CLI、Azure SDK、または REST API を介して、Azure 管理プレーンを介して、Azure Maps リソースの List SAS 操作から作成される共有アクセス署名トークンです。
このトークンを使用すると、すべてのアプリケーションが Azure ロールベースのアクセス制御を使用してアクセスし、特定のトークンに使用される有効期限、レート、およびリージョンをきめ細かく制御できます。 つまり、SAS トークンを使用して、アプリケーションが共有キーよりもセキュリティで保護された方法でアクセスを制御できるようにします。
公開されているアプリケーションの場合、 Map アカウント リソース で許可される配信元の特定の一覧を構成して、レンダリングの不正使用を制限し、SAS トークンを定期的に更新することをお勧めします。
Type:
apiKey
In:
header
例
Successfully retrieve a route between an origin and a destination
Sample Request
GET https://atlas.microsoft.com/route/directions/json?api-version=1.0&query=52.50931,13.42936:52.50274,13.43872&report=effectiveSettings
Sample Response
{
"formatVersion": "0.0.12",
"routes": [
{
"summary": {
"lengthInMeters": 1147,
"travelTimeInSeconds": 162,
"trafficDelayInSeconds": 0,
"departureTime": "2017-09-07T16:56:58+00:00",
"arrivalTime": "2017-09-07T16:59:40+00:00"
},
"legs": [
{
"summary": {
"lengthInMeters": 1147,
"travelTimeInSeconds": 162,
"trafficDelayInSeconds": 0,
"departureTime": "2017-09-07T16:56:58+00:00",
"arrivalTime": "2017-09-07T16:59:40+00:00"
},
"points": [
{
"latitude": 52.50931,
"longitude": 13.42937
},
{
"latitude": 52.50904,
"longitude": 13.42912
},
{
"latitude": 52.50894,
"longitude": 13.42904
},
{
"latitude": 52.50867,
"longitude": 13.42879
},
{
"latitude": 52.5084,
"longitude": 13.42857
},
{
"latitude": 52.50791,
"longitude": 13.42824
},
{
"latitude": 52.50757,
"longitude": 13.42772
},
{
"latitude": 52.50735,
"longitude": 13.42823
},
{
"latitude": 52.5073,
"longitude": 13.42836
},
{
"latitude": 52.50573,
"longitude": 13.43194
},
{
"latitude": 52.50512,
"longitude": 13.43336
},
{
"latitude": 52.50464,
"longitude": 13.43451
},
{
"latitude": 52.5045,
"longitude": 13.43481
},
{
"latitude": 52.50443,
"longitude": 13.43498
},
{
"latitude": 52.50343,
"longitude": 13.43737
},
{
"latitude": 52.50274,
"longitude": 13.43872
}
]
}
],
"sections": [
{
"startPointIndex": 0,
"endPointIndex": 15,
"sectionType": "TRAVEL_MODE",
"travelMode": "car"
}
]
}
]
}
定義
名前 | 説明 |
---|---|
Alternative |
指定された計画基準に関して、参照ルートと比較して計算された代替案の最適性を制御します。 |
Compute |
さまざまな種類の交通情報 (なし、履歴、ライブ) と既定の最適な推定移動時間を使用して、追加の移動時間を返すかどうかを指定します。 |
Delay |
インシデントによって引き起こされる遅延の大きさ。 これらの値は、 トラフィック インシデント詳細の取得 API の応答フィールド ty の値に対応します。 |
Driving |
操縦のポイントで左手と右側の運転を示します。 |
Effective |
このルート API を呼び出すときに使用される有効なパラメーターまたはデータ。 |
Error |
リソース管理エラーの追加情報。 |
Error |
エラーの詳細。 |
Error |
エラー応答 |
Guidance |
指示の種類、例えば、道路形態のターンまたは変更。 |
Guidance |
操縦を識別するコード。 |
Incline |
スリリングなルートのためのヒルネスの程度。 このパラメーターは、=thrilling と |
Junction |
操縦が行われるジャンクションの種類。 より大きなラウンドアバウト交差点の場合、ラウンドアバウト交差点への入退出に対して 2 つの個別の命令が生成されます。 |
Lat |
緯度と経度として表される場所。 |
Report |
診断目的で報告するデータを指定します。 有効な値は effectiveSettings のみです。 API を呼び出すときに使用される有効なパラメーターまたはデータを報告します。 既定のパラメーターの場合、パラメーターが呼び出し元によって指定されなかった場合、既定値が反映されます。 |
Response |
応答の目的の形式。 値には json または xml のいずれかを指定できます。 |
Response |
報告されたルート応答のセクションの種類 |
Response |
計算されたルートの移動モード。 このセクションで要求されたトランスポート モードが不可能な場合、値は に設定 |
Route | |
Route |
ルートの決定時にルート計算で回避する必要のあるものを指定します。 "&avoid=motorways&avoid=tollRoads&avoid=ferrys" など、1 つの要求で複数回指定できます。 ルート範囲要求では、既にUsedRoads の値を使用することはできません。 |
Route |
このオブジェクトは、ルート方向の呼び出しが成功した場合に返されます |
Route |
ガイダンス関連の要素が含まれています。 このフィールドは、ガイダンスが要求され、使用可能な場合にのみ表示されます。 |
Route |
操縦を記述する属性のセット。たとえば、"右折"、"左に保つ"、"フェリーに乗る"、"高速道路に乗る"、"到着" などです。 |
Route |
相互に関連する命令要素のシーケンスをグループします。 シーケンス範囲は、firstInstructionIndex と lastInstructionIndex で制約されます。 人間が判読できるテキスト メッセージにガイダンス (instructionType=text またはタグ付け) が要求されると、instructionGroup には、使用可能な場合に概要メッセージが返されます。 |
Route |
指定した場合は、ガイダンスの手順が返されます。 instructionsType パラメーターは routeRepresentation=none と組み合わせて使用できないことに注意してください |
Route |
ポイントのリストで構成されるルートの一部の説明。 要求で指定された追加の各ウェイポイントは、返されるルートに追加の区間になります。 |
Route |
ルート セクションの概要オブジェクト。 |
Route |
最適化されたウェイ ポイント オブジェクト。 |
Route |
現在の呼び出しで使用されている有効な設定を報告します。 |
Route |
応答として提供されるルートのセットの表現を指定します。 このパラメーター値は、computeBestOrder=true と組み合わせてのみ使用できます。 |
Route |
ルート セクションには、ルートの一部に関する追加情報が含まれています。 各セクションには、少なくとも 要素 |
Route |
TPEG2-TEC 標準の定義を使用したトラフィック イベントの詳細。 effectCode を含め、要素を引き起こすことができます。 |
Route |
トラフィック イベントの原因。 mainCauseCode 要素と subCauseCode 要素を含めることができます。 アイコンと説明を定義するために使用できます。 |
Route |
Summary オブジェクト |
Route |
要求されたルートの種類。 |
Section |
ルート応答で報告されるセクションの種類を指定します。 |
Simple |
インシデントの種類。 現在、JAM、ROAD_WORK、ROAD_CLOSURE、またはその他を指定できます。 詳細については、「tec」を参照してください。 |
Travel |
要求されたルートの移動モード。 定義されていない場合、既定値は 'car' です。 要求された travelMode がルート全体で使用できない場合があることに注意してください。 要求された travelMode が特定のセクションで使用できない場合、そのセクションの応答の travelMode 要素は "other" になります。 移動モードバス、オートバイ、タクシー、バンはベータ機能であることに注意してください。 すべての領域で完全な制限データを使用できるわけではありません。 |
Vehicle |
車両のエンジンタイプ。 詳細な従量課金モデルを指定する場合は、 vehicleEngineType の値と一致している必要があります。 |
Vehicle |
危険物として分類され、一部の道路から制限される可能性のある貨物の種類。 使用可能な vehicleLoadType 値は、US Hazmat クラス 1 から 9 に加えて、他の国/地域で使用するための一般的な分類です。 USHazmat で始まる値は米国のルーティング用ですが、otherHazmat は他のすべての国/地域に使用する必要があります。 vehicleLoadType は複数回指定できます。 このパラメーターは現在、travelMode=truck でのみ考慮されています。 |
Windingness |
スリリングなルートのためのターンのレベル。 このパラメーターは、=thrilling と |
AlternativeRouteType
指定された計画基準に関して、参照ルートと比較して計算された代替案の最適性を制御します。
名前 | 型 | 説明 |
---|---|---|
anyRoute |
string |
最適性の観点から、参照ルートと比較する方法に関係なく、任意の代替ルートを返すようにします。 |
betterRoute |
string |
指定された計画基準に従って参照ルートよりも優れている場合にのみ、代替ルートを返します。 |
ComputeTravelTime
さまざまな種類の交通情報 (なし、履歴、ライブ) と既定の最適な推定移動時間を使用して、追加の移動時間を返すかどうかを指定します。
名前 | 型 | 説明 |
---|---|---|
all |
string |
すべての種類の交通情報の移動時間を計算し、ルート応答の概要に含まれるフィールド noTrafficTravelTimeInSeconds、historicTrafficTravelTimeInSeconds、liveTrafficIncidentsTravelTimeInSeconds のすべての結果を指定します。 |
none |
string |
追加の移動時間を計算しません。 |
DelayMagnitude
インシデントによって引き起こされる遅延の大きさ。 これらの値は、 トラフィック インシデント詳細の取得 API の応答フィールド ty の値に対応します。
名前 | 型 | 説明 |
---|---|---|
0 |
string |
不明。 |
1 |
string |
マイナー。 |
2 |
string |
中程度。 |
3 |
string |
メジャー。 |
4 |
string |
未定義。道路閉鎖やその他の不定遅延に使用されます。 |
DrivingSide
操縦のポイントで左手と右側の運転を示します。
名前 | 型 | 説明 |
---|---|---|
LEFT |
string |
左側。 |
RIGHT |
string |
右側。 |
EffectiveSetting
このルート API を呼び出すときに使用される有効なパラメーターまたはデータ。
名前 | 型 | 説明 |
---|---|---|
key |
string |
使用されるパラメーターの名前。 |
value |
string |
使用されるパラメーターの値。 |
ErrorAdditionalInfo
リソース管理エラーの追加情報。
名前 | 型 | 説明 |
---|---|---|
info |
object |
追加情報。 |
type |
string |
追加情報の種類。 |
ErrorDetail
エラーの詳細。
名前 | 型 | 説明 |
---|---|---|
additionalInfo |
エラーの追加情報。 |
|
code |
string |
エラー コード。 |
details |
エラーの詳細です。 |
|
message |
string |
エラー メッセージ。 |
target |
string |
エラーのターゲット。 |
ErrorResponse
エラー応答
名前 | 型 | 説明 |
---|---|---|
error |
error オブジェクト。 |
GuidanceInstructionType
指示の種類、例えば、道路形態のターンまたは変更。
名前 | 型 | 説明 |
---|---|---|
DIRECTION_INFO |
string |
方向情報。 |
LOCATION_ARRIVAL |
string |
到着場所。 |
LOCATION_DEPARTURE |
string |
出発場所。 |
LOCATION_WAYPOINT |
string |
ウェイ ポイントの位置。 |
ROAD_CHANGE |
string |
道路の変更。 |
TURN |
string |
ターンします。 |
GuidanceManeuver
操縦を識別するコード。
名前 | 型 | 説明 |
---|---|---|
ARRIVE |
string |
到着しました。 |
ARRIVE_LEFT |
string |
到着しました。 宛先は左側にあります。 |
ARRIVE_RIGHT |
string |
到着しました。 目的地が右側にあります。 |
BEAR_LEFT |
string |
左のクマ。 |
BEAR_RIGHT |
string |
権利を持つ。 |
DEPART |
string |
残す。 |
ENTER_FREEWAY |
string |
高速道路に乗ります。 |
ENTER_HIGHWAY |
string |
高速道路に乗ります。 |
ENTER_MOTORWAY |
string |
高速道路に乗ります。 |
ENTRANCE_RAMP |
string |
ランプを取る。 |
FOLLOW |
string |
従う。 |
KEEP_LEFT |
string |
左に置きます。 |
KEEP_RIGHT |
string |
右に置く。 |
MAKE_UTURN |
string |
U ターンを行います。 |
MOTORWAY_EXIT_LEFT |
string |
左側の出口を出ます。 |
MOTORWAY_EXIT_RIGHT |
string |
右の出口に出ます。 |
ROUNDABOUT_BACK |
string |
ラウンドアバウトを回る。 |
ROUNDABOUT_CROSS |
string |
ラウンドアバウト交差点を渡る。 |
ROUNDABOUT_LEFT |
string |
ラウンドアバウトで左側の出口を出ます。 |
ROUNDABOUT_RIGHT |
string |
ラウンドアバウトで右側の出口を出ます。 |
SHARP_LEFT |
string |
左に鋭く曲がります。 |
SHARP_RIGHT |
string |
右に鋭く回転します。 |
STRAIGHT |
string |
そのままにしておきます。 |
SWITCH_MAIN_ROAD |
string |
メイン道路に切り替えます。 |
SWITCH_PARALLEL_ROAD |
string |
平行道路に切り替えます。 |
TAKE_EXIT |
string |
終了します。 |
TAKE_FERRY |
string |
フェリーに乗る。 |
TRY_MAKE_UTURN |
string |
U ターンを試します。 |
TURN_LEFT |
string |
左に曲がります。 |
TURN_RIGHT |
string |
右折します。 |
WAYPOINT_LEFT |
string |
ウェイポイントに到達しました。 左側にあります。 |
WAYPOINT_REACHED |
string |
ウェイポイントに到達しました。 |
WAYPOINT_RIGHT |
string |
ウェイポイントに到達しました。 右側にあります。 |
InclineLevel
スリリングなルートのためのヒルネスの程度。 このパラメーターは、=thrilling と routeType
組み合わせてのみ使用できます。
名前 | 型 | 説明 |
---|---|---|
high |
string |
high |
low |
string |
low |
normal |
string |
普通 |
JunctionType
操縦が行われるジャンクションの種類。 より大きなラウンドアバウト交差点の場合、ラウンドアバウト交差点への入退出に対して 2 つの個別の命令が生成されます。
名前 | 型 | 説明 |
---|---|---|
BIFURCATION |
string |
分岐 |
REGULAR |
string |
レギュラー |
ROUNDABOUT |
string |
ロータリー |
LatLongPair
緯度と経度として表される場所。
名前 | 型 | 説明 |
---|---|---|
latitude |
number |
Latitude プロパティ |
longitude |
number |
Longitude プロパティ |
Report
診断目的で報告するデータを指定します。 有効な値は effectiveSettings のみです。 API を呼び出すときに使用される有効なパラメーターまたはデータを報告します。 既定のパラメーターの場合、パラメーターが呼び出し元によって指定されなかった場合、既定値が反映されます。
名前 | 型 | 説明 |
---|---|---|
effectiveSettings |
string |
API を呼び出すときに使用される有効なパラメーターまたはデータを報告します。 |
ResponseFormat
応答の目的の形式。 値には json または xml のいずれかを指定できます。
名前 | 型 | 説明 |
---|---|---|
json |
string |
|
xml |
string |
ResponseSectionType
報告されたルート応答のセクションの種類
名前 | 型 | 説明 |
---|---|---|
CARPOOL |
string |
カープール(HOV/高占有車)レーンの使用を必要とするルートのセクション。 |
CAR_TRAIN |
string |
車または電車であるルートのセクション。 |
COUNTRY |
string |
ルートが含まれる国/地域を示すセクション。 |
FERRY |
string |
フェリーであるルートのセクション。 |
MOTORWAY |
string |
高速道路であるルートのセクション。 |
PEDESTRIAN |
string |
歩行者にのみ適したルートのセクション。 |
TOLL_ROAD |
string |
通行料の支払いが必要なルートのセクション。 |
TOLL_VIGNETTE |
string |
有料ビネットが存在する必要があるルートのセクション。 |
TRAFFIC |
string |
トラフィック情報を含むルートのセクション。 |
TRAVEL_MODE |
string |
要求パラメーター |
TUNNEL |
string |
トンネルであるルートのセクション。 |
URBAN |
string |
都市部に位置するルートのセクション。 |
ResponseTravelMode
計算されたルートの移動モード。 このセクションで要求されたトランスポート モードが不可能な場合、値は に設定 other
されます
名前 | 型 | 説明 |
---|---|---|
bicycle |
string |
返されるルートは、自転車レーンの使用を含め、自転車用に最適化されています。 |
bus |
string |
返されるルートは、バス専用レーンの使用を含め、バス用に最適化されています。 BETA 機能。 |
car |
string |
返されるルートは、車用に最適化されています。 |
motorcycle |
string |
返されるルートはオートバイ用に最適化されています。 BETA 機能。 |
other |
string |
このセクションでは、指定されたトランスポート モードを使用できません |
pedestrian |
string |
返されたルートは、歩道の使用を含め、歩行者向けに最適化されています。 |
taxi |
string |
返されるルートはタクシー用に最適化されています。 BETA 機能。 |
truck |
string |
返されるルートは、トラックなどの商用車両用に最適化されています。 |
van |
string |
返されるルートはバン用に最適化されています。 BETA 機能。 |
Route
名前 | 型 | 説明 |
---|---|---|
guidance |
ガイダンス関連の要素が含まれています。 このフィールドは、ガイダンスが要求され、使用可能な場合にのみ表示されます。 |
|
legs |
Route |
脚の配列 |
sections |
Sections 配列 |
|
summary |
Summary オブジェクト |
RouteAvoidType
ルートの決定時にルート計算で回避する必要のあるものを指定します。 "&avoid=motorways&avoid=tollRoads&avoid=ferrys" など、1 つの要求で複数回指定できます。 ルート範囲要求では、既にUsedRoads の値を使用することはできません。
名前 | 型 | 説明 |
---|---|---|
alreadyUsedRoads |
string |
同じ道路を複数回使用しないようにします。 =スリリングと |
borderCrossings |
string |
ルート計算で境界線の交差を回避します。 |
carpools |
string |
カープール(HOV/高占有車)レーンの使用を必要とするルートを回避します。 |
ferries |
string |
フェリーを避ける |
motorways |
string |
高速道路を避ける |
tollRoads |
string |
有料道路を回避します。 |
unpavedRoads |
string |
未舗装道路を回避する |
RouteDirections
このオブジェクトは、ルート方向の呼び出しが成功した場合に返されます
名前 | 型 | 説明 |
---|---|---|
formatVersion |
string |
Format Version プロパティ |
optimizedWaypoints |
ウェイポイントの最適化されたシーケンス。 元の最適化されたリストに対してユーザーが指定したウェイポイント シーケンスからのインデックスが表示されます。 たとえば、応答は次のようになります。
は、元のシーケンスが [0, 1, 2] であり、最適化されたシーケンスが [1, 2, 0] であることを意味します。 インデックスは 0 で始まるので、元の は "first, second, third" ですが、最適化は "second, third, first" です。 |
|
report |
現在の呼び出しで使用されている有効な設定を報告します。 |
|
routes |
Route[] |
Routes 配列 |
RouteGuidance
ガイダンス関連の要素が含まれています。 このフィールドは、ガイダンスが要求され、使用可能な場合にのみ表示されます。
名前 | 型 | 説明 |
---|---|---|
instructionGroups |
相互に関連する命令要素のシーケンスをグループします。 |
|
instructions |
操作を記述する命令の一覧。 |
RouteInstruction
操縦を記述する属性のセット。たとえば、"右折"、"左に保つ"、"フェリーに乗る"、"高速道路に乗る"、"到着" などです。
名前 | 型 | 説明 |
---|---|---|
combinedMessage |
string |
操作のための人間が判読できるメッセージと、次の命令からのメッセージを組み合わせたもの。 2 つの連続する命令を 1 つの命令に組み合わせて、簡単に従うことができる場合があります。 この場合、possibleCombineWithNext フラグは true になります。 例:
命令 10 の possibleCombineWithNext フラグは true です。 これは、コード化されたガイダンスのクライアントに対して、命令 11 と組み合わせることができることを示します。 この手順は、人間が判読できるガイダンスを要求しているクライアントに対して自動的に組み合わされます。 combinedMessage フィールドには、結合されたメッセージが含まれています。
|
countryCode |
string |
3 文字の ISO 3166-1 alpha-3 国コード。 例: 米国 |
drivingSide |
操縦のポイントで左手と右側の運転を示します。 |
|
exitNumber |
string |
現在の操縦によって取得された高速道路の出口の数。 出口に複数の終了番号がある場合、それらは "" で区切られ、"-" で集計される場合があります (例: "10,13-15")。 |
instructionType |
指示の種類、例えば、道路形態のターンまたは変更。 |
|
junctionType |
操縦が行われるジャンクションの種類。 より大きなラウンドアバウト交差点の場合、ラウンドアバウト交差点への入退出に対して 2 つの個別の命令が生成されます。 |
|
maneuver |
操縦を識別するコード。 |
|
message |
string |
操縦のための人間読み取り可能なメッセージ。 |
point |
緯度と経度として表される場所。 |
|
pointIndex |
integer |
命令のポイントに対応するポリラインの "ポイント" のリスト内のポイントのインデックス。 |
possibleCombineWithNext |
boolean |
必要に応じて、命令を次の命令と組み合わせることができます。 これは、"左に曲がって右に曲がる" などのメッセージを作成するために使用できます。 |
roadNumbers |
string[] |
操縦後の次に重要な道路セグメントの道路番号、または従う道路の道路番号。 例: ["E34", "N205"] |
roundaboutExitNumber |
string |
これは、ラウンドアバウトで実行する出口を示します。 |
routeOffsetInMeters |
integer |
ルートの開始から命令のポイントまでの距離。 |
signpostText |
string |
操縦または従うべき方向に最も関連する道標のテキスト。 |
stateCode |
string |
ISO 3166-2 コードの 2 番目の部分で表される国の下位区分 (州など)。 これは、米国、カナダ、メキシコなどの一部の国/地域でのみ使用できます。 |
street |
string |
操縦の後の次の重要な道路セグメントの通り名、または従う必要がある通りの通りの名前。 |
travelTimeInSeconds |
integer |
routeOffsetInMeters に対応するポイントまでの推定移動時間。 |
turnAngleInDecimalDegrees |
integer |
命令の方向を示します。 junctionType がターン命令を示す場合:
junctionType が分岐命令を示す場合:
|
RouteInstructionGroup
相互に関連する命令要素のシーケンスをグループします。 シーケンス範囲は、firstInstructionIndex と lastInstructionIndex で制約されます。 人間が判読できるテキスト メッセージにガイダンス (instructionType=text またはタグ付け) が要求されると、instructionGroup には、使用可能な場合に概要メッセージが返されます。
名前 | 型 | 説明 |
---|---|---|
firstInstructionIndex |
integer |
命令内の最初の命令のインデックスと、このグループに属しています。 |
groupLengthInMeters |
integer |
グループの長さ。 |
groupMessage |
string |
人間が読み取り可能なテキスト メッセージにガイダンスを求められた場合の概要メッセージ (instructionType=text またはタグ付け)。 |
lastInstructionIndex |
integer |
命令の最後の命令のインデックスで、このグループに属しています。 |
RouteInstructionsType
指定した場合は、ガイダンスの手順が返されます。 instructionsType パラメーターは routeRepresentation=none と組み合わせて使用できないことに注意してください
名前 | 型 | 説明 |
---|---|---|
coded |
string |
人間が判読できるメッセージを含まない生の命令データを返します。 |
tagged |
string |
書式設定を許可するために、人間が判読できるタグ付きメッセージを含む未加工の命令データを返します。 人間が判読できるメッセージは、繰り返し可能な識別された要素から構築されます。 これらは、クライアント アプリケーションが正しく書式設定できるようにタグ付けされています。 instructionsType=tagged: street、roadNumber、signpostText、exitNumber、roundaboutExitNumber の場合、次のメッセージ コンポーネントにタグが付けられます。 タグ付けされた 'Turn left' メッセージの例:
|
text |
string |
人間が判読できるメッセージを含む生の命令データをプレーン テキストで返します。 |
RouteLeg
ポイントのリストで構成されるルートの一部の説明。 要求で指定された追加の各ウェイポイントは、返されるルートに追加の区間になります。
名前 | 型 | 説明 |
---|---|---|
points |
Points 配列 |
|
summary |
ルート セクションの概要オブジェクト。 |
RouteLegSummary
ルート セクションの概要オブジェクト。
名前 | 型 | 説明 |
---|---|---|
arrivalTime |
string |
ルートまたは区間の推定到着時間。 時刻は UTC です。 |
batteryConsumptionInkWh |
number |
電力消費量モデルを使用したキロワット時 (kWh) の推定電力消費量。 vehicleEngineType が電気に設定され、constantSpeedConsumptionInkWhPerHundredkm が指定されている場合に含まれます。 batteryConsumptionInkWh の値には再計算された電気エネルギーが含まれているため、負の値 (エネルギーの増加を示します) にすることができます。 maxChargeInkWh と currentChargeInkWh の両方を指定すると、バッテリの充電レベルが maxChargeInkWh を超えないようにするために、再循環が制限されます。 maxChargeInkWh も currentChargeInkWh も指定されていない場合、従量課金の計算では制約のない回復が想定されます。 |
departureTime |
string |
ルートまたは区間の推定出発時間。 時刻は UTC です。 |
fuelConsumptionInLiters |
number |
燃焼消費モデルを使用した推定燃料消費量 (リットル単位)。 vehicleEngineType が 燃焼 に設定され、constantSpeedConsumptionInLitersPerHundredkm が指定されている場合に含まれます。 値は負以外になります。 |
historicTrafficTravelTimeInSeconds |
integer |
時間に依存する履歴トラフィック データを使用して計算された推定移動時間。 computeTravelTimeFor = all がクエリで使用されている場合にのみ含まれます。 |
lengthInMeters |
integer |
Length In Meters プロパティ |
liveTrafficIncidentsTravelTimeInSeconds |
integer |
リアルタイム速度データを使用して計算された推定移動時間。 computeTravelTimeFor = all がクエリで使用されている場合にのみ含まれます。 |
noTrafficTravelTimeInSeconds |
integer |
交通状況 (輻輳など) により、ルートに遅延がないかのように計算された推定移動時間。 computeTravelTimeFor = all がクエリで使用されている場合にのみ含まれます。 |
trafficDelayInSeconds |
integer |
トラフィック情報に従って、リアルタイム インシデントによって発生した推定遅延 (秒単位)。 将来出発時刻が予定されているルートの場合、遅延は常に 0 になります。 さまざまな種類のトラフィック情報を使用して追加の移動時間を返すには、パラメーター computeTravelTimeFor=all を追加する必要があります。 |
travelTimeInSeconds |
integer |
リアルタイム トラフィックによる遅延を含む推定移動時間 (秒) プロパティ。 traffic=false travelTimeInSeconds の場合でも、トラフィックによる遅延が含まれていることに注意してください。 DepartAt が将来の場合、移動時間は時間に依存する履歴トラフィック データを使用して計算されます。 |
RouteOptimizedWaypoint
最適化されたウェイ ポイント オブジェクト。
名前 | 型 | 説明 |
---|---|---|
optimizedIndex |
integer |
システムからの最適化されたウェイ ポイント インデックス。 |
providedIndex |
integer |
ユーザーによって提供されるウェイ ポイント インデックス。 |
RouteReport
現在の呼び出しで使用されている有効な設定を報告します。
名前 | 型 | 説明 |
---|---|---|
effectiveSettings |
このルート API を呼び出すときに使用される有効なパラメーターまたはデータ。 |
RouteRepresentationForBestOrder
応答として提供されるルートのセットの表現を指定します。 このパラメーター値は、computeBestOrder=true と組み合わせてのみ使用できます。
名前 | 型 | 説明 |
---|---|---|
none |
string |
最適化されたウェイポイント インデックスのみが含まれますが、応答にルート ジオメトリは含まれません。 |
polyline |
string |
応答にルート ジオメトリを含めます。 |
summaryOnly |
string |
ポリラインに従って要約しますが、応答内のルートのポイント ジオメトリ要素を除きます。 |
RouteSection
ルート セクションには、ルートの一部に関する追加情報が含まれています。 各セクションには、少なくとも 要素 startPointIndex
、、 endPointIndex
および sectionType
が含まれています。
名前 | 型 | 説明 |
---|---|---|
delayInSeconds |
integer |
インシデントによって発生する遅延 (秒単位)。 |
effectiveSpeedInKmh |
integer |
インシデントの有効速度 (km/h) は、その全体の長さの平均です。 |
endPointIndex |
integer |
このセクションが適用されるルートの最後のポイント (オフセット 0) のインデックス。 |
magnitudeOfDelay |
インシデントによって発生する遅延の大きさ。 これらの値は、 トラフィック インシデント詳細の取得 API の応答フィールド ty の値に対応します。 |
|
sectionType |
報告されたルート応答のセクションの種類 |
|
simpleCategory |
インシデントの種類。 現在、JAM、ROAD_WORK、ROAD_CLOSURE、またはその他にすることができます。 詳細については、「tec」を参照してください。 |
|
startPointIndex |
integer |
このセクションが適用されるルートの最初のポイント (オフセット 0) のインデックス。 |
tec |
TPEG2-TEC 標準の定義を使用したトラフィック イベントの詳細。 effectCode を含め、要素を引き起こすことができます。 |
|
travelMode |
計算されたルートの移動モード。 このセクションで要求されたトランスポート モードが不可能な場合、値は に設定 |
RouteSectionTec
TPEG2-TEC 標準の定義を使用したトラフィック イベントの詳細。 effectCode を含め、要素を引き起こすことができます。
名前 | 型 | 説明 |
---|---|---|
causes |
配列の原因 |
|
effectCode |
integer |
トラフィック フローへの影響。 TPEG2-TEC 標準で定義されている tec001:EffectCode テーブルの値を格納します。 重要度に従ってトラフィック イベントを色分けするために使用できます。 |
RouteSectionTecCause
トラフィック イベントの原因。 mainCauseCode 要素と subCauseCode 要素を含めることができます。 アイコンと説明を定義するために使用できます。
名前 | 型 | 説明 |
---|---|---|
mainCauseCode |
integer |
トラフィック イベントの原因メイン。 TPEG2-TEC 標準で定義されている tec002:CauseCode テーブルの値を格納します。 |
subCauseCode |
integer |
トラフィック イベントのサブキュー。 TPEG2-TEC 標準で定義されている mainCauseCode によって定義されたサブ原因テーブルの値を格納します。 |
RouteSummary
Summary オブジェクト
名前 | 型 | 説明 |
---|---|---|
arrivalTime |
string |
ルートまたは区間の推定到着時間。 時刻は UTC です。 |
departureTime |
string |
ルートまたは区間の推定出発時間。 時刻は UTC です。 |
lengthInMeters |
integer |
Length In Meters プロパティ |
trafficDelayInSeconds |
integer |
トラフィック情報に従って、リアルタイム インシデントによって発生した推定遅延 (秒単位)。 将来出発時刻が予定されているルートの場合、遅延は常に 0 になります。 さまざまな種類のトラフィック情報を使用して追加の移動時間を返すには、パラメーター computeTravelTimeFor=all を追加する必要があります。 |
travelTimeInSeconds |
integer |
リアルタイム トラフィックによる遅延を含む推定移動時間 (秒) プロパティ。 traffic=false travelTimeInSeconds の場合でも、トラフィックによる遅延が含まれていることに注意してください。 DepartAt が将来の場合、移動時間は時間に依存する履歴トラフィック データを使用して計算されます。 |
RouteType
要求されたルートの種類。
名前 | 型 | 説明 |
---|---|---|
eco |
string |
経済とスピードのバランスが取れたルート。 |
fastest |
string |
最速のルート。 |
shortest |
string |
距離別の最短ルート。 |
thrilling |
string |
興味深い道路や困難な道路が含まれており、できるだけ少ない高速道路を使用しています。 含まれるターンのレベルと、ヒルネスの度合いを選択できます。 これを設定する方法については、ヒルネスとワインディングネスのパラメーターを参照してください。 =スリル満点で計画された |
SectionType
ルート応答で報告されるセクションの種類を指定します。
たとえば、sectionType = 歩行者の場合、歩行者のみに適したセクションが返されます。 複数の型を使用できます。 既定の sectionType は travelMode 入力を参照します。 既定では、travelMode は car に設定されています
名前 | 型 | 説明 |
---|---|---|
carTrain |
string |
車または電車であるルートのセクション。 |
carpool |
string |
カープール(HOV/高占有車)レーンの使用を必要とするルートのセクション。 |
country |
string |
ルートが含まれる国/地域を示すセクション。 |
ferry |
string |
フェリーであるルートのセクション。 |
motorway |
string |
高速道路であるルートのセクション。 |
pedestrian |
string |
歩行者にのみ適したルートのセクション。 |
tollRoad |
string |
通行料の支払いが必要なルートのセクション。 |
tollVignette |
string |
有料ビネットが存在する必要があるルートのセクション。 |
traffic |
string |
トラフィック情報を含むルートのセクション。 |
travelMode |
string |
要求パラメーター |
tunnel |
string |
トンネルであるルートのセクション。 |
urban |
string |
都市部に位置するルートのセクション。 |
SimpleCategory
インシデントの種類。 現在、JAM、ROAD_WORK、ROAD_CLOSURE、またはその他を指定できます。 詳細については、「tec」を参照してください。
名前 | 型 | 説明 |
---|---|---|
JAM |
string |
交通渋滞。 |
OTHER |
string |
その他。 |
ROAD_CLOSURE |
string |
道路閉鎖。 |
ROAD_WORK |
string |
道路作業。 |
TravelMode
要求されたルートの移動モード。 定義されていない場合、既定値は 'car' です。 要求された travelMode がルート全体で使用できない場合があることに注意してください。 要求された travelMode が特定のセクションで使用できない場合、そのセクションの応答の travelMode 要素は "other" になります。 移動モードバス、オートバイ、タクシー、バンはベータ機能であることに注意してください。 すべての領域で完全な制限データを使用できるわけではありません。
名前 | 型 | 説明 |
---|---|---|
bicycle |
string |
返されるルートは、自転車レーンの使用を含め、自転車用に最適化されています。 |
bus |
string |
返されるルートは、バス専用レーンの使用を含め、バス用に最適化されています。 BETA 機能。 |
car |
string |
返されるルートは、車用に最適化されています。 |
motorcycle |
string |
返されるルートはオートバイ用に最適化されています。 BETA 機能。 |
pedestrian |
string |
返されたルートは、歩道の使用を含め、歩行者向けに最適化されています。 |
taxi |
string |
返されるルートはタクシー用に最適化されています。 BETA 機能。 |
truck |
string |
返されるルートは、トラックなどの商用車両用に最適化されています。 |
van |
string |
返されるルートはバン用に最適化されています。 BETA 機能。 |
VehicleEngineType
車両のエンジンタイプ。 詳細な従量課金モデルを指定する場合は、 vehicleEngineType の値と一致している必要があります。
名前 | 型 | 説明 |
---|---|---|
combustion |
string |
内燃機関。 |
electric |
string |
電気エンジン。 |
VehicleLoadType
危険物として分類され、一部の道路から制限される可能性のある貨物の種類。 使用可能な vehicleLoadType 値は、US Hazmat クラス 1 から 9 に加えて、他の国/地域で使用するための一般的な分類です。 USHazmat で始まる値は米国のルーティング用ですが、otherHazmat は他のすべての国/地域に使用する必要があります。 vehicleLoadType は複数回指定できます。 このパラメーターは現在、travelMode=truck でのみ考慮されています。
名前 | 型 | 説明 |
---|---|---|
USHazmatClass1 |
string |
火薬類 |
USHazmatClass2 |
string |
圧縮ガス |
USHazmatClass3 |
string |
引火性液体 |
USHazmatClass4 |
string |
引火性固体 |
USHazmatClass5 |
string |
酸化 剤 |
USHazmatClass6 |
string |
毒 |
USHazmatClass7 |
string |
放射性物質 |
USHazmatClass8 |
string |
腐食性 |
USHazmatClass9 |
string |
その他 |
otherHazmatExplosive |
string |
火薬類 |
otherHazmatGeneral |
string |
その他 |
otherHazmatHarmfulToWater |
string |
水に害を |
WindingnessLevel
スリリングなルートのためのターンのレベル。 このパラメーターは、=thrilling と routeType
組み合わせてのみ使用できます。
名前 | 型 | 説明 |
---|---|---|
high |
string |
high |
low |
string |
low |
normal |
string |
普通 |