Map Matching API

Спецификация OpenAPI

• Алгоритмы
  • postВосстановление маршрута

API docs by Redocly

2GIS Navigation API (6.0.0)

Алгоритмы

Восстановление маршрута

Восстановление автомобильного маршрута из набора точек, записанных транспортным средством.

query Parameters

key required

string API-ключ разработчика

Request Body schema: */*

required

Параметры запроса

required	Array of objects (QueryPoint) Массив точек для построения маршрута.
	boolean or null Если true, в участки построенного маршрута будут добавлены скоростные ограничения.

Responses

Response Schema: application/json

distance required	number <double> Длина восстановленного маршрута в метрах.
duration required	number Длительность восстановленного маршрута в секундах.
required	Array of objects (MatchedEdges)
required	Array of objects (MatchedQueryPoint)
route required	string Геометрия восстановленного маршрута в формате WKT.
status required	string (Status) Enum: "OK" "FAIL" Результат восстановления маршрута: OK - маршрут восстановить удалось, FAIL - маршрут восстановить не удалось,

http://routing.api.2gis.com/map_matching/1.0.0

https://routing.api.2gis.com/map_matching/1.0.0

Response samples

• 200
• 400

Content type

application/json

{

• "distance": 60.494,
• "duration": 5,
• "edges": [

  • {

    • "distance": 96.268,
    • "edge_id": 282909495821411,
    • "geometry": "LINESTRING(82.914962 55.05097,82.914834 55.05146)",
    • "speed_limit": 60

    }

  ],
• "query": [

  • {

    • "azimuth": 171,
    • "edge_id": 282909495821411,
    • "lat": 55.051097,
    • "lat_matched": 55.051095,
    • "lon": 82.914948,
    • "lon_matched": 82.914929,
    • "speed": 41,
    • "utc": 1623878771

    },
  • {

    • "azimuth": 171,
    • "edge_id": 282909495821411,
    • "lat": 55.051196,
    • "lat_matched": 55.051195,
    • "lon": 82.914914,
    • "lon_matched": 82.914903,
    • "speed": 42,
    • "utc": 1623878773

    },
  • {

    • "azimuth": 171,
    • "edge_id": 282909495821411,
    • "lat": 55.051289,
    • "lat_matched": 55.051288,
    • "lon": 82.914885,
    • "lon_matched": 82.914879,
    • "speed": 43.3,
    • "utc": 1623878775

    },
  • {

    • "azimuth": 171,
    • "edge_id": 282909495821411,
    • "lat": 55.051404,
    • "lat_matched": 55.051403,
    • "lon": 82.914866,
    • "lon_matched": 82.914849,
    • "speed": 42,
    • "utc": 1623878776

    }

  ],
• "route": "LINESTRING(82.914929 55.051096,82.914849 55.051403)",
• "status": "OK"

}