マップマッチングAPI (v2.0)

Download OpenAPI specification:Download

リクエストされたGPSログ等の緯度経度点列(最大1000点)に対し、自動車向け道路ネットワークとのマップマッチングを行い、道路ネットワーク上に補正された緯度経度点列と道路の属性情報を返却します。

マップマッチングAPI

リクエストされた緯度経度点列に対して以下を提供します。

道路ネットワーク上に補正された緯度経度点列
マッチングした道路の属性情報

以下のような利用用途を想定しています。

車両の正確な位置のリアルタイムな把握
車両の走行ログから、車両が通行した道路の特定、及び、道路属性情報と照合した危険運転走行の把握

本APIのご利用に際しては、以下をご留意ください。

マッチング可能な緯度経度の範囲は、日本国内に限定されます。
入力する緯度経度点列が実際の道路から大きく離れている場合や間隔が広すぎる場合、マッチング失敗や付近の他の道路へ誤ってマッチングされる場合があります。
緯度経度1点のみをマッチングしたい場合は、shapeに同一緯度経度を2つ指定してください。
入力地点間でマッチングする道路の道なり距離が2,000メートルを超える場合、その区間はマッチングが行われません。
入力地点全てで上記の場合、status_code=400のリクエストエラーとなります。

Authorizations:

api_key

header Parameters

x-api-key required	string APIキーによる認証を行います。弊社より提供されたAPIキーを記述してください。
content-type required	string content-typeに下記を設定してください。 `application/json`

Request Body schema: application/json

required

Array of objects[ items [ 2 .. 1000 ] ]

入力する緯度経度点列

形式

"shape":[{"lon":<経度1>,"lat":<緯度1>},{"lon":<経度2>,"lat":<緯度2>},...,{"lon":<経度n>,"lat":<緯度n>}]

地点は2地点以上1000地点以下を設定してください。

入力例

"shape":[
  {"lon":139.703360,"lat":35.69363},
  {"lon":139.703460,"lat":35.69368}
]

Responses

Request samples

Payload

Content type

application/json

{"shape": [{"lon": 139.70336,
"lat": 35.69363
},
{"lon": 139.70346,
"lat": 35.69368
}
]
}

Response samples

Content type

application/json

{"shape": [[139.70336,
35.69363
],
[139.70346,
35.69368
]
],
"edges": [{"link_id": 3292038,
"length": 0.018,
"begin_shape_index": 1,
"end_shape_index": 2,
"road_class": "motorway",
"detailed_road_class": 6,
"link_class": 1,
"toll": true,
"bridge": true,
"tunnel": true,
"railway_crossing": true,
"underpass": true,
"flood_caution_point": true,
"internal_intersection": true,
"caronly": true,
"smartic": 1,
"roundabout": true,
"names": ["C1",
"首都高速都心環状線",
"Metropolitan Expressway Inner Circular Route"
],
"roadwidth_code": 2,
"speed_limit": 100,
"lane_count": 3,
"zone30": true,
"signal": true,
"intersection_name": "中瀬三丁目",
"stop_point": true,
"nopassage": {"code": 1,
"times": [{"start_month": 9,
"start_day": 30,
"start_hour": 13,
"start_min": 0,
"end_month": 12,
"end_day": 1,
"end_hour": 22,
"end_min": 30,
"dayofweek": 1
}
]
},
"oneway": [{"direction": "forward",
"times": {"start_month": 9,
"start_day": 30,
"start_hour": 13,
"start_min": 0,
"end_month": 12,
"end_day": 1,
"end_hour": 22,
"end_min": 30,
"dayofweek": 1
}
}
],
"turnreg": [{"inf_id": 1627237,
"sequence": 1,
"max_sequence": 3,
"times": [{"start_month": 9,
"start_day": 30,
"start_hour": 13,
"start_min": 0,
"end_month": 12,
"end_day": 1,
"end_hour": 22,
"end_min": 30,
"dayofweek": 1
}
]
}
],
"sign": {"exit_name": ["汐留ＪＣＴ",
"汐留ランプ"
]
}
}
],
"matched_points": [{"type": "matched",
"lon": 139.444812,
"lat": 35.640524,
"edge_index": 5,
"distance_along_edge": 0.5,
"distance_from_trace_point": 0.172329
}
]
}