マップマッチング(車)

/mapmatching_car [POST]

基本情報

概要

リクエストされた車の移動ログ(緯度経度群)を元に、自動車道路ネットワークとマップマッチングを行います。
マップマッチングにより補正された緯度経度群を出力します。
※当APIをご利用の場合は、専用データ利用のオプション契約が別途必要となります

URL

https://{HOST}/{CID}/v1/mapmatching_car

※RapidAPIでは提供しておりません

出力形式

  • JSONまたはCSVファイル

対応言語

  • ja

パラメータ

パラメータ名 必須 概要 型名 デフォルト値 上下限/選択値 備考
datum 緯度経度の測地系 文字列 wgs84 wgs84:世界測地系
tokyo:旧日本測地系
coord_unit 緯度経度の単位 文字列 degree degree:度表記の10進法
millisec:ミリ秒表記

 datum/coord_unitパラメータについて 

利用する緯度経度のフォーマットを指定します。
出力される緯度経度も指定したフォーマットになります。

パラメータ構成例

  • 緯度経度が世界測地系、度数表示の車のログでマップマッチングした結果を出力
/mapmatching_car?datum=wgs84&coord_unit=degree

リクエスト の BODY に含める情報

リクエストのBODYにて、マップマッチングさせたい緯度経度データを送信します。

1リクエストでの緯度経度データ数について

1度に送信可能な最大データ数は1000、最小データ数は11となります。
1000を超えるデータを送信すると、エラーが返却されますのでご注意ください。
11を下回るデータを送信すると、マッチングがされずに返却されますのでご注意ください。
なお、最小データ数に関しては、開始200m分のマッチングの仕様についての注意書きもよくご確認ください。

JSON形式でリクエストする場合

JSON形式で緯度経度情報の配列を指定します。
JSONの構成は以下の通りです。

プロパティ名 必須 概要 型名 デフォルト値 備考
time 緯度経度の取得時間 文字列(日付時刻)
YYYY-MM-DDThh:mm:ss
時刻の指定例 2021-01-01T12:00:00
lat 緯度 文字列
lon 経度 文字列

timeパラメータについて

1秒以上の間隔で取得したデータを使用してください。

緯度/経度パラメータについて

緯度経度は、リクエストで指定した形式にしてください。
また、全てのデータで同じ形式を使用してください。

JSON形式でのリクエスト例

[
    {
        "time": "2020-07-01T10:33:18",
        "lat": "35.661127",
        "lon": "139.723689"
    },
    {
        "time": "2020-07-01T10:33:19",
        "lat": "35.661037",
        "lon": "139.723682"
    },
    ...
]

CSVファイル形式でリクエストする場合

CSVファイル形式で緯度経度情報を指定します。
CSVファイルの構成は以下の通りです。

カラム名 必須 概要 型名 デフォルト値 備考
time 緯度経度の取得時間 文字列(日付時刻)
YYYY-MM-DDThh:mm:ss
時刻の指定例 2021-01-01T12:00:00
lat 緯度情報 数値
lon 経度情報 数値

CSVファイル形式について

CSVファイル形式の場合、ヘッダが必須となります。
また、カンマ区切りで構成してください。

timeカラムについて

1秒以上の間隔で取得したデータを使用してください。

緯度/経度カラムについて

緯度経度は、リクエストで指定した形式にしてください。
また、全てのデータで同じ形式を使用してください。

CSVファイル形式でのリクエスト例

time,lat,lon
2020-07-01T10:33:18,35.661127,139.723689
2020-07-01T10:33:19,35.661037,139.723682
...

CSVファイル形式のリクエスト方法

CSVファイル形式の場合は、以下のリクエスト方法の中からお選びいただけます。

指定方法 Content-typeヘッダの値 形式
BODYへのテキスト入力 text/plain 文字列
File形式での送信 text/csv File
form形式での送信 multipart/form-data File

逆走状態のデータについて

送信されたデータが逆走状態の場合、
その区間はマッチングされない、もしくは付近の道路に誤ったマッチングがされますのでご注意ください。

開始200m分のマッチングの仕様について

送信されたデータの開始から約200m分につきましては、GPSの荒れや駐車場内にいる可能性等を考慮しマッチングされない仕様となっています。
そのため、走行距離が200mを超えるデータを送信していただきますよう、お願い致します。

レスポンス

 

レスポンスの形式は、リクエストに応じた形式(JSONまたはCSVファイル)で返却されます。

JSON形式のレスポンス

名称 レスポンス名 型名 配列 説明
スポット情報 items MapmatchingItemオブジェクト マップマッチ結果情報のまとまり
単位情報 unit Unitオブジェクト 出力される単位の情報

