ガイドAPIリファレンス
ガイド

アクセス制限を使用したルーティングの制御方法

道路の通行制約には次のような形式があります。

  • プライベートアクセスのみ
  • ゲートで通行が遮断されている
  • 特定の時間のみ通行できる
  • 車両固有の通行制約
  • ドイツにおける全国的な週末のトラック走行禁止など、トラックに対する行政上の制約
  • 工事による道路閉鎖

トレースをルートと照合する際、APIは該当する制約が発生するセグメントを自動的に回避します。

トレースが複数の通行制約があるルートと一致すると、ルートマッチングが失敗する場合があります。

通行制約固有のパラメーターを使用すると、APIが特定の制約をどのように扱うかを制御できます。つまり、制約を順守するか、無視するか、計算ルートに良い影響がある場合にのみ無視するかを制御します。

📘

すべての制約と制約のオーバーライドがすべての交通機関タイプに適用されるわけではありません。

プライベートアクセス

avoidPrivateパラメーターを使用して、私道を経由するルーティングを制御します。

このパラメーターは次の値を取ります。

  • avoidPrivate=0:これがデフォルト値です。

経由地が私道上にある場合にのみ、私道経由のルート検索を許可します。

  • avoidPrivate=1:私道を通るルート検索を常に許可します。
  • avoidPrivate=-1:私道を通るルート検索は一切許可されません。

ゲート

traverseGatesパラメーターを使用して、ルートがゲートを通過できるかどうかを制御します。

ゲートを通過するには、場合によっては、鍵でゲートを開けるか、通過の許可を得る必要があることを覚えておいてください。

このパラメーターは次の値を取ります。

  • traverseGates=false:デフォルト値。

ルートはどのゲートも通過できません。

緊急車両 (mode=emergency) のみゲートを通過できます。

  • traverseGates=true:ルートはすべてのゲートを通過できます。
  • traverseGates=airlineDistanceInMeters,entryPenaltyInSec

経由地から設定された半径内 (airlineDistanceInMeters) のゲートのみ通過できます。

ゲートを通過すると、移動時間に一定秒数のペナルティ (entryPenaltyInSec) が1回のみ追加されます。

このペナルティのため、ゲートを通過しないルートが常に優先されます。

トラックの行政上の制約

デフォルトでは、指定された地域における、トラックに対する全国的な行政上の制約すべてが順守されます。

この動作をオーバーライドするには、adminTruckRestrictionsパラメーターを使用します。

  • adminTruckRestrictions=ignore:行政上のトラック制約すべてを無視します。

一方通行道路

onewayパラメーターを使用して、進行方向を順守するデフォルトの動作をオーバーライドします。

mode=emergencymode=bicycleでのみ使用できます。

次のようにパラメーターを使用します。

  • oneway=penalty:0.5:時間上のメリットが0.5秒/メートルを超える場合、進行方向違反を許可します。
📘

penaltyの推奨値は次のとおりです。

  • 自転車:0.125
  • 緊急車両:0.5

時間または通行の制約

ignoreWaypointVehicleRestrictionパラメーターを使用すると、次のような状況で目的地に到達できない制約を無視できます。

  • ルートの最後の200メートルが歩行者専用ゾーンである。
  • ドイツで週末のトラック走行は禁止されているが、週末の冷蔵トラックの走行は許可されている。
  • トラックがトラック禁止ゾーンに入る許可を持っている。
  • 工事や事故による道路閉鎖を回避する。

このパラメーターは次の値を取ります。 ignoreWaypointVehicleRestriction=radius[;drivePenaltyFactor[;type[;entryPenalty]]] 値の構成は次のとおりです。

  • radius:必須。

経由地から設定された半径内の場合は、必要に応じて制約に違反します。

歩行者ゾーン、私有地への出入りは2km、都市の出入りは20km、全国的なトラック禁止または全国的な重量制限を通過するには3000kmを使用します。

  • drivePenaltyFactor:デフォルト値は0です。

0.0から10.0の範囲の値を取ります。

制約違反をどの程度厳密に回避するかを制御するために使用する乗数です。

制約のある道路リンクを通過すると、ルートパスコストの最適化の観点からコストが高くなります。

  • type:デフォルト値はallTimedです。

目的地に到達するために違反できる制約を定義します。

次の値のカンマ区切りリストです。

  • allTimed:夜間のトラック走行禁止、都市部での週末のトラック走行禁止、配達のための通行は午前中のみなど、日時に依存する通行制約に違反できます。
  • all:工事やインシデントに関連する道路閉鎖を除き、すべての制約に違反できます。 トンネルの入り口で立ち往生したり、橋に負荷をかけすぎたりしないように、アプリケーションが違反警告を確認し、ドライバーに警告することが重要です。
  • construction:工事、交通渋滞、インシデントにより閉鎖されている道路の通過を許可します。 ドライバーが特別な権限を持っている場合、または地元の迂回路が利用可能であることが確実な場合に使用するのが最適です。
  • entryPenalty:デフォルト値は3600です。

07200の秒単位のエントリーペナルティで、制約に違反した場合に適用されます。

デフォルト値は3600 (1時間) で、ルート検索は1時間迂回しても合法的な経路を見つけることができない場合を除き、違反を回避します。

値を小さくすると、ルート検索は合法的な経路よりも、短い経路を優先します。

制約に違反しないルートがない場合にのみ制約違反が使用されるようにするには、値を大きくします。

歩行者ゾーン内の目的地に到達する

  • &ignoreWaypointVehicleRestriction=2000;;;3600 経由地から半径2km以内では、安全上重要でない通行の制約が無視され、1時間のペナルティが課されます。

違反に対して時間と速度のペナルティを適用する

  • &ignoreWaypointVehicleRestriction=500000;0.9;all;1800 経由地から500km以内では、通行の制約を無視してルートが生成され、違反のたびに30分のペナルティと50%の速度低下が適用されます。

工事中の道路付近の目的地に到達する

  • ignoreWaypointVehicleRestriction=2000;0.9;construction 工事により閉鎖された道路の横にある目的地に到達します。

制約がある場合でも特定の経由地に到達する

  • waypoint1=50.12,8.65;ignoreRestriction:8000,0.9,all,1800 このパラメーターはグローバルパラメーター&ignoreWaypointVehicleRestrictionと同様で、車両の制約に関係なくwaypoint1に到達できます。

    ルートは生成されますが、行き止まりであることがわかっている経由地へのトラックのナビゲーションはサポートされていないことに注意してください。