Map Matching API (v2.2)

Download OpenAPI specification:Download

For the requested sequence of latitude and longitude points (up to 1000 points) from GPS logs, etc., map matching is performed against the road network for automobiles, and the corrected sequence of latitude and longitude points and road attribute information are returned on the road network.

Map Matching

Map Matching API

For the requested latitude and longitude point sequence, we provide the following:

  • A sequence of corrected latitude and longitude points on the road network
  • Attribute information of matched roads

The following uses are anticipated:

  • Real-time tracking of the vehicle's precise location
  • By analyzing vehicle travel logs, we can identify the roads the vehicle traveled on and identify dangerous driving behavior by comparing it with road attribute information



Please note the following when using this API.

  • The range of latitude and longitude that can be matched is limited to within Japan.
  • If the latitude and longitude points you input are far from actual roads or are spaced too far apart, matching may fail or you may be mistakenly matched to other nearby roads.
  • 緯度経度1点のみをマッチングしたい場合は、shapeに同一緯度経度を2つ指定してください。
  • If the distance of the matching roads between input points exceeds 2,000 meters, matching will not be performed for that section.
    If the above conditions are met at all input points, a request error with status_code=400 will occur.
  • This API has a rate limit of 10 requests per second. When using this API continuously, please wait until the response to the previous request has been returned before submitting the next request.
  • For this API, page views (PV) are counted as 1 for each API call.

  • If the input coordinates are in a U-turn (backward) position due to GPS sway or other factors, the matching results may be as shown in the example below.
    • 結果例①
    • Example Result ②
    • Example Result ③
    • Example Result ④

Authorizations:
api_key
header Parameters
x-api-key
required
string

Authentication is performed using an API key.
Please enter the API key provided by our company.

content-type
required
string

Please set the following for content-type.
application/json

Request Body schema: application/json
required
Array of objects[ items [ 2 .. 1000 ] ]
Latitude and longitude sequence of points to enter

Format

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

Please set the number of points at least 2 points and no more than 1000 points.

Input example

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

Responses

Request samples

Content type
application/json
{
  • "shape": [
    ]
}

Response samples

Content type
application/json
{
  • "shape": [
    ],
  • "edges": [
    ],
  • "matched_points": [
    ]
}

Change history

Date Content
2024年7月17日 ・入力座標がUターン(後退)した位置となる場合の制限事項を追記
・レスポンス bridge の詳細仕様を追加
・レスポンス roundabout の制限事項・補足事項を追記
・レスポンス type=interpolated の詳細仕様を追記
2026年5月21日 ·responseintersection_typeAdd intersection type