사물 검출 샘플예제

사물 검출 추가

REQUEST (CURL / GET)

curl --request GET \
     --url https://apis.openapi.sk.com/urbanbase/v1/space/detector \
     --header 'Accept: application/json' \
     --header 'Content-Type: application/json' \
     --header 'appKey: My Project의 Project Key'

REQUEST (CURL / POST)

curl --request POST \
     --url https://apis.openapi.sk.com/urbanbase/v1/space/detector \
     --header 'Accept: application/json' \
     --header 'Content-Type: application/json' \
     --header 'appKey: My Project의 Project Key'

REQUEST (SAMPLE CODE)

POST /space/detector
  
headers: {
    "Content-Type": "application/json",
    “appkey”: “{appkey}”   
}

body: {
    "image_path": "https://upload.wikimedia.org/wikipedia/commons/thumb/c/cf/Wohnzimmer_2007.jpg/220px-Wohnzimmer_2007.jpg"
}

RESPONSE (200 / JSON)

{
  "code": "00000",
  "message": "success",
  "data": {
    "space_image_uuid": "69198a90-4c72-4f66-9f43-011c285ea8c9",
    "image_path": "https://upload.wikimedia.org/wikipedia/commons/thumb/c/cf/Wohnzimmer_2007.jpg/220px-Wohnzimmer_2007.jpg",
    "created_date": "2021-01-11T00:52:53.511Z",
    "results": [
      {
        "label": "table lamp",
        "score": 0.9970793724060059,
        "xmin": 0.871875,
        "ymin": 0.41458333333333336,
        "xmax": 0.9984375,
        "ymax": 0.6895833333333333
      },
      {
         "label": "sofa",
         "score": 0.9124197363853455,
         "xmin": 0.0015625,
         "ymin": 0.6333333333333333,
         "xmax": 0.2203125,
         "ymax": 0.9979166666666667
      },
      {
        "label": "table lamp",
        "score": 0.8586978912353516,
        "xmin": 0,
        "ymin": 0.33541666666666664,
        "xmax": 0.1609375,
        "ymax": 0.6458333333333334
      },
      {
        "label": "door",
        "score": 0.8427220582962036,
        "xmin": 0.0890625,
        "ymin": 0.15625,
        "xmax": 0.26875,
        "ymax": 0.71875
      },
      {
        "label": "rug",
        "score": 0.8178510665893555,
        "xmin": 0.21875,
        "ymin": 0.7270833333333333,
        "xmax": 0.6921875,
        "ymax": 0.9979166666666667
      },
      {
        "label": "bookshelf",
        "score": 0.7992725372314453,
        "xmin": 0.3265625,
        "ymin": 0.14166666666666666,
        "xmax": 0.7359375,
        "ymax": 0.7375
      },
      {
        "label": "chair",
        "score": 0.7977943420410156,
        "xmin": 0.6828125,
        "ymin": 0.6333333333333333,
        "xmax": 0.875,
        "ymax": 0.99375
      },
      {
        "label": "dishware",
        "score": 0.7125219702720642,
        "xmin": 0.8671875,
        "ymin": 0.69375,
        "xmax": 1,
        "ymax": 0.8
      },
      {
        "label": "book",
        "score": 0.6793968677520752,
        "xmin": 0.425,
        "ymin": 0.35208333333333336,
        "xmax": 0.5234375,
        "ymax": 0.4270833333333333
      }
    ]
  }
}

RESPONSE (400/ JSON)

{
  "code": "12001",
  "message": "Invalid image_path"
}

RESPONSE (PARAMETERS)

Name	Type	Mandatory	Description
code	Number	Y	응답 상태 코드
message	String	Y	응답 상태 설명
data	object	Y	데이터 정보
space_image_uuid	String	Y	범용 고유 식별자(UUID)
image_path	String	Y	이미지 경로
created_date	Date	Y	사물 검출 데이터 생성 시간
results	Ojbect	Y	사물 검출 결과
label	String	N	검출 결과 레이블
score	Number	N	검출 결과 신뢰도 점수 (0 ~ 1)
xmin	Number	N	사물영역 박스의 좌상단 x좌표(이미지의 가로 크기에 비례하는 0 ~ 1 사이의 값)
ymin	Number	N	사물영역 박스의 좌상단 y좌표(이미지의 세로 크기에 비례하는 0 ~ 1 사이의 값)
xmax	Number	N	사물영역 박스의 우하단 x좌표(이미지의 가로 크기에 비례하는 0 ~ 1 사이의 값)
ymax	Number	N	사물영역 박스의 우하단 y좌표(이미지의 세로 크기에 비례하는 0 ~ 1 사이의 값)

