장치 데이터 조회

장치 데이터 상세 페이지

  • 장치 데이터 상세 페이지는 장치가 받은 모든 데이터 필드를 보여줍니다.
  • 각 데이터 필드는 시간 정보와 함께 최근 값이 표시됩니다.
  • 데이터 필드를 클릭하면 데이터 종류에 따라 각 데이터 이력 페이지로 이동합니다.
장치 데이터 상세 페이지
  • 파일 데이터 필드는 종류에 따라 다르게 표시됩니다. 이미지는 작은 미리보기, 동영상은 썸네일(없을 경우 아이콘), 그 밖의 파일은 아이콘과 함께 파일 이름이 보입니다.
  • 오브젝트 안에 데이터 필드가 존재하는 경우, 오브젝트를 클릭하면 내부 데이터 필드 목록을 보여줍니다.
오브젝트 타입 데이터

데이터 종류

  • 데이터 종류에는 숫자, 문자열, 이미지, 동영상, 파일 타입이 존재하며 각 타입에 맞는 페이지로 자동 연결됩니다.
타입연결 페이지저장된 데이터 예제
숫자차트(Chart) 페이지10, 34.56, -30.3
문자열리스트(List) 페이지"DEVICE_OFF", "EEAA003134566"
이미지갤러리(Gallery) 페이지이미지 파일 URL
/api/files/iotown/data/..../70B3D5DF1001FFFF/20260116/....jpg
동영상동영상(Video) 페이지동영상 파일 URL
/api/files/iotown/data/..../camera-001/20261027/....mp4
파일파일(File) 페이지그 밖의 파일 URL
/api/files/iotown/data/..../camera-001/20261027/....pdf
  • 이미지, 동영상, 파일은 파일 이름의 확장자로 구분합니다.
    • 이미지: jpg, jpeg, png, gif, webp, svg, bmp, ico, avif, heic
    • 동영상: mp4, m4v, webm, mov, ogv
    • 파일: 위에 해당하지 않는 모든 파일 (pdf, csv, zip 등)
  • 장치가 파일을 보내는 방법은 REST API 파일 첨부를 참고하세요.

숫자 타입

  • 숫자 타입의 데이터를 클릭하면 싱글 차트로 이동합니다.
  • 싱글 차트 페이지에서 우측 상단 비교하기버튼을 누르면 1개 이상의 필드 값(다른 장치 포함)과 비교할 수 있는 다중 차트로 연결됩니다.

싱글 차트

  • 데이터의 집계 방법과 시간 간격, 그리고 검색 기간 범위를 설정할 수 있습니다.
  • NONE을 제외한 모든 집계 방법은 집계 시간 간격을 기준으로 계산됩니다.
  • 왼쪽 하단에 Y축 범위를 직접 설정할 수 있습니다.
숫자 데이터 라인 차트
집계 방법설명
NONE집계 없이 모든 데이터를 표시합니다.
AVG집계 구간별 평균값을 표시합니다.
SUM집계 구간별 값들의 합을 표시합니다.
COUNT집계 구간별 값들의 갯수를 표시합니다.
MIN집계 구간별 가장 작은 값을 표시합니다.
MAX집계 구간별 가장 큰 값을 표시합니다.

NONE 방식일 때, 기간 범위내 데이터는 최대 2만개까지만 표시됩니다. 2만개를 초과한 경우, 기간 범위를 줄이거나, AVG를 활용합니다.


  • 차트 위에서 마우스 스크롤을 하면 차트 구간이 확대/축소가 됩니다.
  • 차트 하단에 미니맵을 통해 표시 구간을 이동할 수 있습니다.
차트 확대/축소 스크롤

  • 차트의 종류는 Line, Area, Bar, Scatter를 지원합니다.
Area 차트
Bar 차트
Scatter 차트

다중 차트

  • 다중 차트에서는 다른 필드 값과 비교할 수 있습니다. (동일 장치 및 다른 장치 포함)
  • 다중 차트에서는 Bar타입을 지원하지 않습니다.
다중 차트
다중 차트 데이터 추가
  • 기존 차트에 추가할 경우 왼쪽 Y축, 오른쪽 Y축을 선택할 수 있습니다.
  • 기존 차트 하단에 새롭게 차트를 추가할 수 있습니다.
추가 차트 생성

문자열 타입

  • 문자열 데이터의 경우 리스트 형태로 표시됩니다.
문자열 데이터 페이지

이미지 타입

  • 이미지 데이터의 경우 갤러리 형태로 표시됩니다.
이미지 데이터 페이지

  • 이미지를 클릭하면 이미지 뷰어가 열립니다.
이미지 뷰어

동영상 타입

  • 동영상 데이터는 플레이어와 동영상 목록으로 표시됩니다.
  • 처음에는 가장 최근 영상이 플레이어에 열리고, 목록에서 다른 영상을 누르면 그 영상으로 바뀝니다.
  • 재생 중 원하는 지점으로 바로 이동할 수 있고, 전체 화면으로도 볼 수 있습니다.
  • 버튼은 영상을 새 탭에서 열고, 버튼은 영상 파일을 내려받습니다.
  • 장치가 영상과 함께 썸네일을 보내면 동영상 목록과 재생 전의 플레이어에 썸네일이 표시됩니다.
  • mp4·m4v·mov 영상은 플레이어와 동영상 목록에 재생 길이, 해상도, 코덱이 함께 표시됩니다. H.265 영상에는 일부 브라우저에서 재생되지 않을 수 있다는 표시가 붙습니다.
동영상 데이터 페이지

  • PC에서는 플레이어와 목록이 나란히 표시되고, 영상이 많으면 목록만 따로 스크롤됩니다. 모바일에서는 플레이어가 화면 위쪽에 고정되고 그 아래 목록이 스크롤됩니다.

브라우저가 재생할 수 없는 형식(예: 일부 브라우저의 H.265 영상)은 플레이어 대신 안내 문구와 다운로드 버튼이 표시됩니다. 대부분의 브라우저에서 재생되는 H.264 MP4 형식을 권장합니다.


파일 타입

  • 이미지, 동영상이 아닌 파일(PDF, CSV, ZIP 등)은 파일 목록으로 표시됩니다.
  • 각 파일의 이름, 받은 시각, 확장자가 보이며, 버튼으로 새 탭에서 열거나 버튼으로 내려받을 수 있습니다.
파일 데이터 페이지

장치 데이터 내보내기

  • 우측 상단에 버튼을 누르면 장치 데이터를 CSV 형식으로 저장할 수 있습니다.
  • 장치 데이터 상세 페이지에서 데이터 내보내기를 할 경우, 필요한 값들을 선택할 수 있습니다.
  • 각 데이터 필드 페이지(차트, 리스트, 갤러리)에서 버튼을 누르면 해당 필드 데이터만 다운로드 됩니다.
  • 이미지의 경우, 전체 이미지 파일들을 압축하여 다운로드 합니다.
  • 동영상과 파일은 각 페이지 목록에서 버튼으로 하나씩 내려받습니다.
  • 로컬 시간으로 변환을 체크하면 CSV내 시간 정보가 한국시간으로, 체크 해제하면 UTC형태로 저장됩니다.
장치 데이터 상세 페이지에서 내보내기