ARC eye 개요

Prev Next

Classic/VPC 환경에서 이용 가능합니다.

ARC eye는 AR∙로봇∙스마트빌딩 등 다양한 분야에서 활용할 수 있는 측위 및 오브젝트 추적을 지원하는 네이버 클라우드 플랫폼의 디지털 트윈 환경 구축 서비스입니다. ARC eye 서비스에서는 공간 측위(VL, Visual Localization) 및 오브젝트 추적(VOT, Visual Object Tracking)을 수행하는 API를 RESTful 형태로 제공합니다.

ARC eye 공통 설정

ARC eye API에서 공통으로 사용하는 요청 형식과 응답 형식을 설명합니다.

요청

공통 요청 형식을 설명합니다.

API URL

요청 API URL은 다음과 같습니다.

API API URL 확인 방법
VL 네이버 클라우드 플랫폼 콘솔의 ARC eye > Visual Localization > API 메뉴에서 [API 연동 키 확인] 버튼 클릭 시 표시되는 Invoke URL API 연동 키 생성 및 Invoke URL 확인
VOT 네이버 클라우드 플랫폼 콘솔의 ARC eye > Visual Object Tracking > API 메뉴에서 [API 연동 키 확인] 버튼 클릭 시 표시되는 Invoke URL API 연동 키 생성 및 Invoke URL 확인

요청 헤더

요청 헤더에 대한 설명은 다음과 같습니다.

필드 필수 여부 설명
X-ARCEYE-SECRET Required ARC eye 서비스에서 발급받은 Secret Key
  • VL : 네이버 클라우드 플랫폼 콘솔의 ARC eye > Visual Localization > API 메뉴에서 [API 연동 키 확인] 버튼 클릭 후 Secret Key의 [생성] 버튼 클릭
  • VOT: 네이버 클라우드 플랫폼 콘솔의 ARC eye > Visual Object Tracking > API 메뉴에서 [API 연동 키 확인] 버튼 클릭 후 Secret Key의 [생성] 버튼 클릭
Content-Type Required 요청 데이터의 형식
  • multipart/form-data

응답

공통 응답 형식을 설명합니다.

응답 바디

호출이 성공한 경우의 응답 바디는 각 API 명세에서 확인해 주십시오. 호출이 실패한 경우의 응답 바디는 다음과 같습니다.

필드 타입 필수 여부 설명
code String - 오류 코드
message String - 오류 메시지
path String - 오류 발생 경로
product String - 오류 서비스 이름
traceId String - 오류 트레이스 ID
timestamp Long - 오류 발생 일시(밀리초)
  • Unix Timestamp 형식
status Number - 응답 상태 코드
details String - 오류 메시지 상세 설명
errors String - 오류 데이터 셋 정보
  • Visual Localization 전용
errors.datasetInfo String - 스캔 시 구분한 각 계층의 이름들을 하나로 이어붙인 값
errors.datasetInfoScore String - 로케이션 구분 정확도
  • 0에 가까울수록 신뢰도가 낮고, 1에 가까울수록 신뢰도가 높음

응답 상태 코드

응답 상태 코드에 대한 설명은 다음과 같습니다.

Visual Localization
Visual Localization 관련 응답 상태 코드는 다음과 같습니다.

HTTP 상태 코드 코드 메시지 설명
400 0100 there is no location location 파라미터가 인입되지 않음
400 0100 failed to parse wifi scan file 입력된 WiFi 스캔 데이터에 문제가 있음
40x 0100 Invalid Parameter 잘못된 요청 파라미터
401 0020 Unauthorized 유효하지 않은 인증 정보
403 0030 Forbidden 접근 권한 없는 요청
404 0001 Not Found 존재하지 않는 리소스
404 0100 failed to get location info from qdrant: xxx Qdrant DB에서 location 정보를 얻을 수 없음
404 0100 failed to get wifi-finder model file from S3 가공된 WiFi Finder 모델이 없음
404 0100 wifi-loc model does not exists 가공된 WiFi Loc 모델이 없음
409 0101 Duplicate 중복된 요청 또는 리소스
422 0100 failed, it has low dataset info score 대상 로케이션에 유효한 WiFi 신호가 없는 경우
422 0100 failed to get location info from qdrant: xxx 낮은 DatasetInfoScore로 인해 로케이션 구분이 어려움
500 1000 No matching AP list exists mac-address가 일치하는 WiFi 신호가 없음
500 1000 failed to load qdrant Qdrant vector DB와 통신 안 됨
500 1000 failed to get global position filefrom qdrant Qdrant에서 global position 정보를 얻을 수 없음
500 1000 out of service, due to there is no valid xxx 리소스가 없어 내부 서버 통신 간 오류 발생
50x 1000 Internal API Error 서버 내부 오류
500 1001 Processing Error 요청 처리 중 오류 발생
500 9999 Unknown Error 알 수 없는 서버 오류

Visual Object Tracking
Visual Object Tracking 관련 응답 상태 코드는 다음과 같습니다.

HTTP 상태 코드 코드 메시지 설명
404 0001 Not Found 존재하지 않는 리소스
401 0020 Unauthorized 유효하지 않은 인증 정보
403 0030 Forbidden 접근 권한 없는 요청
40x 0100 Invalid Parameter 잘못된 요청 파라미터
409 0101 Duplicate 중복된 요청 또는 리소스
50x 1000 Internal API Error 서버 내부 오류
500 1001 Processing Error 요청 처리 중 오류 발생
500 9999 Unknown Error 알 수 없는 서버 오류

응답 예시

호출이 성공한 경우의 응답 예시는 각 API 명세에서 확인해 주십시오. 호출이 실패한 경우의 응답 예시는 다음과 같습니다.

  • VL API, VOT API 호출 실패

    {
  "code": "9999",
  "message": "Unknown server error.",
  "path": "/api/v1",
  "product": "ARC eye",
  "traceId": "9c1f55ac7d8341d792a922b2590c045f",
  "timestamp": 1570776853475,
  "status": "500"
}

  • VL(WiFi Localization) API 호출 실패

    {
  "traceId": "3d77c10b1a0646659b6c897a35a5fa64",
  "path": "/vl/v1/300568/9bb1a2b6f8031e355dfdb8e5205a1f7a860b167a0fcbd35681235f35c3629634/location",
  "timestamp": 1725449250446,
  "product": "ARC eye",
  "status": 422,
  "code": "0100",
  "message": "Invalid parameters.",
  "details": "there are no valid signals",
  "errors": { // optional
    "datasetInfo": "Naver_1784_1F",
    "datasetInfoScore": 0.6852494
  }
}

ARC eye API

ARC eye 서비스에서 제공하는 API에 대한 설명은 다음과 같습니다.

API 설명
Visual Localization 측위 정보 조회
Visual Object Tracking 오브젝트 포즈 추정 결과 조회

ARC eye 연관 리소스

ARC eye API에 대한 사용자의 이해를 돕기 위해 다양한 연관 리소스를 제공하고 있습니다.