Получение оценки автомобиля

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

Автомобиль

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

VIN

vin (string) – модификация авто для оценки будет получена расшифровкой VIN.

Примечание. Не все параметры модификации могут быть распознаны по VIN.

Модификация автомобиля

modification (object) – уточненная модификация автомобиля в значениях каталога Авто.ру Бизнес.

Пример:

         {
         "brand": 127,
         "model": 3169,
         "creationYear": 2008,
         "body": 13,
         "doors": 4,
         "gear": 2,
         "drive": 1,
         "engine": 1,
         "volume": 1.4,
         "power": 75,
         "wheel": 1,
         "generation": 2736
         }          
        

Пробег автомобиля

mileage (integer) – Пробег оцениваемого автомобиля в километрах

Регион поиска похожих автомобилей

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

Регионы РФ

regionId (array[integer]) – для задания региона поиска рынка используются коды регионов, полученные ранее.

Для того чтобы передать несколько регионов, нужно указать каждый регион по отдельности. Например, &regionId=2491811&regionId=1960671

Радиус от заданных координат

geo (object) – для задания региона поиска используется радиус от координат автосалона. Оптимален для использования автоподбора похожих предложений.

Возможны следующие настройки:

• Координаты автосалона (lat, lon).
• Минимальный радиус подбора (radius).
• Максимальный радиус подбора (maxExtendingRadius) . Максимальное значение – 1000 км.

Пример:

         {
         "lat": 55.753215,
         "lon": 37.622504,
         "radius": 100,
         "maxExtendingRadius": 500
         }           
        

Пример автоматической настройки региона подбора похожих предложений

В некоторых небольших регионах, если задать регион подбора похожих только регионами РФ – количество запросов, для которых сервис не смог рассчитать оценку автомобиля, становится очень велико. В то же время использовать сразу расчет региона от координат не всегда корректно.

В этом случае необходимо настроить автоматическую смену способа получения региона подбора похожих.

Пример алгоритма:

1. Выполняете запрос на оценку автомобиля, в запросе указан параметр regionId. Получен ответ 422 – недостаточно данных для расчета оценки.
2. Запрашиваете оценку, используя параметр geo. Обязательно нужно указать регион для расчета ликвидности liquidityRegionId.

   Например, для Набережных Челнов можно указать так:

   
              {
              "lat": 55.72545,
              "lon": 52.41122,
              "radius": 100,
              "maxExtendingRadius": 1000,
              "liquidityRegionId": 1724646
              }              
             

   В этом случае по умолчанию рынок будет формироваться в окружности радиусом 100 км от указанной точки. Но если машин будет найдено слишком мало (меньше 10 или значения similarThreshold) - то радиус будет автоматически пошагово расширяться максимум до 1000 км от точки. Если опять получен ответ 422, переходим к п.3

3. Запрашиваете оценку по авто, используя весь список регионов (по всей России). Будет получена оценка с большой погрешностью, но практически всегда, кроме совсем редких моделей.

Целевое количество похожих предложений для оценки

similarThreshold – это минимальное количество предложений, до которого будет производиться расширение параметров подбора рынка. Если параметр не указан, используется значение по умолчанию (оно же минимальное допустимое) – 10 предложений.

Например, значение параметра задано similarThreshold=15, но при первом подборе система нашла только 10 похожих авто. Для расчета оценки рынок будет расширен по стандартному алгоритму до тех пор, пока не будет достигнуто число в 15 предложений или предел возможных способов расширения.

Регион оценки ликвидности

liquidityRegionId (integer) – Идентификатор региона, в котором будет производиться оценка ликвидности. Обязательно использовать если:

• используется регион поиска похожих предложений от радиуса;
• используется регион поиска похожих предложений, заданный несколькими регионами.

Если параметр не указан, а регион поиска похожих авто задан одним идентификатором региона, то он и будет использован в качестве региона оценки ликвидности.

Источники предложений

sources (array[string]) – определяет источники предложений, на основании которых будет произведена оценка. Если не указан, то используются все источники (auto.ru, avito.ru, drom.ru).

Результат выполнения

Пример

Оценивается Opel Insignia , 1 поколение, 2012, универсал, автомат, дизель, 2.0, 160 , полный привод только по данным auto.ru в Москве.

curl -X GET "https://appraisal.api.cm.expert/v1/appraisal?brand=114&model=1125&creationYear=2012&generation=2685&mileage=130000&body=13&doors=4&drive=1&gear=1&engine=2&power=160&volume=2.0&wheel=1&regionId=1960671&similarThreshold=10&liquidityRegionId=1960671&sources=auto_ru" -H "accept: application/json" -H "Authorization: Bearer <token>"

   {
   "priceCategories": {
   "low": {
   "min": 712503.8803752583,
   "max": 758470.9904281164
   },
   "middle": {
   "min": 758470.9904281164,
   "max": 804438.1004809744
   },
   "high": {
   "min": 804438.1004809744,
   "max": 850405.2105338325
   }
   },
   "correctedPriceCategories": {
   "low": {
   "min": 819235.2345497028,
   "max": 862327.744849901
   },
   "middle": {
   "min": 862327.744849901,
   "max": 905420.255150099
   },
   "high": {
   "min": 905420.255150099,
   "max": 948512.7654502972
   }
   },
   "similarCarsAvgMileage": 174539.63636363635,
   "similarCars": 11,
   "correctedAveragePriceMileage": 807589.7311976507,
   "removedParams": [
   "drive"
   ],
   "complexEstimate": 3,
   "complexMdsDays": 25
   }