Planogram Compliance - Match

참조

서비스:: Cognitive Services - Computer Vision

API 버전:: 2023-04-01-preview

planogram 및 제품 이해 결과에 대해 planogram 일치 작업을 실행합니다.

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

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
api-version	query	True	string	요청된 API 버전입니다.

요청 본문

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

Name	필수	형식	Description
detectedProducts	True	ProductRecognitionResultApiModel	Product Understanding 작업의 결과입니다.
planogram	True	PlanogramApiModel	플래노그램 일치 작업에 대한 플래노그램을 설명합니다.

응답

Name	형식	Description
200 OK	PlanogramMatchingResultApiModel	성공
Other Status Codes	ErrorResponse	오류 헤더 x-ms-error-code: string

Name

형식

Description

200 OK

PlanogramMatchingResultApiModel

성공

Other Status Codes

ErrorResponse

오류

헤더

x-ms-error-code: string

예제

PlanogramCompliance_Match

샘플 요청

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
      }
    ]
  }
}

샘플 응답

상태 코드:: 200

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

정의

Name	Description
BoundingBox	이미지 내 영역의 경계 상자입니다.
DetectedObject	이미지에서 감지된 개체를 설명합니다.
ErrorResponse	오류가 발생할 때 응답이 반환됩니다.
ErrorResponseDetails	오류 정보입니다.
ErrorResponseInnerError	자세한 오류입니다.
FixtureApiModel	평면도의 픽스처에 대해 설명합니다.
ImageMetadataApiModel	높이 및 너비와 같은 이미지 메타데이터 정보입니다.
PlanogramApiModel	플래노그램 일치 작업에 대한 플래노그램을 설명합니다.
PlanogramMatchingRequestApiModel	평면도 일치 작업에 전달할 입력입니다.
PlanogramMatchingResultApiModel	평면도 일치 작업의 결과입니다.
PositionApiModel	플라노그램의 제품 위치를 설명합니다.
PositionMatchingResultApiModel	제품 이해 결과에서 플라노그램 위치 ID와 해당 감지 개체를 페어링합니다.
ProductApiModel	플래노그램으로 제품을 설명합니다.
ProductRecognitionResultApiModel	Product Understanding 작업의 결과입니다.
Tag	신뢰도 점수와 함께 이미지의 엔터티 관찰입니다.

BoundingBox

이미지 내 영역의 경계 상자입니다.

Name	형식	Description
h	integer	영역 왼쪽 상단 지점에서 시작해 측정된 높이(픽셀)입니다.
w	integer	영역 왼쪽 상단 지점에서 시작해 측정된 너비(픽셀)입니다.
x	integer	영역 왼쪽 상단 지점의 왼쪽 좌표(픽셀)입니다.
y	integer	영역 왼쪽 상단 지점의 위쪽 좌표(픽셀)입니다.

DetectedObject

이미지에서 감지된 개체를 설명합니다.

Name	형식	Description
boundingBox	BoundingBox	이미지 내 영역의 경계 상자입니다.
id	string	검색된 개체의 ID입니다.
tags	Tag[]	감지된 개체의 분류 신뢰도입니다.

ErrorResponse

오류가 발생할 때 응답이 반환됩니다.

Name	형식	Description
error	ErrorResponseDetails	오류 정보입니다.

ErrorResponseDetails

오류 정보입니다.

Name	형식	Description
code	string	오류 코드
details	ErrorResponseDetails[]	자세한 오류 목록입니다.
innererror	ErrorResponseInnerError	자세한 오류입니다.
message	string	오류 메시지입니다.
target	string	오류의 대상입니다.

ErrorResponseInnerError

자세한 오류입니다.

Name	형식	Description
code	string	오류 코드
innererror	ErrorResponseInnerError	자세한 오류입니다.
message	string	오류 메시지입니다.

FixtureApiModel

평면도의 픽스처에 대해 설명합니다.

Name	형식	Description
h	number	고정 장치의 높이.
id	string	픽스처의 ID입니다.
w	number	고정 장치의 너비.
x	number	원점의 왼쪽 오프셋(인치 또는 센티미터 단위)입니다.
y	number	원점의 위쪽 오프셋(인치 또는 센티미터 단위)입니다.

ImageMetadataApiModel

높이 및 너비와 같은 이미지 메타데이터 정보입니다.

Name	형식	Description
height	integer	이미지의 높이(픽셀)입니다.
width	integer	이미지의 너비(픽셀)입니다.

PlanogramApiModel

플래노그램 일치 작업에 대한 플래노그램을 설명합니다.

Name	형식	Description
fixtures	FixtureApiModel[]	플래노그램의 고정 장치 목록입니다.
height	number	플래노그램의 높이.
positions	PositionApiModel[]	플래노그램의 위치 목록입니다.
products	ProductApiModel[]	플래노그램의 제품 목록입니다.
width	number	플래노그램의 너비.

PlanogramMatchingRequestApiModel

평면도 일치 작업에 전달할 입력입니다.

Name	형식	Description
detectedProducts	ProductRecognitionResultApiModel	Product Understanding 작업의 결과입니다.
planogram	PlanogramApiModel	플래노그램 일치 작업에 대한 플래노그램을 설명합니다.

PlanogramMatchingResultApiModel

평면도 일치 작업의 결과입니다.

Name	형식	Description
matchingResultPerPosition	PositionMatchingResultApiModel[]	각 평면도 위치에 대해 검색된 검색된 개체 정보입니다.

PositionApiModel

플라노그램의 제품 위치를 설명합니다.

Name	형식	Description
fixtureId	string	제품이 있는 설비의 ID입니다.
id	string	위치의 ID입니다.
productId	string	제품의 ID입니다.
x	number	원점의 왼쪽 오프셋(인치 또는 센티미터 단위)입니다.
y	number	원점의 위쪽 오프셋(인치 또는 센티미터 단위)입니다.

PositionMatchingResultApiModel

제품 이해 결과에서 플라노그램 위치 ID와 해당 감지 개체를 페어링합니다.

Name	형식	Description
detectedObject	DetectedObject	이미지에서 감지된 개체를 설명합니다.
positionId	string	해당 감지된 개체와 일치하는 플래노그램의 위치 ID입니다.

ProductApiModel

플래노그램으로 제품을 설명합니다.

Name	형식	Description
h	number	고정 장치의 높이.
id	string	제품의 ID입니다.
name	string	제품의 이름입니다.
w	number	제품의 너비입니다.

ProductRecognitionResultApiModel

Product Understanding 작업의 결과입니다.

Name	형식	Description
gaps	DetectedObject[]	이미지에서 감지된 빈 공간(간격)입니다.
imageMetadata	ImageMetadataApiModel	높이 및 너비와 같은 이미지 메타데이터 정보입니다.
products	DetectedObject[]	이미지에서 감지된 제품입니다.

Tag

신뢰도 점수와 함께 이미지의 엔터티 관찰입니다.

Name	형식	Description
confidence	number	엔터티가 관찰된 신뢰도 수준입니다.
name	string	엔터티의 이름입니다.

다음을 통해 공유

Planogram Compliance - Match

URI 매개 변수

요청 본문

응답

예제

PlanogramCompliance_Match

샘플 요청

샘플 응답

정의

BoundingBox

DetectedObject

ErrorResponse

ErrorResponseDetails

ErrorResponseInnerError

FixtureApiModel

ImageMetadataApiModel

PlanogramApiModel

PlanogramMatchingRequestApiModel

PlanogramMatchingResultApiModel

PositionApiModel

PositionMatchingResultApiModel

ProductApiModel

ProductRecognitionResultApiModel

Tag

추가 리소스