Квазар. API

версия 29.01.18 banana (mandarina add)

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

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

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

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

ПараметрЗначениеТипДиапазонПо умолчаниюОбязательный?
latШиротаfloat-89.0 ... 89.0да
lonДолготаfloat-180.0 ... 180.0да
formatФормат выводаstringXML, JSON, PLAINJSONнет
distanceОбласть поиска (метры)integer0 .. 1000050нет
keyКлюч APIstringда

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

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


distance: 5898.84985867
parent: муниципальный район Малодербетовский, республика Калмыкия, Российская Федерация
title: с Плодовитое
lon: 44.408252632
okato: 85 220 866 001
kladr: 0800700000700
oktmo: 
lat: 48.139853313
type: town_pnt
id: 89429
postcode: 359422
                

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

ПараметрЗначениеТипДиапазонОбязательный?
latШиротаfloat-89.0 ... 89.0да
lonДолготаfloat-180.0 ... 180.0да
titleНазвание объектаstringда
parentРасположение объектаstringнет
typeТип объектаstringcountry, okrug, admin, admin1, admin2,
town, town_pnt, road, address
да
type_descriptionОписание типа объектаstringнет
idИдентификатор объектаintegerда
distanceРасстояние до объектаfloatда
okatoКод ОКАТОstringнет
oktmoКод ОКТМОstringнет
kladrКод КЛАДРintegerнет
postcodeПочтовый индексintegerнет
alternativeАльтернативное названиеstringнет

Поиск

Поиск по ключевым словам в адресной базе

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

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

ПараметрЗначениеТипДиапазонПо умолчаниюОбязательный?
qЗапросstringда
formatФормат выводаstringXML, JSON, PLAINJSONнет
keyКлюч APIstringда

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

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

<reply>
<title>Таллинская улица, 12</title>
<parent>г. Москва, Россия</parent>
<lat>55.798298</lat>
<lon>37.397413</lon>
</reply>

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

ПараметрЗначениеТипДиапазонОбязательный?
latШиротаfloat-89.0 ... 89.0да
lonДолготаfloat-180.0 ... 180.0да
titleНазвание объектаstringда
parentРасположение объектаstringнет

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

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

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

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

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


Информация о POI

Получение информации о заправочных станциях (АЗС). Всего доступна информация о 29092 станциях. Цена топлива предоставляется по отдельному соглашению.

GET-запрос на адрес http://api.1traffic.ru/searc/poi/azs

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

ПараметрЗначениеТипДиапазонПо умолчаниюОбязательный?
latШиротаfloat-89.0 ... 89.0да
lonДолготаfloat-180.0 ... 180.0да
formatФормат выводаstringXML, JSON, PLAINJSONнет
keyКлюч APIstringда

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

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

{
    "lat": 55.776345,
    "lon": 37.671028,
    "brand": "ТрансАЗС",
    "name": "АЗС №09",
    "address": "г. Москва, ул. Нижняя Красносельская, д. 25, стр.1"
}
                

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

ПараметрЗначениеТипДиапазонОбязательный?
latШиротаfloat-89.0 ... 89.0да
lonДолготаfloat-180.0 ... 180.0да
nameНазвание объектаstringда
brandСеть АЗСstringнет
addressРасположение объектаstringнет

Определение нарушений ПДД

Определяются следующие нарушения ПДД РФ:

1. Превышение скорости с запасом на отрезке дорожной сети, учитывается любое превышение, включая 1 км/ч. Возвращается в разделе "overspeed".

POST-запрос на адрес http://api.1traffic.ru/detect/violations

GET-запросы игнорируются

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

ПараметрЗначениеТипДиапазонПо умолчаниюОбязательный?
keyКлюч APIstringда
Передается массив точек, состоящий из широты, долготы, скорости и времени в UTC. Параметры разделены ",", в конце строки - "\n" (аналог CSV).

55.66703399553134, 37.08022180562994, 81, 1517201605
55.68298145365957, 37.07581436529225, 83, 1517202035
                    
Количество записей ограничено разумным пределом, скорость расчета напрямую зависит от количества предоставленных точек.

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

http://api.1traffic.ru/detect/violations (с указанным выше примером в POST)

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

{
    "overspeed": [
        {
            "timestamp": 1517201605,
            "max_speed": 60,
            "real_speed": 81
            "coords": [
                55.66703399553134,
                37.08022180562994
            ]
        },
        {
            "timestamp": 1517202035,
            "max_speed": 60,
            "real_speed": 83
            "coords": [
                55.68298145365957,
                37.07581436529225
            ]
        }
    ]
}
                

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

РазделЗначение
overspeedПревышение скорости
errorСистемные ошибки (при наличии)
ПараметрЗначениеТипДиапазон
timestampВремя событияint
max_speedРазрешенная скоростьinteger0 ... 250
real_speedДостигнутая скоростьinteger0 ... 250
coordsКоординаты события (lat, lon)float[-180.0 ... 180.0, -89.0 ... 89.0]

