Типы отчетов

Тип отчета в ответе на запрос указывается в поле type. В зависимости от типа отчета, содержимое объекта json в ответе будет отличаться.

FACING_COUNT

Отчет c типом FACING_COUNT содержит информацию обо всех распознанных в сцене SKU. Используется для измерения доли полки и ассортиментных показателей.

Мастер-данные: не требуются.

Пример json-объекта

[  
  {  
    "sku_id":10,    // идентификатор SKU
    "count":6,  // количество фейсов 
  },
// ...
]

SHARE_OF_SPACE

Отчет SHARE_OF_SPACE содержит информацию о доле фейсов и ширине фейсов для каждого распознанного SKU.

Мастер-данные: не требуются.

Пример json-объекта

[  
  {  
    "sku_id":10,                // SKU ID
    "share_of_count": 0.015,    // количество фейсов / фейсов всего
    "share_of_space": 0.017     // общая ширина фейсов SKU / общая ширина фото в сцене
  },
// ...
]

REALOGRAM

Отчет REALOGRAM выдает исходные координаты и размеры товаров и полок, которые распознаны на фото в сцене. Координаты SKU указаны относительно левого верхнего угла соответствующего изображения. «X» и «Y» — координаты центра прямоугольника, которыми очерчен товар. «H» и «W» - это высота и ширина этого прямоугольника.

Если изображения сцен перекрываются, то некоторые товары могут быть на нескольких отдельных изображениях. В таких случаях, для всех соответствующих аннотаций, кроме одной, поле duplicate будет иметь значение true.

Аннотация полки указывает начало («x1», «y1») и конечные координаты.

Мастер-данные: не требуются.

Пример json-объекта

[      
  {
    "image": 156673,    // идентификатор загруженного изображения
    "annotations": [    // список SKU, которые обнаружены на фото
      {
        "sku_id": 232,  // идентификатор SKU
        "x": 569,       // центр рамки по координате x
        "y": 312,       // центр рамки по координате y
        "h": 112,       // высота рамки
        "w": 112        // ширина рамки
        "duplicate": false
      },
      "shelf_annotations": [    // список полок, которые обнаружены на фото
        "x1": 45,               // x1, y1: начало полки в пикселях
        "y1": 63,
        "x2": 46,               // x2, y2: конец полки в пикселях
        "y2": 89
      ]
      // остальные товары на фото
    ]
  },
// остальные фото в сцене
]

PRICE_TAGS

Связывает SKU товаров и цены на основании распознанных ценников.

Мастер-данные: не требуются.

Пример json-объекта

[
  {  
    "sku_id":28,                                // идентификатор SKU
    "price": 130.57,                            // цена SKU
    "price_tag_colors": ["yellow", "white"]     // основные цвета ценников SKU
  },
]

MHL_COMPLIANCE

Сравнивает ассортимент SKU из сцены с заранее определенным списком обязательных товаров (MHL).

Мастер-данные: Must have list (MHL).

Пример json-объекта

{
  "mhl_id": 16752, // идентификатор листа MHL
  "compliance": 93.5,  // соответствие MHL в %
  "records": [
    {
      "mhl_record_id":70,   // идентификатор записи в MHL
      "compliant": false    // «True», если SKU распознано в сцене, иначе «False»
    },
    // ...
  ]
}

PLANOGRAM_COMPLIANCE

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

Мастер-данные: планограмма.

Пример json-объекта

{
  "planogram_id": 13249,     // идентификатор планограммы
  "compliance": 70.4,   // соответствие планограммы в %
  "images" : [
    {
      "image_id" : 7877,
      "actions": [              // предложения, как исправить соответствие
        {  
          "x": 569,    // центр рамки по координате x. Недоступно для действия ADD.
          "y": 312,        // центр рамки по координате y. Недоступно для действия ADD.
          "h": 112,    // высота рамки. Недоступно для действия ADD.
          "w": 112,    // ширина рамки. Недоступно для действия ADD.
          "shelf_index":2,         // идентификатор полки (сверху вниз, начиная с 0)
          "rack_index": 1,         // идентификатор стойки (слева направо, начиная с 0)
          "product_index": 7,        // положение полки (слева направо, начиная с 0)
          "sku_id": 77,        // идентификатор SKU, по результатам распознавания на фото
          "action_type": "ADD", // тип действия, ADD, DELETE или REPLACE
          "planogram_sku_id": 76, // Необязательно. Указывается, если «sku_action=REPLACE»
                                                       // идентификатор SKU из планограммы
                 // Описание для сотрудника. Язык предписания зависит от настроек портала
          "text": "Замените ACME Cola 2000 мл на ACME Orange 2000 мл" 
        }, 
        {"id" :2
          //...}
    }
  // ...

  ]
}

PANORAMA

Панорамное изображение, которое сформировано из изображений сцены. Обратите внимание, что не гарантируется, что вся сцена будет сшита в единую панораму. Поэтому формат отчета содержит список сшитых изображений.

Мастер-данные: не требуются.

Пример json-объекта

{
  "rendered": [ // для этой сцены было сшито одно изображение
    {
      "id": 156673,
      "url": "https:/test.inspector-cloud.com/media/ c118916f-36b5-4801-8910-c9fc1e575e33.jpg ",
      "width": 7200,
      "height": 12800,
    }
 ]
}