← На главную

Документация

База данных легковых автомобилей включает марки, модели, поколения с характеристиками и опциями комплектаций

Описание файлов

ФайлРазмерТариф
base.json121.1 МбСтандарт, Полный
base.sql63.3 МбСтандарт, Полный
base.csv66.9 МбСтандарт, Полный
base.xlsx76.8 МбСтандарт, Полный
logos.zip2.3 МбСтандарт, Полный
photos.zip1770 МбПолный

base.json

Вложенная структура:

Марка → Модель → Поколение → Конфигурация → Модификация → Характеристики и Опции

Пример:

[{
    "id": "AC",
    "name": "AC",
    "cyrillic-name": "АС",
    "popular": false,
    "country": "Великобритания",
    "models": [{
        "id": "378_GT",
        "name": "378 GT Zagato",
        "cyrillic-name": "378 ДжиТи Загато",
        "class": "S",
        "year-from": 2012,
        "year-to": 2012,
        "generations": [{
            "id": "20356221",
            "name": "I",
            "year-start": 2012,
            "year-stop": 2012,
            "is-restyle": false,
            "configurations": [{
                "id": "20465458",
                "doors-count": 2,
                "body-type": "купе",
                "notice": "",
                "modifications": [{
                    "complectation-id": "20465458__20465496",
                    "offers-price-from": null,
                    "offers-price-to": null,
                    "group-name": null,
                    "specifications": { ...50 полей }
                    "options": { ...158 полей* }
                ...
}]

* если есть комплектация group-name. complectation-id будет вида 123456_123456_123456
Описание полей ниже

base.sql

MySQL база состоит из 7 таблиц со связанными полями

Марка → Модель → Поколение → Конфигурация → Модификация → Характеристики и Опции

Пример таблиц:

mark

НазваниеТип данныхЗначение
id *varchar(50)AC
namevarchar(50)AC
cyrillic-namevarchar(50)АС
populartinyint0
countryvarchar(50)Великобритания

model

НазваниеТип данныхЗначение
id *varchar(50)378_GT
namevarchar(50)378 GT Zagato
cyrillic-namevarchar(50)378 ДжиТи Загато
classvarchar(5)S
year-fromsmallint2012
year-tosmallint2012
mark_id **varchar(50)AC

generation

НазваниеТип данныхЗначение
id *varchar(50)20356221
namevarchar(50)I
cyrillic-namevarchar(50)378 ДжиТи Загато
year-startsmallint2012
year-stopsmallint2012
is-restyletinyint0
model_id **varchar(50)378_GT

configuration

НазваниеТип данныхЗначение
id *varchar(50)20465458
doors-counttinyint2
body-typevarchar(50)купе
noticevarchar(50)null
generation_id **varchar(50)20356221

modification

НазваниеТип данныхЗначение
complectation-id *varchar(50)20465458__20465496
offers-price-fromintnull
offers-price-tointnull
group-namevarchar(100)null
configuration_id **varchar(50)20465458

specification

НазваниеТип данныхЗначение
configuration_id **varchar(50)20465458__20465496
...50 колонокvarchar(100)Описание

options

НазваниеТип данныхЗначение
configuration_id **varchar(50)20465458__20465496
...158 колонокvarchar(100)Описание

* уникальный ключ
** связь с предыдущей таблтцей [table]_id

base.csv

Таблица состоит из 234 колонок. Названия колонок соответствуют описанию полей ниже. Кодировка UTF-8, разделитель ","

base.xlsx

Таблица Excel 97-365 состоит из 234 колонок. Заголовки таблицы на русском языке. Не требует программирования.

logos.zip

Архив с логотипами марок легковых автомобилей в формате PNG (120x120px). Например BMW.png, где BMW это mark-id примеры в архиве с примером

photos.zip

Архив с фотографиями конфигураций в формате JPG (1280x960px). Например 2334233.jpg, где 2334233 это configuration-id
примеры в архиве с примером

Описание полей

Общая информация

КлючЗначение
mark-idID марки Соответствует файлу логотипа. Напр.BMW.png
mark-nameМарка
mark-cyrillic-nameМарка кириллица
mark-popularПопулярная марка
countryСтрана марки
model-idID модели
model-nameМодель
model-cyrillic-nameМодель кириллица
classКласс
year-fromГод начала модели
year-toГод окончания модели
generation-idID поколения
generation-nameПоколение
year-startГод начала поколения
year-stopГод окончания поколения
is-restyleРестайлинг
configuration-idID конфигурации Соответствует файлу фотографии. Напр. 23482364.jpg
doors-countКол-во дверей
body-typeКузов
noticeУточнение Уточнение к названию конфигурации. Напр. Gran Coupe
complectation-idID комплектации Формат X_Y_Z, где X - id конфигурации, Y - id комплектации (может не быть, тогда нет опций) Z - id характеристик
offers-price-fromПрайс от с auto.ru
offers-price-toПрайс до с auto.ru
group-nameКомплектация Есть опции

Характеристики

КлючЗначение
seatsКоличество мест
safety-ratingНазвание рейтинга безопасности
safety-gradeОценка безопасности
lengthДлина, мм
widthШирина, мм
heightВысота, мм
wheel-baseКолёсная база, мм
clearanceКлиренс, мм
front-wheel-baseШирина передней колеи, мм
back-wheel-baseШирина задней колеи, мм
wheel-sizeРазмер колёс, мм
trunks-min-capacityОбъем багажника мин, л
trunks-max-capacityОбъем багажника макс, л
fuel-tank-capacityОбъём топливного бака, л
weightСнаряженная масса, кг
full-weightПолная масса, кг
transmissionКоробка передач
gear-valueКоличество передач
driveТип привода
front-suspensionТип передней подвески
back-suspensionТип задней подвески
front-brakeПередние тормоза
back-brakeЗадние тормоза
max-speedМаксимальная скорость, км/ч
time-to-100Разгон до 100 км/ч, с
consumption-mixedРасход топлива в смешанном цикле на 100 км, л
consumption-hiwayРасход топлива на трассе на 100 км, л
consumption-cityРасход топлива в городе на 100 км, л
petrol-typeМарка топлива
emission-euro-classЭкологический класс
fuel-emissionВыбросы CO²
engine-typeТип двигателя
engine-orderРасположение двигателя
volumeОбъем двигателя, см³
volume-litresОбъем двигателя, л
feedingТип наддува
horse-powerМощность, л.с.
kvt-powerМощность, кВт
momentМаксимальный крутящий момент, Н*м
moment-rpmОбороты макс. крутящего момента, об/мин
rpm-powerОбороты макс. мощности, об/мин
cylinders-orderРасположение цилиндров
cylinders-valueКоличество цилиндров
valvesЧисло клапанов на цилиндр
engine-feedingСистема питания двигателя
compressionСтепень сжатия
diametrДиаметр цилиндра, мм
piston-strokeХод поршня, мм
electric-rangeЗапас хода на электричестве, км
battery-capacityЕмкость батареи, кВт⋅ч
charge-timeВремя зарядки, ч

Опции

Значения:
1 - опция есть
N (больше 1) - доп. опция за N рублей

КлючЗначение
alcantaraАлькантара (Материал салона)
black-roofОтделка потолка чёрного цвета
combo-interiorКомбинированный (Материал салона)
decorative-interior-lightingДекоративная подсветка салона
door-sill-panelНакладки на пороги
driver-seat-electricЭлектрорегулировка сиденья водителя
driver-seat-memoryПамять сиденья водителя
driver-seat-supportСиденье водителя с поясничной поддержкой
driver-seat-updownРегулировка сиденья водителя по высоте
eco-leatherИскусственная кожа (Материал салона)
electro-rear-seatЭлектрорегулировка задних сидений
fabric-seatsТкань (Материал салона)
folding-front-passenger-seatФункция складывания спинки сиденья пассажира
folding-tables-rearСкладной столик на спинках передних сидений
front-centre-armrestПередний центральный подлокотник
front-seat-supportПередние сиденья с поясничной поддержкой
front-seats-heatПодогрев передних сидений
front-seats-heat-ventВентиляция передних сидений
hatchЛюк
leatherКожа (Материал салона)
leather-gear-stickОтделка кожей рычага КПП
massage-seatsСиденья с массажем
panorama-roofПанорамная крыша / лобовое стекло
passenger-seat-electricЭлектрорегулировка передних сидений
passenger-seat-updownРегулировка передних сидений по высоте
rear-seat-heat-ventВентиляция задних сидений
rear-seat-memoryПамять задних сидений
rear-seats-heatПодогрев задних сидений
roller-blind-for-rear-windowСолнцезащитная шторка на заднем стекле
roller-blinds-for-rear-side-windowsСолнцезащитные шторки в задних дверях
seat-memoryПамять передних сидений
seat-transformationСкладывающееся заднее сиденье
sport-pedalsДекоративные накладки на педали
sport-seatsСпортивные передние сиденья
third-rear-headrestТретий задний подголовник
third-row-seatsТретий ряд сидений
tinted-glassТонированные стекла
wheel-heatОбогрев рулевого колеса
wheel-leatherОтделка кожей рулевого колеса
360-cameraКамера 360°
adj-pedalsРегулируемый педальный узел
ashtray-and-cigarette-lighterПрикуриватель и пепельница
auto-cruiseАдаптивный круиз-контроль
auto-mirrorsЭлектроскладывание зеркал
auto-parkСистема автоматической парковки
climate-control-1Климат-контроль 1-зонный
climate-control-2Климат-контроль 2-зонный
computerБортовой компьютер
conditionКондиционер
cooling-boxОхлаждаемый перчаточный ящик
cruise-controlКруиз-контроль
drive-mode-sysСистема выбора режима движения
e-adjustment-wheelЭлектрорегулировка руля
easy-trunk-openingОткрытие багажника без помощи рук
electro-mirrorsЭлектропривод зеркал
electro-trunkЭлектропривод крышки багажника
electro-window-backЭлектростеклоподъёмники задние
electro-window-frontЭлектростеклоподъёмники передние
electronic-gage-panelЭлектронная приборная панель
front-cameraКамера передняя
keyless-entryСистема доступа без ключа
multi-wheelМультифункциональное рулевое колесо
multizone-climate-controlКлимат-контроль многозонный
park-assist-fПарктроник передний
park-assist-rПарктроник задний
power-latching-doorsДоводчик дверей
programmed-block-heaterПрограммируемый предпусковой отопитель
projection-displayПроекционный дисплей
rear-cameraКамера задняя
remote-engine-startДистанционный запуск двигателя
servoАктивный усилитель руля
start-buttonЗапуск двигателя с кнопки
start-stop-functionСистема «старт-стоп»
steering-wheel-gear-shift-paddlesПодрулевые лепестки переключения передач
wheel-configuration1Регулировка руля по высоте
wheel-configuration2Регулировка руля по вылету
wheel-memoryРулевая колонка с памятью положения
wheel-powerУсилитель руля
adaptive-lightСистема адаптивного освещения
automatic-lighting-controlАвтоматический корректор фар
drlДневные ходовые огни
heated-wash-systemЭлектрообогрев форсунок стеклоомывателей
high-beam-assistСистема управления дальним светом
laser-lightsЛазерные фары
led-lightsСветодиодные фары
light-cleanerОмыватель фар
light-sensorДатчик света
mirrors-heatЭлектрообогрев боковых зеркал
ptfПротивотуманные фары
rain-sensorДатчик дождя
windcleaner-heatЭлектрообогрев зоны стеклоочистителей
windscreen-heatЭлектрообогрев лобового стекла
xenonКсеноновые/Биксеноновые фары
absАнтиблокировочная система (ABS)
airbag-curtainПодушки безопасности оконные (шторки)
airbag-driverПодушка безопасности водителя
airbag-passengerПодушка безопасности пассажира
airbag-rear-sideПодушки безопасности боковые задние
airbag-sideПодушки безопасности боковые
asrАнтипробуксовочная система (ASR)
basСистема помощи при торможении (BAS, EBD)
blind-spotСистема контроля слепых зон
collision-prevention-assistСистема предотвращения столкновения
dhaСистема помощи при спуске
drowsy-driver-alert-systemДатчик усталости водителя
espСистема стабилизации (ESP)
feedback-alarmСигнализация с обратной связью
glonassЭРА-ГЛОНАСС
hccСистема помощи при старте в гору (HSA)
isofixКрепление детского кресла (задний ряд) ISOFIX
isofix-frontКрепление детского кресла (передний ряд) ISOFIX
knee-airbagПодушка безопасности для защиты коленей водителя
laminated-safety-glassЛаминированные боковые стекла
lane-keeping-assistСистема контроля за полосой движения
night-visionСистема ночного видения
power-child-locks-rear-doorsБлокировка замков задних дверей
traffic-sign-recognitionСистема распознавания дорожных знаков
tyre-pressureДатчик давления в шинах
vsmСистема стабилизации рулевого управления (VSM)
alarmСигнализация
immoИммобилайзер
lockЦентральный замок
volume-sensorДатчик проникновения в салон (датчик объема)
12v-socketРозетка 12V
220v-socketРозетка 220V
android-autoAndroid Auto
apple-carplayCarPlay
audiopreparationАудиоподготовка
audiosystem-cdАудиосистема
audiosystem-tvМультимедиа система с ЖК-экраном
auxAUX
bluetoothBluetooth
entertainment-system-for-rear-seat-passengersМультимедиа система для задних пассажиров
music-superПремиальная аудиосистема
navigationНавигационная система
usbUSB
voice-recognitionГолосовое управление
wireless-chargerБеспроводная зарядка для смартфона
ya-autoЯндекс.Авто
activ-suspensionАктивная подвеска
air-suspensionПневмоподвеска
reduce-spare-wheelДокатка
spare-wheelПолноразмерное запасное колесо
sport-suspensionСпортивная подвеска
14-inch-wheelsДиски 14
15-inch-wheelsДиски 15
16-inch-wheelsДиски 16
17-inch-wheelsДиски 17
18-inch-wheelsДиски 18
19-inch-wheelsДиски 19
20-inch-wheelsДиски 20
21-inch-wheelsДиски 21
22-inch-wheelsДиски 22
body-kitОбвес кузова
body-mouldingsДекоративные молдинги
duo-body-colorДвухцветная окраска кузова
paint-metallicМеталлик
roof-railsРейлинги на крыше
steel-wheelsСтальные диски

Вспомогательные файлы

ФайлОписание
options.jsonсписок опций разделенный на категории
specifications.jsonсписок характеристик разделенный на категории
dictionary.jsonсловарь для локализации

dictionary.json

{
  "GASOLINE": "бензин",
  "ELECTRO": "электро",
  "DIESEL": "дизель",
  "HYBRID": "гибрид",
  "LPG": "СУГ",
  "H2": "гидроген",
  "MECHANICAL": "механическая",
  "AUTOMATIC": "автоматическая",
  "ROBOT": "робот",
  "VARIATOR": "вариатор",
  "COUPE": "купе",
  "ROADSTER": "родстер",
  "SEDAN": "седан",
  "SEDAN_2_DOORS": "седан 2 дв.",
  "HATCHBACK_3_DOORS": "хэтчбек 3 дв.",
  "HATCHBACK_4_DOORS": "хэтчбек 4 дв.",
  "HATCHBACK_5_DOORS": "хэтчбек 5 дв.",
  "ALLROAD_5_DOORS": "внедорожник 5 дв.",
  "ALLROAD_3_DOORS": "внедорожник 3 дв.",
  "ALLROAD_OPEN": "внедорожник открытый",
  "WAGON": "универсал",
  "WAGON_5_DOORS": "универсал 5 дв.",
  "WAGON_3_DOORS": "универсал 3 дв.",
  "CABRIO": "кабриолет",
  "TARGA": "тарга",
  "COUPE_HARDTOP": "купе-хардтоп",
  "MINIVAN": "минивэн",
  "LIFTBACK": "лифтбек",
  "SPEEDSTER": "спидстер",
  "LIMOUSINE": "лимузин",
  "PICKUP_ONE": "пикап одинарная кабина",
  "PICKUP_ONE_HALF": "пикап полуторная кабина",
  "PICKUP_TWO": "пикап двойная кабина",
  "COMPACTVAN": "компактвэн",
  "FASTBACK": "фастбек",
  "SEDAN_HARDTOP": "седан-хардтоп",
  "MICROVAN": "микровэн",
  "VAN": "фургон",
  "PHAETON": "фаэтон",
  "PICKUP": "пикап",
  "REAR_DRIVE": "задний",
  "FORWARD_CONTROL": "передний",
  "ALL_WHEEL_DRIVE": "полный",
  "Disc": "дисковые",
  "Ventilated disc": "дисковые вентилируемые",
  "Drum": "барабанные",
  "Ventilated ceramic": "керамические вентилируемые",
  "Ceramic": "керамические",
  "None": "нет",
  "Turbocharger": "турбонаддув",
  "Mechanical supercharger": "компрессор",
  "V-SHAPED": "V-образное",
  "IN-LINE": "рядное",
  "OPPOSITE": "оппозитное",
  "ROTARY": "ротор",
  "W-SHAPED": "W-образное",
  "V-SHAPED-SA": "V-образное с малым углом",
  "Multipoint fuel injection": "распределенный впрыск (многоточечный)",
  "Direct fuel injection": "непосредственный впрыск (прямой)",
  "Dual fuel injection": "комбинированный впрыск (непосредственно-распределенный)",
  "Carburetor": "карбюратор",
  "common_rail": "аккумуляторная топливная система",
  "injection_pump": "топливный насос высокого давления",
  "Central fuel injection": "центральный впрыск (моновпрыск или одноточечный)",
  "unit_injector": "насос-форсунка",
  "Front transverse engine": "переднее, поперечное",
  "Mid-engine": "центральное",
  "Front Longitudinal engine": "переднее, продольное",
  "Rear engine": "заднее",
  "95 RON": "АИ-95",
  "92 RON": "АИ-92",
  "98 RON": "АИ-98",
  "76 RON": "АИ-76",
  "80 RON": "АИ-80",
  "GAS": "газ",
  "Diesel": "ДТ",
  "hydrogen": "водород",
  "Independent, coil suspension": "независимая, пружинная",
  "Independent, leaf suspension": "независимая, рессорная",
  "Independent, torsion bar suspension": "независимая, торсионная",
  "Conventional, leaf suspension": "зависимая, рессорная",
  "Independent, pneumatic suspension": "независимая, пневмоэлемент",
  "Conventional, pneumatic suspension": "зависимая, пневмоэлемент",
  "Conventional, coil suspension": "зависимая, пружинная",
  "Independent, hydropneumatic suspension": "независимая, гидропневмоэлемент",
  "Semi-independent, torsion bar suspension": "полунезависимая, торсионная"
}

API

EndpointОписание
/api/statusДата последнего обновления, предыдущего обновления и информация о них
/api/cars?full=1Марки и модели авто (включая русское произношение)
/api/carsМарки автомобилей
/api/cars/[mark_id]Модели марки с id марки
/api/download/[file.name]?key=[key]Скачивание файла [file.name] (напр. base.json), где [key] это ваш ключ
/api/cars/[mark_id]/[model_id]?key=[key]Поколения модели с id модели
/api/cars/[mark_id]/[model_id]/[generation_id]?key=[key]Конфигурации id поколения