사물 검출 샘플예제

사물 검출 추가

  • 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)

NameTypeMandatoryExampleDescription
codeNumberY응답 상태 코드
messageStringY응답 상태 설명
dataobjectY데이터 정보
space_image_uuidStringY범용 고유 식별자(UUID)
image_pathStringY이미지 경로
created_dateDateY사물 검출 데이터 생성 시간
resultsOjbectY사물 검출 결과
labelStringN검출 결과 레이블
scoreNumberN검출 결과 신뢰도 점수 (0 ~ 1)
xminNumberN사물영역 박스의 좌상단 x좌표(이미지의 가로 크기에 비례하는 0 ~ 1 사이의 값)
yminNumberN사물영역 박스의 좌상단 y좌표(이미지의 세로 크기에 비례하는 0 ~ 1 사이의 값)
xmaxNumberN사물영역 박스의 우하단 x좌표(이미지의 가로 크기에 비례하는 0 ~ 1 사이의 값)
ymaxNumberN사물영역 박스의 우하단 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)

NameTypeMandatoryExampleDescription
codeNumberY응답 상태 코드
messageStringY응답 상태 설명
dataObjectY데이터 정보
space_image_uuidStringY범용 고유 식별자(UUID)
image_pathStringY이미지 경로
created_dateDateY사물 검출 데이터 생성 시간
resultsObjectY사물 검출 결과
labelStringN검출 결과 레이블
scoreNumberN검출 결과 신뢰도 점수 (0 ~ 1)
xminNumberN사물영역 박스의 좌상단 x좌표(이미지의 가로 크기에 비례하는 0 ~ 1 사이의 값)
yminNumberN사물영역 박스의 좌상단 y좌표(이미지의 세로 크기에 비례하는 0 ~ 1 사이의 값)
xmaxNumberN사물영역 박스의 우하단 x좌표(이미지의 가로 크기에 비례하는 0 ~ 1 사이의 값)
ymaxNumberN사물영역 박스의 우하단 y좌표(이미지의 세로 크기에 비례하는 0 ~ 1 사이의 값)