MapmatchingItemオブジェクト

名称 レスポンス名 型名 配列 説明
緯度経度の取得時間 time 文字列(日付時刻)
YYYY-MM-DDThh:mm:ss
リクエストされた緯度経度取得時間
補正後緯度 result_lat 数値 マッチング結果の緯度情報
情報がある場合のみ出力
補正後経度 result_lon 数値 マッチング結果の経度情報
情報がある場合のみ出力
緯度 original_lat 数値 マッチング前の緯度情報
リクエストされた緯度情報と同じ値を出力
経度 original_lon 数値 マッチング前の経度情報
リクエストされた経度情報と同じ値を出力
道路情報 road_info RoadInfoオブジェクト マッチング結果の緯度経度に紐づく道路情報
情報がある場合のみ出力

RoadInfoオブジェクト

名称 レスポンス名 型名 配列 説明
一時停止線 stop_line StopLineオブジェクト 一時停止線情報
情報がある場合のみ出力
同一リンク内で、マッチング後緯度経度に最も近い一時停止線を出力
最高速度 (単位:km/h) max_speed 文字列 最高速度情報
情報がある場合のみ出力

StopLineオブジェクト

名称 レスポンス名 型名 配列 説明
代表緯度経度 coord Coordinateオブジェクト 一時停止線の代表緯度経度
情報がある場合のみ出力
緯度経度からの距離 (単位:m) distance 数値 マッチング後の緯度経度から一時停止線の代表緯度経度までの距離
マッチング後の緯度経度が一時停止線を超えている場合は、-値で出力されます
情報がある場合のみ出力

Coordinateオブジェクト

名称 レスポンス名 型名 配列 説明
緯度 lat 数値
経度 lon 数値

Unitオブジェクト

名称 レスポンス名 型名 配列 説明
緯度経度の測地系 datum 文字列
緯度経度の出力形式 coord_unit 文字列
距離の出力単位 distance 文字列

JSON形式のレスポンス例

{
    "items": [
        {
            "time": "2020-07-01T10:33:18",
            "original_lat": 35.661127,
            "original_lon": 139.723689
        },
        {
            "time": "2020-07-01T10:33:19",
            "result_lat": 35.66108,
            "result_lon": 139.72385,
            "original_lat": 35.661037,
            "original_lon": 139.723682,
            "road_info": {
                "stop_line": {
                    "coord": {
                        "lat": 35.66162,
                        "lon": 139.72364
                    },
                    "distance": 63.04
                },
                "max_speed": "30"
            }
        },
        ・・・
    ],
    "unit": {
        "datum": "wgs84",
        "coord_unit": "degree",
        "distance": "meter"
    }
}

CSVファイル形式のレスポンス

名称 カラム名 型名 説明
緯度経度の取得時間 time 文字列(日付時刻)
YYYY-MM-DDThh:mm:ss
リクエストされた緯度経度取得時間
補正後緯度 result_lat 数値 マッチング結果の緯度情報
情報がある場合のみ出力
補正後経度 result_lon 数値 マッチング結果の経度情報
情報がある場合のみ出力
緯度 original_lat 数値 オリジナルの緯度情報
リクエストされた緯度情報と同じ値
経度 original_lon 数値 オリジナルの経度情報
リクエストされた経度情報と同じ値
一時停止線の代表緯度 stop_line_lat 数値 一時停止線の代表緯度情報
情報がある場合のみ出力
一時停止線の代表経度 stop_line_lon 数値 一時停止線の代表経度情報
情報がある場合のみ出力
一時停止線までの距離 (単位:m) stop_line_distance 数値 マッチング後の緯度経度から一時停止線の代表緯度経度までの距離
情報がある場合のみ出力
最高速度 (単位:km/h) max_speed 文字列 最高速度情報
情報がある場合のみ出力

CSVファイル形式のレスポンス例

time,result_lat,result_lon,original_lat,original_lon,stop_line_lat,stop_line_lon,stop_line_distance,max_speed
2020-07-01T10:33:18,,,35.661127,139.723689,,,,
2020-07-01T10:33:19,35.66108,139.72385,35.661037,139.723682,35.66162,139.72364,63.04,30
...

 最高速度について 

最高速度が途中で切り替わるなど、同一道路区間上に最高速度情報が複数存在する場合があります。
その場合、最高速度は "/" で区切られて出力されます。

道路情報の出力について

道路情報の出力には別途利用契約が必要になります。(ご契約されていない状態ですと出力されません。)
ご利用になりたい情報がございましたら、営業担当もしくはサポートまでご連絡ください。