Planogram Compliance - Match

Hizmet:

Cognitive Services - Computer Vision

API Sürümü:

2023-04-01-preview

Planogram eşleştirme işlemini bir planograma ve ürün anlama sonucuna karşı çalıştırın.

POST /planogramcompliance:match?api-version=2023-04-01-preview

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
api-version	query	True	string	İstenen API sürümü.

İstek Gövdesi

Media Types: "application/json-patch+json"

Name	Gerekli	Tür	Description
detectedProducts	True	ProductRecognitionResultApiModel	Ürün anlama işleminin sonuçları.
planogram	True	PlanogramApiModel	Planogram eşleştirme işlemleri için planogramı açıklar.

Yanıtlar

Name	Tür	Description
200 OK	PlanogramMatchingResultApiModel	Başarılı
Other Status Codes	ErrorResponse	Hata Üst Bilgiler x-ms-error-code: string

Örnekler

PlanogramCompliance_Match

Örnek isteği

HTTP

POST /planogramcompliance:match?api-version=2023-04-01-preview

{
  "detectedProducts": {
    "imageMetadata": {
      "width": 660,
      "height": 495
    },
    "products": [
      {
        "id": "1",
        "boundingBox": {
          "x": 197,
          "y": 68,
          "w": 356,
          "h": 394
        },
        "tags": [
          {
            "name": "class1",
            "confidence": 0.92431640625
          }
        ]
      }
    ],
    "gaps": [
      {
        "id": "1",
        "boundingBox": {
          "x": 197,
          "y": 68,
          "w": 356,
          "h": 394
        },
        "tags": [
          {
            "name": "gap",
            "confidence": 0.92431640625
          }
        ]
      }
    ]
  },
  "planogram": {
    "width": 10,
    "height": 16,
    "products": [
      {
        "id": "1",
        "name": "product-1",
        "w": 8,
        "h": 25
      }
    ],
    "fixtures": [
      {
        "id": "1",
        "w": 20,
        "h": 4,
        "x": 0,
        "y": 0
      }
    ],
    "positions": [
      {
        "id": "1",
        "productId": "1",
        "fixtureId": "1",
        "x": 0,
        "y": 0
      }
    ]
  }
}

Örnek yanıt

Durum kodu:

200

{
  "matchingResultPerPosition": [
    {
      "positionId": "0",
      "detectedObject": {
        "id": "0",
        "boundingBox": {
          "x": 197,
          "y": 68,
          "w": 356,
          "h": 394
        },
        "tags": [
          {
            "name": "class1",
            "confidence": 0.92431640625
          }
        ]
      }
    }
  ]
}

Tanımlar

Name	Description
BoundingBox	Görüntünün içindeki bir alan için sınırlayıcı kutu.
DetectedObject	Bir görüntüde algılanan nesneyi açıklar.
ErrorResponse	Bir hata oluştuğunda yanıt döndürülür.
ErrorResponseDetails	Hata bilgileri.
ErrorResponseInnerError	Ayrıntılı hata.
FixtureApiModel	Planogramdaki fikstürleri açıklar.
ImageMetadataApiModel	Yükseklik ve genişlik gibi görüntü meta veri bilgileri.
PlanogramApiModel	Planogram eşleştirme işlemleri için planogramı açıklar.
PlanogramMatchingRequestApiModel	Planogram eşleştirme işlemine geçirmek için giriş.
PlanogramMatchingResultApiModel	Planogram eşleştirme işleminin sonuçları.
PositionApiModel	Planogramdaki ürün konumunu açıklar.
PositionMatchingResultApiModel	Eşleştirilmiş planogram konum kimliği ve ürün anlama sonucundan karşılık gelen algılanan nesne.
ProductApiModel	Planogramdaki bir ürünü açıklar.
ProductRecognitionResultApiModel	Ürün anlama işleminin sonuçları.
Tag	Görüntüde güvenilirlik puanıyla birlikte bir varlık gözlemi.

BoundingBox

Görüntünün içindeki bir alan için sınırlayıcı kutu.

Name	Tür	Description
h	integer	Alanın sol üst noktasından piksel cinsinden ölçülen yükseklik.
w	integer	Alanın sol üst noktasından piksel cinsinden ölçülen genişlik.
x	integer	Alanın sol üst noktasının piksel cinsinden sol koordinatı.
y	integer	Alanın sol üst noktasının piksel cinsinden üst koordinatı.

