{
  "api": {
    "version": "1.0",
    "documentation": "https://indexbdd.ru/developers",
    "openapi": "https://indexbdd.ru/api/v1/openapi.json",
    "access": "Открытый, без авторизации и ограничений по частоте запросов"
  },
  "portal": {
    "name": "Рейтинг регионов по безопасности дорожного движения",
    "url": "https://indexbdd.ru",
    "description": "Сопоставимый рейтинг субъектов Российской Федерации по безопасности дорожного движения, рассчитанный по официальной статистике аварийности."
  },
  "license": {
    "terms": "Данные агрегированы из открытых источников и доступны для свободного использования.",
    "attribution": "При использовании просим ссылаться на источник: https://indexbdd.ru"
  },
  "data": {
    "years": [
      2025,
      2024,
      2023,
      2022
    ],
    "currentYear": 2022,
    "regionsTotal": 85,
    "regionsRanked": 80,
    "updateFrequency": "Ежегодно, после публикации официальной статистики за отчётный период",
    "historicalSeries": "Ряды динамики по ключевым показателям доступны с 2015 года на страницах регионов"
  },
  "methodology": {
    "method": "TOPSIS",
    "description": "Интегральная оценка рассчитывается методом TOPSIS: регион оценивается одновременно по близости к идеальному решению и удалённости от наихудшего по всем учитываемым показателям. Результат — шкала от 0 до 1. По оценке регионы ранжируются и распределяются по четырём уровням безопасности.",
    "details": "https://indexbdd.ru/about"
  },
  "levels": [
    {
      "id": "leading",
      "name": "Передовой",
      "order": 1
    },
    {
      "id": "high",
      "name": "Высокий",
      "order": 2
    },
    {
      "id": "medium",
      "name": "Средний",
      "order": 3
    },
    {
      "id": "low",
      "name": "Низкий",
      "order": 4
    }
  ],
  "metrics": [
    {
      "id": "score",
      "name": "Оценка безопасности",
      "unit": "индекс 0…1",
      "definition": "Интегральный показатель по методу TOPSIS, сводящий частные метрики в одно число. 1 — наивысший возможный уровень безопасности.",
      "betterWhen": "higher"
    },
    {
      "id": "socialRisk",
      "name": "Социальный риск",
      "unit": "погибших на 100 000 населения",
      "definition": "Число погибших в ДТП, приведённое к численности населения региона.",
      "betterWhen": "lower"
    },
    {
      "id": "transportRisk",
      "name": "Транспортный риск",
      "unit": "погибших на 10 000 транспортных средств",
      "definition": "Число погибших в ДТП, приведённое к количеству транспортных средств.",
      "betterWhen": "lower"
    },
    {
      "id": "severity",
      "name": "Тяжесть последствий ДТП",
      "unit": "погибших на 100 пострадавших",
      "definition": "Доля погибших среди всех пострадавших в ДТП (раненые и погибшие).",
      "betterWhen": "lower"
    },
    {
      "id": "killed",
      "name": "Погибшие",
      "unit": "человек за год",
      "definition": "Абсолютное число погибших в ДТП.",
      "betterWhen": "lower"
    },
    {
      "id": "injured",
      "name": "Раненые",
      "unit": "человек за год",
      "definition": "Абсолютное число раненых в ДТП.",
      "betterWhen": "lower"
    },
    {
      "id": "accidents",
      "name": "ДТП",
      "unit": "происшествий за год",
      "definition": "Абсолютное число дорожно-транспортных происшествий.",
      "betterWhen": "lower"
    },
    {
      "id": "population",
      "name": "Население",
      "unit": "человек",
      "definition": "Численность населения региона — знаменатель социального риска.",
      "betterWhen": "higher"
    }
  ],
  "excludedFromRating": {
    "reason": "Города федерального значения (высокая плотность населения, медленное движение) и малонаселённые автономные округа (малое число ДТП, статистическая неустойчивость) искажают сопоставление, поэтому в ранжировании не участвуют. Их показатели публикуются справочно.",
    "regions": [
      {
        "slug": "chukotka",
        "name": "Чукотский автономный округ",
        "code": "87"
      },
      {
        "slug": "nenets",
        "name": "Ненецкий автономный округ",
        "code": "83"
      },
      {
        "slug": "sevastopol",
        "name": "гор. Севастополь",
        "code": "92"
      },
      {
        "slug": "spb",
        "name": "гор. Санкт-Петербург",
        "code": "78"
      },
      {
        "slug": "moscow",
        "name": "гор. Москва",
        "code": "77"
      }
    ]
  },
  "sources": [
    {
      "name": "Росстат",
      "url": "https://rosstat.gov.ru/",
      "provides": "Численность населения, социально-экономические показатели"
    },
    {
      "name": "Научный центр БДД МВД России",
      "url": "https://нцбдд.мвд.рф/",
      "provides": "Аналитические обзоры состояния безопасности дорожного движения"
    },
    {
      "name": "Госавтоинспекция",
      "url": "https://гибдд.рф/",
      "provides": "Статистика дорожно-транспортных происшествий"
    },
    {
      "name": "ЕМИСС",
      "url": "https://www.fedstat.ru/",
      "provides": "Межведомственная статистика"
    }
  ],
  "endpoints": [
    {
      "method": "GET",
      "path": "/api/v1/meta",
      "description": "Этот документ: справочники, единицы измерения, методика"
    },
    {
      "method": "GET",
      "path": "/api/v1/regions",
      "description": "Все регионы за год. Параметры: year, format=json|csv, inRating=true|false"
    },
    {
      "method": "GET",
      "path": "/api/v1/regions/{slug}",
      "description": "Один регион по всем опубликованным годам. Параметр: year"
    }
  ]
}