主な概念

このセクションでは、HERE Waypoints Sequence API v8を理解して使用するために不可欠な情報を提供します。

経由地

HERE Waypoints Sequence API V8は、経由地を使用して走行中の停車地を特定します。

経由地は、少なくともWGS-84準拠の緯度と経度のペア (-90～90の値、および-180～180の値) を使用して定義されます。

各走行には開始地点と終了地点 (任意です。定義しない場合は最後の経由地が最終目的地であると見なされます) が必要です。この地点は、関連するパラメーター (リソースfindsequenceのstartおよびend) を使用して明示的に定義できます。

他のすべての経由地は、パラメーターdestination1、destination2のように、シーケンス処理する必要がある経由地をいくつでも指定できます。

start地点とend地点を含むウェイポイントの最大数は202です。

pedestrian移動モードでは、ウェイポイント間の距離は5 kmを超えることはできません。

価格

HERE Waypoints Sequence API v8リクエストの価格については、HERE基本プランのページを参照してください。価格についてご質問がある場合は、お問い合わせください。

ルーティングモード

HERE Waypoints Sequence の API V8を使用して一連の経由地を最適化する場合は、リクエストでルーティングモードを指定する必要があります。制限が含まれる可能性のあるサブフィールドを含むルーティングモードの詳細については、HERE Routing API V8の開発者ガイドを参照してください。

modeパラメーターには、次のように3～4つのサブフィールドが含まれている場合があります。

• routing type

  使用できるオプションは次のとおりです。

  • fastest：ルーティングでは移動時間を最小限に抑えます。交通情報を考慮できます (有効になっている場合)。これは最も一般的に使用されるルーティングタイプです。
  • shortest：ルーティングでは移動距離を最小に抑えます。交通情報は無視します。

• transport mode

  移動モードでは、車両のタイプを指定できます。サポートされているオプションはcar、truck、pedestrian、bicycle、scooter、taxi、busです。タクシーとバスのモードは、交通量の多い道路やその近くのバスやタクシーのレーンを利用するため、交通情報をenabledに設定すると最も効果的になります。詳細については、HERE Routing API V8の開発者ガイドを参照してください。

• traffic enabled

  交通情報を有効にすると、HERE Waypoints Sequence API V8はルート計算時に最新の交通情報を考慮します。さらに、このライブ交通情報は今後の移動時間を考慮する際に過去の交通速度で増強されます。現在の時間の計算には、ライブ交通情報が使用されます。長いルートの場合、ライブ交通情報は、ルートの後ろの部分の、過去の交通情報と組み合わせられます。未来の時間帯に計算されたルートでは、交通速度を判断するために過去の交通情報が使用されます。また、ルート上の長期的に閉鎖されている道路を考慮します。リクエストに出発時刻が含まれていない場合、すべての現在 (計算時点) のライブ交通イベントがルートのすべての期間にわたって有効であると見なされます。

• routing features

  ルーティングフィーチャーを使用して、計算されたルートの特殊な条件を定義できます。ルーティングフィーチャーには、有料道路、高速道路などの道路の重み付けが含まれます。複数のルーティングフィーチャーがある場合は、カンマで区切られます (...traffic:disabled;tunnel:-2,motorway:-1)。詳細については、HERE Routing API V8の開発者ガイドを参照してください。

findpickups、findsequenceパラメーター

findsequenceでは、すべての経由地が必須です。経由地はスキップできません。findpickupsの場合、開始経由地と終了経由地のみが必須です。すべての中間経由地は任意であり、スキップできます。現在、これらの経由地タイプ (一部が必須、一部が任意) を組み合わせて最適なルートを計算することはできません。ただし、非常に高い値を中間の経由地に割り当てて、ルートの一部になるようにすることで、疑似的なタイプ混合シナリオを作成できます。

トレースをリクエストする

バグレポートを送信したり、サポートを依頼したりするときは以下の情報を記載してください：ルーティングリクエストURI、リクエスト識別子、対応するエラーコード (存在する場合)。

X-Request-ID

非標準のHTTPヘッダーX-Request-IDを使用して、リクエストにリクエストIDをタグ付けすることができます。成功したか失敗したかにかかわらず、サービスによってこの値がレスポンスで返されます。リクエストIDには任意の文字列を使用できますが、ユニバーサル一意識別子 (UUID) を使用することをお勧めします。