Квазар. API

версия v1 03.02.2022

Геокодирование

Поиск ближайшего объекта по заданным географическим координатам (широта и долгота) или географических координат по адресу

GET-запрос на адрес http://api.1traffic.ru/v1/geocode

Входные параметры

ПараметрЗначениеТипДиапазонПо умолчаниюОбязательный?
latШиротаfloat-89.0 ... 89.0да
lonДолготаfloat-180.0 ... 180.0да
qАдресstringJSONда
keyКлюч APIstringда

Пример запроса:

Ожидаемый ответ

{
    "result":"Москва, Таллинская улица, 2",
    "version":"1",
    "timestamp":1655467201,
    "calctime":0.000136,
    "query":["55.799446","37.39214"],
    "error_str":"OK",
    "error_code":200
}
                

Выходные параметры

ПараметрЗначениеТипДиапазонОбязательный?
resultАдресstringда
versionВерсия APIstringда
timestampДата/Время запросаintegerда
calctimeВремя вычисленияfloatда
queryЗапросstringда
error_strОписание ошибкиstringда
error_codeКод ошибкиintegerда

Расчет оптимального маршрута

GET-запрос на адрес http://api.1traffic.ru/v1/route

Входные параметры

ПараметрЗначениеТипДиапазонПо умолчаниюОбязательный?
lat1Широта началаfloat-89.0 ... 89.0да
lon1Долгота началаfloat-180.0 ... 180.0да
lat2Широта финишаfloat-89.0 ... 89.0да
lon2Долгота финишаfloat-180.0 ... 180.0да
keyКлюч APIstringда
Передается начальная и конечная точки маршрута.
При расчете учитывается текущее состояние загрузки (пробки), вычисляется оптимальный по времени маршрут.

Пример запроса:

Ожидаемый ответ

{
    "path":[[55.717975,37.38671],[55.717119,37.387163],...,[55.715761,37.380043]],
    "version":"1",
    "timestamp":1655467448,
    "calctime":0.000117,
    "start":["55.717986","37.386775"],
    "finish":["55.715738","37.380037"],
    "error_str":"OK",
    "error_code":200
}
                

Выходные параметры

ПараметрЗначениеТипДиапазонОбязательный?
pathНабор точекМассив [float, float]да
versionВерсия APIstringда
timestampДата/Время запросаintegerда
calctimeВремя вычисленияfloatда
startНачало маршрута[float, float]да
finishКонец маршрута[float, float]да
error_strОписание ошибкиstringда
error_codeКод ошибкиintegerда

Решение задачи коммивояжера

GET-запрос на адрес http://api.1traffic.ru/v1/tsp

Входные параметры

ПараметрЗначениеТипДиапазонПо умолчаниюОбязательный?
pointsКоординаты[float,float][-89.0 ... 89.0, -180.0 ... 180.0]да
keyКлюч APIstringда
Передается массив точек, состоящий из широты, долготы. Разделены ","
Минимальное количество точек — 2, максимальное - ограничено длиной HTTP GET-запроса.
Учитывается текущее состояние загрузки (пробки), рассчитывается оптимальный по времени маршрут, проходящий через все указанные точки.

Пример запроса:

Ожидаемый ответ

{
    "path":[[55.717975,37.38671],[55.717119,37.387163],...,[55.715761,37.380043]],
    "version":"1",
    "timestamp":1655467448,
    "calctime":0.000117,
    "start":["55.717986","37.386775"],
    "finish":["55.715738","37.380037"],
    "error_str":"OK",
    "error_code":200
}
                

Выходные параметры

ПараметрЗначениеТипДиапазонОбязательный?
pathНабор точекМассив [float, float]да
versionВерсия APIstringда
timestampДата/Время запросаintegerда
calctimeВремя вычисленияfloatда
error_strОписание ошибкиstringда
error_codeКод ошибкиintegerда