マップマッチング(車)
/mapmatching_car [POST]
基本情報
概要
リクエストされた車の移動ログ（緯度経度群）を元に、自動車道路ネットワークとマップマッチングを行います。
マップマッチングにより補正された緯度経度群を出力します。
※当APIをご利用の場合は、専用データ利用のオプション契約が別途必要となります
マップマッチングの対象外エリア
下記エリアを含む車の移動ログ（緯度経度群）はマップマッチング対象外となります。
・石垣島・竹富島（沖縄県石垣市および沖縄県八重山郡竹富町）
・北大東島・南大東島（沖縄県島尻郡北大東村および沖縄県島尻郡南大東村）
・多良間島・水納島（沖縄県宮古郡多良間村）
・与那国島（沖縄県八重山郡与那国町）
・宮古諸島（沖縄県宮古島市）
・青ヶ島（東京都青ヶ島村）
・硫黄島（東京都小笠原村硫黄島）
URL
https://{HOST}/{CID}/v1/mapmatching_car
※APIマーケットでは提供しておりません
出力形式
- JSONまたはCSVファイル
対応言語
- ja
パラメータ
| パラメータ名 | 必須 | 概要 | 型名 | デフォルト値 | 上下限/選択値 | 備考 |
|---|---|---|---|---|---|---|
| datum | 緯度経度の測地系 | 文字列 | wgs84 | wgs84：世界測地系 tokyo：旧日本測地系 |
||
| coord_unit | 緯度経度の単位 | 文字列 | degree | degree：度表記の10進法 millisec：ミリ秒表記 |
||
| matching_range | マッチング範囲 | 文字列 | exclude_200m | - exclude_200m：開始200m分を除外 - all：すべて |
開始200m分のマッチングの仕様についてはこちらをご確認ください | |
| use_interpolate | 点列補間の利用 | 文字列 | unuse | unuse：点列補間を利用しない use：点列補間を利用する use_output：点列補間を利用し、出力結果にも含める |
詳細はこちらをご覧ください |
datum/coord_unitパラメータについて
利用する緯度経度のフォーマットを指定します。
出力される緯度経度も指定したフォーマットになります。
use_interpolateパラメータについて
点列補間を利用するかどうかを指定します。
点列補間とは、秒間が空いたデータでも緯度経度間を直線で移動する様に緯度経度データを補間してマッチングを行うことを指します。
マッチングが失敗する場合にお試しください。
利用例：
・緯度経度の各データの秒間隔が２秒以上の場合
・GPS精度の影響で秒間が大きく空いたデータを利用する場合
パラメータ構成例
- 緯度経度が世界測地系、度数表示の車のログでマップマッチングした結果を出力
/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パラメータについて
１秒以上の間隔で取得したデータを使用してください。
緯度/経度パラメータについて
緯度経度は、リクエストで指定した形式にしてください。
また、全てのデータで同じ形式を使用してください。
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カラムについて
１秒以上の間隔で取得したデータを使用してください。
緯度/経度カラムについて
緯度経度は、リクエストで指定した形式にしてください。
また、全てのデータで同じ形式を使用してください。
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 |
出力されるCSVファイルのファイル名称について
指定方法「File形式での送信」もしくは「form形式での送信」によりファイルを指定してリクエストした場合、
レスポンスヘッダにContent-Dispositionが付与され、結果をCSVファイルでダウンロード可能となります。
その際のファイル名称は以下の通りとなります。
■指定方法「File形式での送信」の場合
・一律で「mapmatching_result_yyyymmddhhmmss.csv」となります。
例）mapmatching_result_20230320102530.csv
■指定方法「form形式での送信」の場合
・「{リクエストのファイル名称}_result_yyyymmddhhmmss.csv」となります。
例）「sample-file.csv」というファイルを利用しリクエストした場合
sample-file_result_20230320102530.csv
マッチングに適さないデータについて
送信されたデータが、逆走状態の場合や通常の車での移動の速さを越えるような場合は、
その区間はマッチングされない、もしくは付近の道路に誤ったマッチングがされますのでご注意ください。
開始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 | 数値 | マッチング前の経度情報 リクエストされた経度情報と同じ値、または点列補間された経度情報の値を出力 |
|
| 補間された点かどうか | is_interpolated | 真偽値 | true：点列補間された緯度経度の値を利用 false：リクエストされた緯度経度情報と同じ値を利用 |
|
| 道路情報 | road_info | RoadInfoオブジェクト | マッチング結果の緯度経度に紐づく道路情報 情報がある場合のみ出力 |
|
| 走行距離 (単位：m) | distance | 数値 | マップマッチが途切れず続いている区間ごとに走行距離を割り出し、前の区間の累積値が出力されます |
RoadInfoオブジェクト
| 名称 | レスポンス名 | 型名 | 配列 | 説明 |
|---|---|---|---|---|
| 一時停止線 | stop_line | StopLineオブジェクト | 一時停止線情報 同一リンク内で、マッチング後緯度経度に最も近い一時停止線を出力 情報がある場合のみ出力 |
|
| 最高速度 (単位：km/h) | max_speed | 文字列 | 最高速度情報 情報がある場合のみ出力 |
|
| ゾーン30情報 | is_zone30 | 真偽値 | 情報がある場合のみ出力 | |
| 車道情報 | roadway_info | RoadwayInfoオブジェクト | 情報がある場合のみ出力 | |
| 道路種別 | link_attribute | LinkAttributeオブジェクト | 情報がある場合のみ出力 | |
| 車両規制情報 | car_spec_restrict | CarSpecRestrictオブジェクト | 情報がある場合のみ出力 | |
| スマートIC規制 | smart_ic_restrict | SmartIcRestrictオブジェクト | 情報がある場合のみ出力 | |
| トラック走行実績 | truck_drive_record | TruckDriveRecordオブジェクト | 情報がある場合のみ出力 | |
| 勾配 (単位：％) | slope | 数値 | 情報がある場合のみ出力 |
StopLineオブジェクト
| 名称 | レスポンス名 | 型名 | 配列 | 説明 |
|---|---|---|---|---|
| 代表緯度経度 | coord | Coordinateオブジェクト | 一時停止線の代表緯度経度 情報がある場合のみ出力 |
|
| 緯度経度からの距離 (単位：m) | distance | 数値 | マッチング後の緯度経度から一時停止線の代表緯度経度までの距離 マッチング後の緯度経度が一時停止線を超えている場合は、-値で出力されます 情報がある場合のみ出力 |
Coordinateオブジェクト
| 名称 | レスポンス名 | 型名 | 配列 | 説明 |
|---|---|---|---|---|
| 緯度 | lat | 数値 | ||
| 経度 | lon | 数値 |
RoadWayInfoオブジェクト
| 名称 | レスポンス名 | 型名 | 配列 | 説明 |
|---|---|---|---|---|
| 総車線数 | total_lane_count | 数値 | 補正後の緯度経度道路上の車線数 情報がある場合のみ出力 |
|
| 自車走行車線数 | own_lane_count | 数値 | 情報がある場合のみ出力 | |
| 車線幅員 (単位：m) | road_width | 数値 | total_lane_countが2以上の場合は出力されない 補正後の緯度経度道路上の車道幅員 情報がある場合のみ出力 |
|
| 舗装フラグ | is_paved_road | 真偽値 | 情報がある場合のみ出力 |
LinkAttributeオブジェクト
| 名称 | レスポンス名 | 型名 | 配列 | 説明 |
|---|---|---|---|---|
| 道路種別 | road_type | RoadTypeオブジェクト | 1：高速道路国道 2：都市高速道路 3：一般国道 4：主要地方道路 5：NW Level3以上が付与されている下位階層道路 6：一般都道府県道 7：下位属性から格上げされた道路 8：フェリー 9：VICSリンクIDが付与されている下位階層道路 10：主要一般道 11：一般道 12：細道路 14：細道路(未保証道) 情報がある場合のみ出力 |
|
| 詳細道路種別 | additional_road_type | RoadTypeオブジェクト | 1：本線（上下線非分離） 2：本線（上下線分離） 3：連結路（本線間の渡り線） 4：交差点内 5：連結路（ランプ） 6：本線と同一路線の側道 7：ＳＡ等の側道 8：ロータリ 10：その他 11：スマートインター 情報がある場合のみ出力 |
|
| 道路形状区分 | road_shape_type | RoadTypeオブジェクト | 1：本線 2：高架・橋 4：トンネル 情報がある場合のみ出力 |
|
| 有料道路区分 | toll_type | RoadTypeオブジェクト | 0：無料 1：高速道路国道／都市高速道路 2：一般有料道路 情報がある場合のみ出力 |
|
| 道路名 | road_name | RoadNameオブジェクト | 情報がある場合のみ出力 | |
| 道路通称名 | common_name | RoadNameオブジェクト | 情報がある場合のみ出力 |
RoadTypeオブジェクト
| 名称 | レスポンス名 | 型名 | 配列 | 説明 |
|---|---|---|---|---|
| 区分コード | code | 数値 | ||
| 区分名称 | name | 文字列 |
RoadNameオブジェクト
| 名称 | レスポンス名 | 型名 | 配列 | 説明 |
|---|---|---|---|---|
| 名称 | name | 文字列 | 例：国道２４６号線 | |
| 読み仮名 | ruby | 文字列 | 例：ｺｸﾄﾞｳﾆﾋｬｸﾖﾝｼﾞｭｳﾛｸｺﾞｳｾﾝ |
CarSpecRestrictオブジェクト
| 名称 | レスポンス名 | 型名 | 配列 | 説明 |
|---|---|---|---|---|
| 車高規制有無 | is_car_height | 真偽値 | 情報がある場合のみ出力 | |
| 車幅規制有無 | is_car_width | 真偽値 | 情報がある場合のみ出力 | |
| 総重量規制有無 | is_car_weight | 真偽値 | 情報がある場合のみ出力 |
SmartIcRestrictオブジェクト
| 名称 | レスポンス名 | 型名 | 配列 | 説明 |
|---|---|---|---|---|
| 車長 (単位：cm) | car_length | 数値 | 情報がある場合のみ出力 | |
| 車種タイプ | target_tolls_type | RestrictCarTypeオブジェクト | 〇 | 情報がある場合のみ出力 |
RestrictCarTypeオブジェクト
| 名称 | レスポンス名 | 型名 | 配列 | 説明 |
|---|---|---|---|---|
| 名称 | name | 文字列 | 例：軽自動車 |
TruckDriveRecordオブジェクト
| 名称 | レスポンス名 | 型名 | 配列 | 説明 |
|---|---|---|---|---|
| 最大車長 (単位：cm) | max_length | 数値 | 情報がある場合のみ出力 |
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",
"is_zone30": true,
"roadway_info": {
"own_lane_count": 1,
"total_lane_count": 2,
"road_width": 4.2,
"is_paved_road": true
},
"link_attribute": {
"road_type": {
"code": 3,
"name": "一般国道"
},
"additional_road_type": {
"code": 1,
"name": "本線（上下線非分離）"
},
"road_shape_type": {
"code": 1,
"name": "本線"
},
"toll_type": {
"code": 0,
"name": "無料"
},
"road_name": {
"name": "国道２１２号線",
"ruby": "ｺｸﾄﾞｳﾆﾋｬｸｼﾞｭｳﾆｺﾞｳｾﾝ"
}
},
"car_spec_restrict": {
"is_car_height": true,
"is_car_width": true,
"is_car_weight": true
},
"smart_ic_restrict": [
{
"car_length": 600,
"car_type": [
{
"name": "軽自動車"
},
{
"name": "普通車"
}
]
},
{
"car_type": [
{
"name": "中型車"
},
{
"name": "大型車"
},
{
"name": "特大車"
}
]
}
],
"truck_drive_record": {
"max_length": 9999
},
"slope": 1.1
},
"distance": 100
},
・・・
],
"unit": {
"datum": "wgs84",
"coord_unit": "degree",
"distance": "meter"
}
}
CSVファイル形式のレスポンス
| 名称 | カラム名 | 型名 | 説明 |
|---|---|---|---|
| 緯度経度の取得時間 | time | 文字列（日付時刻） YYYY-MM-DDThh:mm:ss |
リクエストされた緯度経度取得時間 |
| 補正後緯度 | result_lat | 数値 | マッチング結果の緯度情報 情報がある場合のみ出力 |
| 補正後経度 | result_lon | 数値 | マッチング結果の経度情報 情報がある場合のみ出力 |
| 緯度 | original_lat | 数値 | オリジナルの緯度情報 リクエストされた緯度情報と同じ値、または点列補間された緯度情報の値 |
| 経度 | original_lon | 数値 | オリジナルの経度情報 リクエストされた経度情報と同じ値、または点列補間された経度情報の値 |
| 補間された点かどうか | is_interpolated | 真偽値 | true：点列補間された緯度経度の値を利用 false：リクエストされた緯度経度情報と同じ値を利用 |
| 一時停止線の代表緯度 | stop_line_lat | 数値 | 一時停止線の代表緯度情報 情報がある場合のみ出力 |
| 一時停止線の代表経度 | stop_line_lon | 数値 | 一時停止線の代表経度情報 情報がある場合のみ出力 |
| 一時停止線までの距離 (単位：m) | stop_line_distance | 数値 | マッチング後の緯度経度から一時停止線の代表緯度経度までの距離 情報がある場合のみ出力 |
| 最高速度 (単位：km/h) | max_speed | 文字列 | 最高速度情報 情報がある場合のみ出力 |
| ゾーン30情報 | is_zone30 | 文字列(真偽値) | ゾーン30情報 情報がある場合のみ出力 |
| 総車線数 | total_lane_count | 数値 | 車道情報 情報がある場合のみ出力 |
| 自車走行車線数 | own_lane_count | 数値 | 車道情報 情報がある場合のみ出力 |
| 車幅幅員 (単位：m) | road_width | 数値 | 車道情報 情報がある場合のみ出力 total_lane_countが2以上の場合は出力されない |
| 舗装フラグ | is_paved_road | 文字列(真偽値) | 車道情報 情報がある場合のみ出力 |
| 道路種別コード | road_type_code | 数値 | 道路種別情報 情報がある場合のみ出力 |
| 道路種別名称 | road_type_name | 文字列 | 道路種別情報 情報がある場合のみ出力 |
| 詳細道路種別コード | additional_road_type_code | 数値 | 道路種別情報 情報がある場合のみ出力 |
| 詳細道路種別名称 | additional_road_type_name | 文字列 | 道路種別情報 情報がある場合のみ出力 |
| 道路形状区分コード | road_shape_type_code | 数値 | 道路種別情報 情報がある場合のみ出力 |
| 道路形状区分名称 | road_shape_type_name | 文字列 | 道路種別情報 情報がある場合のみ出力 |
| 有料道路区分コード | toll_type_code | 数値 | 道路種別情報 情報がある場合のみ出力 |
| 有料道路区分名称 | toll_type_name | 文字列 | 道路種別情報 情報がある場合のみ出力 |
| 道路名称 | road_name | 文字列 | 道路種別情報 情報がある場合のみ出力 |
| 道路名称読み仮名 | road_name_ruby | 文字列 | 道路種別情報 情報がある場合のみ出力 |
| 道路通称名 | common_name | 文字列 | 道路種別情報 情報がある場合のみ出力 |
| 道路通称名読み仮名 | common_name_ruby | 文字列 | 道路種別情報 情報がある場合のみ出力 |
| 車高規制有無 | is_car_height | 文字列(真偽値) | 車両規制情報 情報がある場合のみ出力 |
| 車幅規制有無 | is_car_width | 文字列(真偽値) | 車両規制情報 情報がある場合のみ出力 |
| 総重量規制有無 | is_car_weight | 文字列(真偽値) | 車両規制情報 情報がある場合のみ出力 |
| スマートIC規制の車長 (単位：cm) | smart_ic_car_length | 数値 | スマートIC規制情報 複数存在する場合は、"/"で区切られて出力 情報がある場合のみ出力 |
| スマートIC規制の対象車種 | smart_ic_car_type_name | 文字列 | スマートIC規制情報 複数存在する場合は、"/"で区切られて出力 情報がある場合のみ出力 |
| トラック走行実績の最大車長 (単位：cm) | truck_drive_record_max_length | 数値 | トラック走行実績情報 情報がある場合のみ出力 |
| 勾配 (単位：%) | slope | 数値 | 情報がある場合のみ出力 |
| 走行距離 (単位：m) | distance | 数値 | マップマッチが途切れず続いている区間ごとに走行距離を割り出し、前の区間の累積値が出力されます |
CSVファイル形式のレスポンス例
time,result_lat,result_lon,original_lat,original_lon,stop_line_lat,stop_line_lon,stop_line_distance,max_speed,is_zone30,total_lane_count,own_lane_count,road_width,is_paved_road,road_type_code,road_type_name,additional_road_type_code,additional_road_type_name,road_shape_type_code,road_shape_type_name,toll_type_code,toll_type_name,road_name,road_name_ruby,common_name,common_name_ruby,is_car_height,is_car_width,is_car_weight,smart_ic_car_length,smart_ic_car_type_name,truck_drive_record_max_length,slope,distance
2020-07-05T07:00:01,,,128259634,500583884,,,,,,,,,,,,,,,,,,,,,,,,,,,,,0
2020-07-05T07:00:02,,,128259234,500583928,,,,,,,,,,,,,,,,,,,,,,,,,,,,,0
...
2020-07-05T07:01:25,128234952,500566212,128234968,500566199,,,,30,,,,,True,1,高速道路国道,11,スマートインター,1,本線,1,高速道路国道／都市高速道路,中央自動車道,ﾁｭｳｵｳｼﾞﾄﾞｳｼｬﾄﾞｳ,,,,,,600,軽自動車/普通車/中型車/大型車/特大車,,,1158
2020-07-05T07:01:26,128235420,500566428,128235434,500566417,,,,30,,,,,True,1,高速道路国道,11,スマートインター,1,本線,1,高速道路国道／都市高速道路,中央自動車道,ﾁｭｳｵｳｼﾞﾄﾞｳｼｬﾄﾞｳ,,,,,,600,軽自動車/普通車/中型車/大型車/特大車,,-2.083,1158
...
最高速度について
最高速度が途中で切り替わるなど、同一道路区間上に最高速度情報が複数存在する場合があります。
その場合、最高速度は "/" で区切られて出力されます。
道路情報の出力について
スマートIC規制およびトラック走行実績を除いた道路情報の出力には別途利用契約が必要になります(ご契約されていない状態ですと出力されません)。
ご利用になりたい情報がございましたら、営業担当もしくはサポートまでご連絡ください。