사물 검출 샘플예제

사물 검출 추가

  • 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

Example

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

Example

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 사이의 값)