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

GPSトレースを最も可能性の高いルートに一致させる方法

HERE Route Matching API V8では、指定されたGPSトレースを通して (可能性が最も高い) ルートをデータ処理します。

一般的なGPSの誤りが考慮され、任意のギャップが適切に処理されます。

入力データの詳細については、「GPSトレースファイル形式と精度要件」を参照してください。

多くの場合、マップにマッチしたトレースは、制限速度、スロープ、曲率、高速道路/都市内、車線数、交通状況/気象状況などのHERE Map Attributesを使用して補強されます。

これらは、ルートマッチレスポンスに直接含めることができます。

もう1つのユースケースは、HERE Route Matching API v8によってドライバーの毎日の通勤経路を学習し、これらのルートの基礎を保存し、このルートパスを毎日HERE Routing APIに送信することで、現在の交通状況とそのルート上でのインシデントを考慮した運転時間を取得することです。

そのため、通常よりも早く出発する必要がある場合や、すべてが通常どおりである場合はその旨がドライバーに警告が表示されます。

コード

以下はサンプルリクエストです。

📘

こちらをクリックして、コード例で使用できるサンプルデータを取得します。 内容をGPXファイルとして保存します。

curl -X POST -H "Content-Type: application/json" --data-binary @PATH_TO_GPS_TRACE_FILE "https://routematching.hereapi.com/v8/match/routelinks?routeMatch=1&mode=fastest;car;traffic:disabled&legal=access,oneway,thrutraf,turn&attributes=LINK_FCn(REF_NODE_NEIGHBOR_LINKS,NONREF_NODE_NEIGHBOR_LINKS)apiKey=API_KEY"

レスポンスとして、Route Matching APIによってトレースから計算されたルートが緑色で表示されます。

Routing APIによって計算されたルートが、リアルタイムの交通状況またはガイダンス情報とともに赤色でその下に表示されます。

レスポンスには、ルートリンクでの特定の警告のリストが含まれます。

「リンク786918237にあるゲートを通過しました」のようなレスポンス例があります。

📘

リクエストあたりの経由地の数に厳密な制限はありません。 データ処理の作業量は、GPS トレースが通過するキロメートル数によって異なります。 経由地リクエストのデータ処理時間が50秒を超えると、リクエストはキャンセルされます。

手順

前のセクションのサンプルリクエストを使用して、入力データを提供できます。

または、インターフェースに直接トレース ファイルを提供することもできます。

https://demo.support.here.com/examples/v3/rme_daily_commute を開きます。

ポイントとそのポイントの制限速度のリストを指定すると、Route Matching API がそれらのポイントを通過するルートを計算します。

トレース データは csv 形式、GPX 形式、NMEA 形式のトレース ファイルを使用して挿入されます。

トレースファイルには座標、高度、速度などのデータが含まれています。

入力形式の詳細については、「GPSトレースファイル形式と精度要件」を参照してください。

地図のポイントを直接クリックして、トレースデータを挿入することもできます。

結果

レスポンスとして、HERE Route Matching API v8によってトレースから計算されたルートが緑色で表示されます。

Routing APIによって計算されたルートが、その下に赤色で表示されます。この場合、リアルタイムの交通への影響に関する情報が表示される可能性があります (この例では表示されていません)。

POSTリクエストは特定のルートリンクでの警告のリストを返します。

出力形式の詳細については、「GPSトレースファイル形式と精度要件」を参照してください。