Тайлы карты

Передается карта России и зарубежья в виде тайлов.

Карта формируется из отдельных растровых изображений (PNG 256x256 пикселов) – тайлов. Сервис тайлов предоставляет доступ к этим изображениям, которые могут быть использованы для отображения карты на публичных сайтах и в мобильных приложениях.
Обновление карты происходит ежеквартально.

GET-запрос на адрес http://api.1traffic.ru/tiles/map/{z}/{x}/{y}.png

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

ПараметрЗначениеТипДиапазонПо умолчаниюОбязательный?
zМасштабint1..17да
yКоординаты по вертикали (широте)intот 0 до 2z−1да
xМасштабintот 0 до 2z−1да

Например:

http://api.1traffic.ru/tiles/map/8/154/80.png

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

Пример подключения тайлов с помощью библиотеки OpenLayers

var map = new OpenLayers.Map('map', options);
var layer = new OpenLayers.Layer.XYZ('1traffic', [
       'http://api.1traffic.ru/tiles/map/${z}/${x}/${y}.png',
]);
map.addLayer(layer);

Пример подключения тайлов с помощью библиотеки Leaflet

L.tileLayer('http://api.1traffic.ru/tiles/map/{z}/{x}/{y}.png')

Тайлы текущей загруженности

Передается карта пробок в России в виде тайлов.

Карта формируется из отдельных растровых изображений (PNG 256x256 пикселов) – тайлов. Сервис тайлов предоставляет доступ к этим изображениям, которые могут быть использованы для отображения карты пробок на публичных сайтах и в мобильных приложениях.
Обновление карты пробок происходит каждые 5 минут.

GET-запрос на адрес http://api.1traffic.ru/tiles/jams/{z}/{x}/{y}.png

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

ПараметрЗначениеТипДиапазонПо умолчаниюОбязательный?
zМасштабint1..17да
yКоординаты по вертикали (широте)intот 0 до 2z−1да
xМасштабintот 0 до 2z−1да

Например:

http://api.1traffic.ru/tiles/jams/8/154/80.png

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

Пример подключения тайлов с помощью библиотеки OpenLayers

var map = new OpenLayers.Map('map', options);
var layer = new OpenLayers.Layer.XYZ('1traffic', [
       'http://api.1traffic.ru/tiles/jams/${z}/${x}/${y}.png',
]);
map.addLayer(layer);

Пример подключения тайлов с помощью библиотеки Leaflet

L.tileLayer('http://api.1traffic.ru/tiles/jams/{z}/{x}/{y}.png')

Тайлы спутниковой съемки

Передается карта мира в виде тайлов.

Карта формируется из отдельных растровых изображений (PNG 256x256 пикселов) – тайлов. Сервис тайлов предоставляет доступ к этим изображениям, которые могут быть использованы для отображения карты пробок на публичных сайтах и в мобильных приложениях.

GET-запрос на адрес http://api.1traffic.ru/tiles/sat/{z}/{x}/{y}.png

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

ПараметрЗначениеТипДиапазонПо умолчаниюОбязательный?
zМасштабint1..17да
yКоординаты по вертикали (широте)intот 0 до 2z−1да
xМасштабintот 0 до 2z−1да

Например:

http://api.1traffic.ru/tiles/sat/14/5116/9892.png

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

Пример подключения тайлов с помощью библиотеки OpenLayers

var map = new OpenLayers.Map('map', options);
var layer = new OpenLayers.Layer.XYZ('1traffic', [
       'http://api.1traffic.ru/tiles/sat/${z}/${x}/${y}.png',
]);
map.addLayer(layer);

Пример подключения тайлов с помощью библиотеки Leaflet

L.tileLayer('http://api.1traffic.ru/tiles/sat/{z}/{x}/{y}.png')

Клиентские тайлы

GET-запрос на адрес http://api.1traffic.ru/tiles/clients/ИДЕНТИФИКАТОР_КЛИЕНТА/ИДЕНТИФИКАТОР_НАБОРА/{z}/{x}/{y}.png

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

ПараметрЗначениеТипДиапазонПо умолчаниюОбязательный?
zМасштабint1..17да
yКоординаты по вертикали (широте)intот 0 до 2z−1да
xМасштабintот 0 до 2z−1да

Пример подключения тайлов с помощью библиотеки OpenLayers

var map = new OpenLayers.Map('map', options);
var layer = new OpenLayers.Layer.XYZ('client', [
   'http://api.1traffic.ru/tiles/clients/ИДЕНТИФИКАТОР_КЛИЕНТА/ИДЕНТИФИКАТОР_НАБОРА/${z}/${x}/${y}.png',
]);
map.addLayer(layer);

Пример подключения тайлов с помощью библиотеки Leaflet

L.tileLayer('http://api.1traffic.ru/tiles/clients/ИДЕНТИФИКАТОР_КЛИЕНТА/ИДЕНТИФИКАТОР_НАБОРА/{z}/{x}/{y}.png')