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

ルート沿いのピックアップ方法

HERE Waypoints Sequence API V8は、ルートに沿って乗客や荷物を運送することによって、移動コストを最適化できます。driver_cost (1時間あたりのコスト) とvehicle_cost (1キロメートルあたりのコスト) パラメーターを使用して、得られた利益に関連する迂回時間/距離を設定します。

📘

HERE Waypoints Sequence API V8では、そのレスポンスにルートの詳細は含まれません。ルートをリクエストするには、HERE Routing APIを使用して、findpickupsレスポンスに示されている順序で開始地点/終了地点を通過するピックアップ/ドロップオフ経由地を使用します。

HERE Routing APIへのリクエストには、ルートの移動モードと、HERE Waypoints Sequence API V8のレスポンスからの連続する経由地座標が2つ含まれている必要があります。この情報はHERE Waypoints Sequence API V8のレスポンスの要素estimatedDepartureにあります。

時間帯の制約は、各経由地固有の、荷物配達または約束に関する営業時間または期限を定義します。成功したレスポンスには、リクエストのパラメーターwaypointNで指定されたすべての時間制約を守る、最適化された経由地シーケンスが含まれています。これが不可能な場合、サービスは経由地シーケンスなしでレスポンスを生成しますが、競合または問題のある制約または経由地に関するヒントが提示されます。その後、制約または経由地を削減または変更してリクエストを再送信する必要があります。例については、「時間の制約で最適化された経由地シーケンス」を参照してください。

ピックアップ名とドロップオフ名は、厳密に遵守される2つの経由地間の暗黙的な部分順序を定義します。

サービス時間は経由地それぞれに固有のもので、その経由地で消費する時間を定義します。言い換えると、経由地での到着から出発までの時間の長さを示します。たとえば、荷物の配達を完了する時間です。サービス時間は、最適化された経由地シーケンスで考慮されます。

HERE Waypoints Sequence API V8では、指定されたパラメーターに応じてレスポンスの計算に数分かかることがあります。具体的には、この計算時間は次の要因によって異なります。

  • 交通情報モード (mode=...;traffic:enabled) が有効になっているかどうか
  • 経由地の数
  • 個々の経由地間の距離
  • carモードまたはtruckモードのどちらが使用されているか (mode=car;またはmode=truck;...)

HERE Waypoints Sequence API V8システムでは、ネットワーク接続の終了前に発生するタイムアウトは300秒に設定されています。