主な概念

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

waypoints

HERE Waypoints Sequence の API V8 は、waypoints を使用して走行中の停車地を特定します。 waypoints は、 WGS-84 準拠の緯度 と経度 のペアによって、 -90 ~ 90の値、 および -180 ~ 180 の値 で、少なくとも定義されています。 各旅程には、出発地と目的地が必要です(任意、最後のWaypoints が定義されていない場合は最終目的地と見なされます)。この地点は、関連するパラメータ(startおよびendリソースfindsequence)を使用して明示的に定義できます。 他のすべてのWaypoints は、 パラメータdestination1destination2、などで識別されますが、シーケンス処理するwaypoints の数は多くなります。 waypoints に「人間が読める」ラベルを追加することもできます。 例 については、「交通情報をサポートするウェイポイントシーケンスのある車」を参照してください。

価格の制限と影響

出発地と目的地を含むwaypointsの最大数は 202 です。 請求は、消費されたトランザクションに基づいています。 各リクエストについて、waypointsの数、クラスタリング、およびトラフィックが有効かどうかに応じて、トランザクション数が計算されます。 実際の数およびその他の契約モデルについて は、 HERE 基本プランの価格設定、特に「取引の定義と除外された使用例」および「 HERE Location Serviceのレート」のセクションを参照してください。 ルーティングモード pedestrian を使用する場合、waypointsの 2 つの距離が 5 km を超えることはできません。

ルーティングモード

HERE Waypoints Sequence の API V8 を使用して一連のwaypoints を最適化する場合は、リクエストでルーティングモードを指定する必要があります。 一部のサブフィールドでの制限を含む、ルーティングモードの詳細な説明については、 HERE Routing API を参照してください。 ただし、このパラメータ mode には、次のように 3 ~ 4 つのサブフィールドが含まれている場合があります。

  • routing type

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

    • fastest: ルーティングでは移動時間が最も短くなり、有効になっている場合はトラフィックを考慮できます。 これが最も一般的に使用されているルーティングタイプです。
    • shortest: 経路指定では、最短走行距離が優先され、交通状況が無視されます。
  • transport mode

    Transportモードでは、車両のタイプを指定できます。 サポートされているオプションは cartruckpedestrianbicyclescootertaxi または bus。 タクシーとバスのモードは、 enabled交通量の多い道路やその近くのバスやタクシーのレーンを利用するため、交通量の設定に合わせて最適です。 HERE Routing API でTransportモードの説明を参照してください。また、利用可能なステータスについての情報もあります。たとえば、トランスポートモードに「ベータ」の制限がある場合などです。

  • traffic enabled

    トラフィックを有効にすると、 HERE Waypoints Sequence API V8 でルート計算時に最新の交通情報を考慮できます。 さらに、このライブトラフィック情報は、今後の移動時間を考慮する場合に、過去の交通速度で拡張されます。 現在の時間の計算では、ライブトラフィック情報が使用されます。 長いルートの場合、ライブトラフィック情報は、ルートの後の部分の履歴トラフィック情報と混合されます。 将来の時間帯に計算されたルートでは、交通速度を判断するために履歴の交通情報が使用されます。また、ルート上の長期的な道路閉鎖についても考慮されます。 リクエストに出発時間が含まれていない場合、現在のすべてのライブトラフィックイベント(計算時)がルートのすべての期間にわたって有効であると見なされます。

  • routing features

    ルーティング機能を使用して、計算されたルートの特殊な条件を定義できます。 ルート探索フィーチャーには、有料道路、高速道路などの道路の重み付けが含まれます HERE Routing API の RoutingModeType の説明には、詳細な情報が含まれています。複数のルーティング機能がある場合、ルーティング機能はコンマで区切られていることに注意してください。...traffic:disabled;tunnel:-2,motorway:-1

例については、 を参照してください。

Findpickup と findsequence の比較

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

トレースのリクエスト

バグレポートを送信する場合やサポートを依頼する場合は、必ずルーティングリクエストの URL、リクエスト ID、および対応するエラーコード(該当する場合)を入力してください。

X-Request-ID

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

」に一致する結果は 件です

    」に一致する結果はありません