사물 검출 조회

REQUEST (CURL / GET)

curl --request GET \
     --url https://apis.openapi.sk.com/urbanbase/v1/space/detector/space_image_uuid \
     --header 'Accept: application/json' \
     --header 'appKey: My Project의 Project Key'

REQUEST (CURL / POST)

curl --request POST \
     --url https://apis.openapi.sk.com/urbanbase/v1/space/detector/space_image_uuid \
     --header 'Accept: application/json' \
     --header 'appKey: My Project의 Project Key'

REQUEST (SAMPLE CODE)

GET /space/detector/69198a90-4c72-4f66-9f43-011c285ea8c9

headers: {
    "Content-Type": "application/json",
    “appkey”: “{appkey}”   
}

RESPONSE (200 / JSON)

{
  "code": "00000",
  "message": "success",
  "data": {
    "space_image_uuid": "69198a90-4c72-4f66-9f43-011c285ea8c9",
    "image_path": "https://upload.wikimedia.org/wikipedia/commons/thumb/c/cf/Wohnzimmer_2007.jpg/220px-Wohnzimmer_2007.jpg",
    "created_date": "2021-01-11T00:52:53.511Z",
    "results": [
      {
        "label": "table lamp",
        "score": 0.9970793724060059,
        "xmin": 0.871875,
        "ymin": 0.41458333333333336,
        "xmax": 0.9984375,
        "ymax": 0.6895833333333333
      },
      {
         "label": "sofa",
         "score": 0.9124197363853455,
         "xmin": 0.0015625,
         "ymin": 0.6333333333333333,
         "xmax": 0.2203125,
         "ymax": 0.9979166666666667
      },
      {
        "label": "table lamp",
        "score": 0.8586978912353516,
        "xmin": 0,
        "ymin": 0.33541666666666664,
        "xmax": 0.1609375,
        "ymax": 0.6458333333333334
      },
      {
        "label": "door",
        "score": 0.8427220582962036,
        "xmin": 0.0890625,
        "ymin": 0.15625,
        "xmax": 0.26875,
        "ymax": 0.71875
      },
      {
        "label": "rug",
        "score": 0.8178510665893555,
        "xmin": 0.21875,
        "ymin": 0.7270833333333333,
        "xmax": 0.6921875,
        "ymax": 0.9979166666666667
      },
      {
        "label": "bookshelf",
        "score": 0.7992725372314453,
        "xmin": 0.3265625,
        "ymin": 0.14166666666666666,
        "xmax": 0.7359375,
        "ymax": 0.7375
      },
      {
        "label": "chair",
        "score": 0.7977943420410156,
        "xmin": 0.6828125,
        "ymin": 0.6333333333333333,
        "xmax": 0.875,
        "ymax": 0.99375
      },
      {
        "label": "dishware",
        "score": 0.7125219702720642,
        "xmin": 0.8671875,
        "ymin": 0.69375,
        "xmax": 1,
        "ymax": 0.8
      },
      {
        "label": "book",
        "score": 0.6793968677520752,
        "xmin": 0.425,
        "ymin": 0.35208333333333336,
        "xmax": 0.5234375,
        "ymax": 0.4270833333333333
      }
    ]
  }
}

RESPONSE (400/ JSON)

{
  "code": "40000",
  "message": "Not Found"
}

RESPONSE (PARAMETERS)

Name	Type	Mandatory	Description
code	Number	Y	응답 상태 코드
message	String	Y	응답 상태 설명
data	Object	Y	데이터 정보
space_image_uuid	String	Y	범용 고유 식별자(UUID)
image_path	String	Y	이미지 경로
created_date	Date	Y	사물 검출 데이터 생성 시간
results	Object	Y	사물 검출 결과
label	String	N	검출 결과 레이블
score	Number	N	검출 결과 신뢰도 점수 (0 ~ 1)
xmin	Number	N	사물영역 박스의 좌상단 x좌표(이미지의 가로 크기에 비례하는 0 ~ 1 사이의 값)
ymin	Number	N	사물영역 박스의 좌상단 y좌표(이미지의 세로 크기에 비례하는 0 ~ 1 사이의 값)
xmax	Number	N	사물영역 박스의 우하단 x좌표(이미지의 가로 크기에 비례하는 0 ~ 1 사이의 값)
ymax	Number	N	사물영역 박스의 우하단 y좌표(이미지의 세로 크기에 비례하는 0 ~ 1 사이의 값)