DetectedObject

Bir görüntüde algılanan nesneyi açıklar.

Name	Tür	Description
boundingBox	BoundingBox	Görüntünün içindeki bir alan için sınırlayıcı kutu.
id	string	Algılanan nesnenin kimliği.
tags	Tag[]	Algılanan nesnenin sınıflandırma güvenleri.

ErrorResponse

Bir hata oluştuğunda yanıt döndürülür.

Name	Tür	Description
error	ErrorResponseDetails	Hata bilgileri.

ErrorResponseDetails

Hata bilgileri.

Name	Tür	Description
code	string	Hata kodu.
details	ErrorResponseDetails[]	Ayrıntılı hataların listesi.
innererror	ErrorResponseInnerError	Ayrıntılı hata.
message	string	Hata iletisi.
target	string	Hatanın hedefi.

ErrorResponseInnerError

Ayrıntılı hata.

Name	Tür	Description
code	string	Hata kodu.
innererror	ErrorResponseInnerError	Ayrıntılı hata.
message	string	Hata iletisi.

FixtureApiModel

Planogramdaki fikstürleri açıklar.

Name	Tür	Description
h	number	Fikstür yüksekliği.
id	string	Fikstürün kimliği.
w	number	Fikstür genişliği.
x	number	Inç veya santimetre cinsinden kaynaktan sol uzaklık.
y	number	Inç veya santimetre cinsinden menşeden en üst uzaklık.

ImageMetadataApiModel

Yükseklik ve genişlik gibi görüntü meta veri bilgileri.

Name	Tür	Description
height	integer	Görüntünün piksel cinsinden yüksekliği.
width	integer	Resmin piksel cinsinden genişliği.

PlanogramApiModel

Planogram eşleştirme işlemleri için planogramı açıklar.

Name	Tür	Description
fixtures	FixtureApiModel[]	Planogramdaki fikstürlerin listesi.
height	number	Planogramın yüksekliği.
positions	PositionApiModel[]	Planogramdaki konumların listesi.
products	ProductApiModel[]	Planogramdaki ürünlerin listesi.
width	number	Planogramın genişliği.

PlanogramMatchingRequestApiModel

Planogram eşleştirme işlemine geçirmek için giriş.

Name	Tür	Description
detectedProducts	ProductRecognitionResultApiModel	Ürün anlama işleminin sonuçları.
planogram	PlanogramApiModel	Planogram eşleştirme işlemleri için planogramı açıklar.

PlanogramMatchingResultApiModel

Planogram eşleştirme işleminin sonuçları.

Name	Tür	Description
matchingResultPerPosition	PositionMatchingResultApiModel[]	Her planogram konumu için eşleşen algılanan nesne bilgileri.

PositionApiModel

Planogramdaki ürün konumunu açıklar.

Name	Tür	Description
fixtureId	string	Ürünün üzerinde olduğu fikstürün kimliği.
id	string	Konumun kimliği.
productId	string	Ürünün kimliği.
x	number	Inç veya santimetre cinsinden kaynaktan sol uzaklık.
y	number	Inç veya santimetre cinsinden menşeden en üst uzaklık.

PositionMatchingResultApiModel

Eşleştirilmiş planogram konum kimliği ve ürün anlama sonucundan karşılık gelen algılanan nesne.

Name	Tür	Description
detectedObject	DetectedObject	Bir görüntüde algılanan nesneyi açıklar.
positionId	string	Planogramdaki konum kimliği, ilgili algılanan nesneyle eşleşmiş.

ProductApiModel

Planogramdaki bir ürünü açıklar.

Name	Tür	Description
h	number	Fikstür yüksekliği.
id	string	Ürünün kimliği.
name	string	Ürünün adı.
w	number	Ürünün genişliği.

ProductRecognitionResultApiModel

Ürün anlama işleminin sonuçları.

Name	Tür	Description
gaps	DetectedObject[]	Görüntüde boşluklar algılandı.
imageMetadata	ImageMetadataApiModel	Yükseklik ve genişlik gibi görüntü meta veri bilgileri.
products	DetectedObject[]	Görüntüde algılanan ürünler.

Tag

Görüntüde güvenilirlik puanıyla birlikte bir varlık gözlemi.

Name	Tür	Description
confidence	number	Varlığın gözlemlendiği güvenilirlik düzeyi.
name	string	Varlığın adı.