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

フェリーを使用したルート検索

ルート計算でフェリーとの連結を評価し、それが最適な経路であると判断された場合には、ルートの一部にフェリーでの移動を提案できます。

📘

Routing APIは、フェリーの時刻表にアクセスできません。

この問題についてユーザーに警告するため、フェリーでの移動を示すルートセクションには常に次の注意事項が含まれます。

"notices": [
  {
    "title": "No schedule information available.",
    "code": "noSchedule",
    "severity": "info"
  }
]

フェリーの時刻表がない場合、簡単なモデルを使用してフェリーでの移動時間を計算します。このモデルは、フェリーの経路に沿った乗船時間、下船時間、および速度の固定値で構成されます。 これらの固定値は、すべてのフェリーで同じです。モデルの値はいつでも変更される可能性があることに注意してください。

boarddeboard の時間は、フェリーでの移動を示すルート セクションのプレアクション/postアクションに出力されます。 また、depart アクションの長さと所要時間の比率が 40 km/時 であることに注意してください。

"preActions": [
  {
    "action": "board",
    "duration": 1200
  }
],
"actions": [
  {
    "action": "depart",
    "duration": 101454,
    "length": 1127205,
    "instruction": "Take the Helsinki-Rostock Ferry. Stay on for 1127 km.",
    "offset": 0
  }
],
"postActions": [
  {
    "action": "deboard",
    "duration": 600
  }
]

考えられる問題

この簡単なモデルと実際のフェリー時間の間に差があると、API は次のような望ましくない動作を伴うルートを計算する可能性があります。

  • ルート所要時間が現実と比較して長すぎる、または短すぎる。
  • フェリーを利用した方が良い場合でも、フェリーを利用しないルートが提案される。
  • 夏季しか利用できないフェリー、または1日に1回しか運航しないフェリーなどの理由で、使用すべきではないフェリーを利用するルートが提案される。
  • 利用した方が良いフェリーとは違うフェリーを利用したルートが提案される。

推奨事項

フェリーのスケジュールを確認する

フェリー セクションを含むルートを使用している場合は、その特定のフェリーのスケジュールを確認し、それに合わせて予想移動時間を調整することをお勧めします。

希望のフェリーを使用するようにルート計算を誘導する

APIが希望するフェリーを使用しないルートを計算している場合は、ご希望のフェリーセグメントにパススルー経由地を追加することで、ルート計算を誘導することをお勧めします。 目的の方向に向かうフェリーがルートで使用されるように、パススルー経由地を出発港の近くに設定します。

フェリーを使用したトラックのルーティング (パススルー経由地の使用を含む) のデモのサンプルリクエストについては、次のチュートリアルを参照してください。

利用を希望しないフェリーを回避するようにルート計算を誘導する

利用したくないフェリーを使うルートをAPIが計算している場合、avoid[segments]またはavoid[areas]機能を使用することをお勧めします。

avoid[segments]を使用したリクエストのサンプルは、次のチュートリアルを参照してください。

avoid[areas]を使用したリクエストのサンプルは、次のチュートリアルを参照してください。