Рыночная цена ТС по объявлениям (модель-год)

• Описание
• Параметры запроса
• Структура отчёта

A.AM.0168.PRC.ACT-ADS

Содержит информацию о максимальной и минимальной рыночной стоимости ТС, которая рассчитывается на основе объявлений о продаже аналогичных автомобилей. Дополнительно приводится оптимальное значение стоимости ТС.

Цена автомобиля определяется по связке параметров: марка и модель, год выпуска, мощность двигателя. На основе этих данных формируется выборка объявлений с датами размещения не ранее 1 месяца от даты запроса. Эти объявления служат базой для расчёта стоимости автомобиля.

В отчёт можно включить объявления, на основе которых рассчитывалась стоимость. Максимальное количество объявлений в ответе — 20.

Источники данных — Дром.ру, Авито.ру, Авто.ру, Юла, Автокод Объявления.

Идентификаторы объекта: название марки и модели и год выпуска ТС.

Иcпользуемые источники: ads.price, references.base.

Время генерации отчёта:

• 50-й перцентиль — 1 с;
• 95-й перцентиль — 2 с.

Алгоритм расчёта цены ТС

1. На вход алгоритму поступает первичная выборка объявлений о продаже ТС согласно фильтрам, заданным в запросе к сервису.

2. Рабочая выборка извлекается из первичной выборки в два этапа:

   • грубая фильтрация объявлений: фильтр по цене (удаляются объявления с ценой вне диапазона 15 тыс. руб. — 100 млн руб.) → фильтр по пробегу (удаляются объявления с пробегом вне диапазона 0 км — 500 тыс. км) → фильтр по медиане (удаляются объявления с ценой, отличающейся от медианной цены выборки на этом шаге более, чем в 5 раз);
   • тонкая фильтрация объявлений: по максимальным и минимальным перцентилям цены и пробега.

   Объём рабочей выборки должен соответствовать заданному в параметрах алгоритма минимальному значению.

3. На основе рабочей выборки строится линейная регрессионная модель зависимости цены транспортного средства от пробега (вычисляются коэффициенты b0 и b1 в уравнении прямой зависимости цены от пробега price = b0 + b1 * mileage, причём угловой коэффициент прямой b1 должен быть отрицательным).
4. Если в запросе к сервису не задан целевой пробег (для которого нужно найти минимальное, оптимальное и максимальное значения цены), то целевой пробег находится как медиана пробегов из рабочей выборки.
5. По полученному уравнению прямой находится оптимальная цена для целевого пробега, а также прогнозное значение цены и относительное отклонение реальной цены от прогнозной для каждого объявления из рабочей выборки.
6. Находится заданный в параметрах алгоритма перцентиль (по умолчанию — 90) относительного отклонения реальной цены от прогнозной; если он меньше 0,01, то используется заданное в параметрах алгоритма значение (по умолчанию — 0,15).
7. На основе найденного перцентиля относительного отклонения цены вычисляются максимальная и минимальная цены относительно оптимальной цены как optimal_price * (1 ± relative_price_variance_percentile).
8. Полученные минимальное, оптимальное и максимальное значения цены ограничиваются снизу и сверху заданным в переменных алгоритма минимальным значением (по умолчанию — 15 тыс.) и максимальным значением (по умолчанию — 100 млн).
9. На выходе алгоритм предоставляет до 20 объявлений, на основе которых рассчитывалась стоимость, минимальную, оптимальную и максимальную цены и целевой пробег, а также кусочно-линейную функцию, состоящую из нескольких уравнений прямой.

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

При отправке запроса на генерацию отчёта в теле запроса указываются следующие параметры:

Пример тела запроса

{
  "queryType": "MULTIPART",
  "query": " ",
  "data": {
    "raw_mark_model": "tойоtа ленд kрузеp прадо ",
    "year": 2009
  }
}

Структура отчёта

Данные отчёта находятся в объекте data[].content тела ответа.

Справочник Тип валюты

Пример данных отчёта

{
  "data": [
    {
      "report_type_uid": "A.AM.0168.PRC.ACT-ADS_test_report@test_domain",
      "progress_ok": 2,
      "progress_wait": 0,
      "progress_error": 0,
      "state": {
        "sources": [
          {
            "_id": "references.base",
            "state": "OK",
            "extended_state": "OK"
          },
          {
            "_id": "ads.price",
            "state": "OK",
            "extended_state": "OK"
          }
        ]
      },
      "content": {
        "tech_data": {
          "brand": {
            "id": "ID_MARK_TOYOTA",
            "logotype": {
              "uri": "https://vl.imgix.net/img/toyota-logo.png"
            },
            "name": {
              "normalized": "Toyota"
            }
          },
          "model": {
            "id": "ID_MARK_TOYOTA_MODEL_LAND_CRUISER_PRADO",
            "name": {
              "normalized": "Land Cruiser Prado"
            }
          }
        },
        "market_prices": {
          "ads": {
            "items": [
              {
                "amount": {
                  "max": 2621159,
                  "min": 1598372,
                  "optimal": 2109766
                },
                "currency": {
                  "type": "RUB"
                }
              }
            ]
          }
        }
      }
    }
  ]
}