미디어 항목의 유형별 메타데이터

MediaItemMetadata.type은 CAD, 문서, 이미지, 스프레드시트, 미분류 항목, 오디오, 3D 모델, 비디오, DICOM과 이메일을 구분합니다. 상세 메타데이터 조회에서 반환합니다. 미디어 집합 자체의 스키마 종류와 개별 항목의 메타데이터 분기를 구분합니다.

크기 필드와 수치 단위

각 상세 메타데이터 분기의 sizeBytes는 기존 32비트 필드로, 2GiB 이상이면 2,147,483,647에서 포화됩니다. 정확한 크기는 필수 sizeBytesLong을 사용합니다. 일반 항목 정보의 같은 이름 필드는 2GiB 이상에서 생략되므로 두 응답의 동작을 혼동하지 않습니다.

이미지 크기는 픽셀, 오디오와 비디오 길이는 초입니다. 비트율은 평균 초당 비트를 올림한 근사값이며, 길이는 최대 소수 둘째 자리까지 올림한 근사값입니다.

분기 `cad`

CAD 항목의 메타데이터입니다.

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	분기를 구분하는 `type` 값입니다. 허용값: `cad`.	`cad`
`format`	`enum`	필수	CAD 항목의 형식입니다. 허용값: `STEP`.
`sizeBytes`	`integer`	필수	사용을 권장하지 않는 기존 필드이며 `sizeBytesLong`을 사용합니다. 항목이 2GiB 이상이면 2,147,483,647에서 포화됩니다.
`sizeBytesLong`	`long`	필수	미디어 항목의 바이트 크기입니다.	`72526847`
`units`	`object`	선택	CAD 파일에 선언된 단위입니다.

`units`의 구조

이름	자료형	필수 여부	의미와 조건	예시 값
`lengthUnit`	`string`	선택	`MILLIMETRE`, `METRE`, `INCH`, `FOOT` 같은 원래 길이 단위 이름입니다. 대소문자를 구분하지 않고 비교하며 알 수 없는 값도 처리할 수 있어야 합니다.

분기 `document`

문서 항목의 메타데이터입니다.

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	분기를 구분하는 `type` 값입니다. 허용값: `document`.	`document`
`format`	`enum`	필수	문서 항목의 형식입니다. 허용값: `PDF`, `DOC`, `DOCX`, `TXT`, `PPTX`, `RTF`.
`pages`	`integer`	선택	문서 페이지 수입니다.
`sizeBytes`	`integer`	필수	사용을 권장하지 않는 기존 필드이며 `sizeBytesLong`을 사용합니다. 항목이 2GiB 이상이면 2,147,483,647에서 포화됩니다.
`sizeBytesLong`	`long`	필수	미디어 항목의 바이트 크기입니다.	`72526847`
`title`	`string`	선택	제공되는 경우 문서 제목입니다.
`author`	`string`	선택	제공되는 경우 문서 작성자입니다.

분기 `imagery`

영상 이미지 항목의 메타데이터입니다.

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	분기를 구분하는 `type` 값입니다. 허용값: `imagery`.	`imagery`
`format`	`enum`	필수	이미지 항목의 형식입니다. 허용값: `BMP`, `TIFF`, `NITF`, `JP2K`, `JPG`, `PNG`, `WEBP`.
`dimensions`	`object`	선택	이미지의 가로 및 세로 크기입니다.
`bands`	`list<BandInfo>`	선택	제공되는 경우 이미지 밴드 정보입니다.
`attributes`	`map<ImageAttributeDomain, map>`	선택	이미지 헤더의 속성을 `map<domain, map<key, value>>` 형태로 담습니다. 기본 도메인이나 도메인이 없는 경우 도메인 키는 빈 문자열 `""`입니다.
`iccProfile`	`string`	선택	제공되는 경우 Base64로 인코딩한 ICC 프로필입니다.
`geo`	`object`	선택	이미지에 내장된 지리 참조 정보입니다.
`pages`	`integer`	선택	이미지에 연결된 페이지 수입니다. 보통 1이지만 여러 페이지 TIFF 같은 형식에서는 더 많을 수 있습니다.
`orientation`	`object`	선택	EXIF에 인코딩된 방향 정보입니다.
`sizeBytes`	`integer`	필수	사용을 권장하지 않는 기존 필드이며 `sizeBytesLong`을 사용합니다. 항목이 2GiB 이상이면 2,147,483,647에서 포화됩니다.
`sizeBytesLong`	`long`	필수	미디어 항목의 바이트 크기입니다.	`72526847`

`dimensions`의 구조

이름	자료형	필수 여부	의미와 조건	예시 값
`width`	`integer`	필수	이미지 너비이며 단위는 픽셀입니다.
`height`	`integer`	필수	이미지 높이이며 단위는 픽셀입니다.

`bands`의 구조

배열 항목은 BandInfo이며 자료형은 object입니다.

이미지의 한 밴드에 관한 정보입니다.

이름	자료형	필수 여부	의미와 조건
`dataType`	`enum`	선택	밴드 자료형입니다. 허용값: `UNDEFINED`, `BYTE`, `UINT16`, `INT16`, `UINT32`, `INT32`, `FLOAT32`, `FLOAT64`, `COMPLEX_INT16`, `COMPLEX_INT32`, `COMPLEX_FLOAT32`, `COMPLEX_FLOAT64`, `UINT64`, `INT64`, `INT8`.
`colorInterpretation`	`enum`	선택	밴드의 색상 해석입니다. 허용값: `UNDEFINED`, `GRAY`, `PALETTE_INDEX`, `RED`, `GREEN`, `BLUE`, `ALPHA`, `HUE`, `SATURATION`, `LIGHTNESS`, `CYAN`, `MAGENTA`, `YELLOW`, `BLACK`, `Y_CB_CR_SPACE_Y`, `Y_CB_CR_SPACE_CB`, `Y_CB_CR_SPACE_CR`.
`paletteInterpretation`	`enum`	선택	밴드의 팔레트 해석입니다. 허용값: `GRAY`, `RGB`, `RGBA`, `CMYK`, `HLS`.
`unitInterpretation`	`object`	선택	밴드의 단위 해석입니다.

`unitInterpretation`의 구조

이름	자료형	필수 여부
`unit`	`string`	선택
`scale`	`double`	선택
`offset`	`double`	선택

`attributes`의 구조

맵의 키는 ImageAttributeDomain(string), 값은 map(map<ImageAttributeKey, string>)입니다.

키: 이미지 속성의 도메인입니다.

맵의 키는 ImageAttributeKey(string), 값은 string(string)입니다.

키: 도메인 안의 이미지 속성 키입니다.

`geo`의 구조

이름	자료형	필수 여부	의미와 조건
`crs`	`object`	선택	지리 참조 이미지의 좌표 참조계(CRS)입니다.
`geotransform`	`object`	선택	지리 참조를 위한 아핀 변환입니다.
`gcpInfo`	`object`	선택	지리 참조에 사용하는 지상 기준점 목록입니다.
`gpsData`	`object`	선택	이미지의 EXIF에서 추출한 GPS 위치 메타데이터입니다.

`crs`의 구조

이름	자료형	필수 여부	의미와 조건	예시 값
`wkt`	`string`	선택	CRS의 Well-Known Text(WKT) 표현입니다.

`geotransform`의 구조

이름	자료형	필수 여부
`xTranslate`	`double`	선택
`xScale`	`double`	선택
`xShear`	`double`	선택
`yTranslate`	`double`	선택
`yShear`	`double`	선택
`yScale`	`double`	선택

`gcpInfo`의 구조

이름	자료형	필수 여부	의미와 조건	예시 값
`gcps`	`list<GroundControlPoint>`	선택

`gcps`의 구조

배열 항목은 GroundControlPoint이며 자료형은 object입니다.

지리 참조에 사용하는 지상 기준점입니다.

이름	자료형	필수 여부	의미와 조건
`pixX`	`double`	선택	픽셀 X 좌표입니다.
`pixY`	`double`	선택	픽셀 Y 좌표입니다.
`projX`	`double`	선택	투영 X 좌표입니다.
`projY`	`double`	선택	투영 Y 좌표입니다.
`projZ`	`double`	선택	투영 Z 좌표입니다.

`gpsData`의 구조

이름	자료형	필수 여부
`latitude`	`double`	선택
`longitude`	`double`	선택
`altitude`	`double`	선택

`orientation`의 구조

이름	자료형	필수 여부	의미와 조건	예시 값
`rotationAngle`	`enum`	선택	EXIF 방향의 회전 각도입니다. 허용값: `DEGREE_90`, `DEGREE_180`, `DEGREE_270`, `UNKNOWN`.
`flipAxis`	`enum`	선택	EXIF 방향의 반전 축입니다. 허용값: `HORIZONTAL`, `VERTICAL`, `UNKNOWN`.

분기 `spreadsheet`

스프레드시트 항목의 메타데이터입니다.

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	분기를 구분하는 `type` 값입니다. 허용값: `spreadsheet`.	`spreadsheet`
`format`	`enum`	필수	스프레드시트 항목의 형식입니다. 허용값: `CSV`, `XLSX`.
`sheetNames`	`list<string>`	선택	스프레드시트의 시트 이름 목록입니다.
`sizeBytes`	`integer`	필수	사용을 권장하지 않는 기존 필드이며 `sizeBytesLong`을 사용합니다. 항목이 2GiB 이상이면 2,147,483,647에서 포화됩니다.
`sizeBytesLong`	`long`	필수	미디어 항목의 바이트 크기입니다.	`72526847`
`title`	`string`	선택	제공되는 경우 스프레드시트 제목입니다.
`author`	`string`	선택	제공되는 경우 스프레드시트 작성자입니다.

분기 `untyped`

인식된 유형이 없는 항목의 메타데이터입니다.

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	분기를 구분하는 `type` 값입니다. 허용값: `untyped`.	`untyped`
`sizeBytes`	`integer`	필수	사용을 권장하지 않는 기존 필드이며 `sizeBytesLong`을 사용합니다. 항목이 2GiB 이상이면 2,147,483,647에서 포화됩니다.
`sizeBytesLong`	`long`	필수	미디어 항목의 바이트 크기입니다.	`72526847`

분기 `audio`

오디오 항목의 메타데이터입니다.

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	분기를 구분하는 `type` 값입니다. 허용값: `audio`.	`audio`
`format`	`enum`	필수	오디오 항목의 형식입니다. 허용값: `FLAC`, `MP2`, `MP3`, `MP4`, `NIST_SPHERE`, `OGG`, `WAV`, `WEBM`.
`specification`	`object`	필수	오디오의 기술적 사양입니다.
`sizeBytes`	`integer`	필수	사용을 권장하지 않는 기존 필드이며 `sizeBytesLong`을 사용합니다. 항목이 2GiB 이상이면 2,147,483,647에서 포화됩니다.
`sizeBytesLong`	`long`	필수	미디어 항목의 바이트 크기입니다.	`72526847`

`specification`의 구조

이름	자료형	필수 여부	의미와 조건
`bitRate`	`integer`	필수	오디오의 근사 평균 비트율이며 초당 비트 단위입니다. 평균이 소수이면 올림합니다.
`durationSeconds`	`double`	필수	오디오의 근사 길이이며 초 단위입니다. 최대 소수 둘째 자리까지 올림하여 표시합니다.
`numberOfChannels`	`integer`	선택	오디오 스트림의 채널 수입니다.

분기 `model3d`

3D 모델 항목의 메타데이터입니다.

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	분기를 구분하는 `type` 값입니다. 허용값: `model3d`.	`model3d`
`format`	`enum`	필수	3D 모델 항목의 형식입니다. 허용값: `LAS`, `PLY`, `OBJ`.
`modelType`	`enum`	필수	3D 모델의 표현 유형입니다. 허용값: `POINT_CLOUD`, `MESH`.
`sizeBytes`	`integer`	필수	사용을 권장하지 않는 기존 필드이며 `sizeBytesLong`을 사용합니다. 항목이 2GiB 이상이면 2,147,483,647에서 포화됩니다.
`sizeBytesLong`	`long`	필수	미디어 항목의 바이트 크기입니다.	`72526847`

분기 `video`

비디오 항목의 메타데이터입니다.

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	분기를 구분하는 `type` 값입니다. 허용값: `video`.	`video`
`format`	`enum`	필수	비디오 항목의 형식입니다. 허용값: `MP4`, `MKV`, `MOV`, `TS`, `WEBM`.
`specification`	`object`	필수	비디오의 기술적 사양입니다.
`sizeBytes`	`integer`	필수	사용을 권장하지 않는 기존 필드이며 `sizeBytesLong`을 사용합니다. 항목이 2GiB 이상이면 2,147,483,647에서 포화됩니다.
`sizeBytesLong`	`long`	필수	미디어 항목의 바이트 크기입니다.	`72526847`

`specification`의 구조

이름	자료형	필수 여부	의미와 조건	예시 값
`bitRate`	`integer`	필수	비디오의 근사 평균 비트율이며 초당 비트 단위입니다. 평균이 소수이면 올림합니다.
`durationSeconds`	`double`	필수	비디오의 근사 길이이며 초 단위입니다. 최대 소수 둘째 자리까지 올림하여 표시합니다.

분기 `dicom`

DICOM 의료 영상 항목의 메타데이터입니다.

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	분기를 구분하는 `type` 값입니다. 허용값: `dicom`.	`dicom`
`metaInformation`	`union<v1>`	필수	DICOM 메타 정보입니다.
`mediaType`	`enum`	필수	DICOM 미디어 유형입니다. 허용값: `IMAGE`, `MULTI_FRAME_IMAGE`, `VIDEO`, `STRUCTURED_REPORT`.
`commonDataElements`	`object`	필수	공통 DICOM 데이터 요소입니다.
`otherDataElements`	`map<DicomDataElementKey, any>`	선택	미디어 내용과 `commonDataElements`에 포함된 요소를 제외한 DICOM 데이터 요소입니다.
`sizeBytes`	`integer`	필수	사용을 권장하지 않는 기존 필드이며 `sizeBytesLong`을 사용합니다. 항목이 2GiB 이상이면 2,147,483,647에서 포화됩니다.
`sizeBytesLong`	`long`	필수	미디어 항목의 바이트 크기입니다.	`72526847`

`metaInformation`의 구조

분기 `v1`

DICOM 메타 정보 버전 1입니다.

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	분기를 구분하는 `type` 값입니다. 허용값: `v1`.	`v1`
`mediaStorageSop`	`string`	필수	저장한 DICOM 객체 종류를 식별하는 Media Storage SOP Class UID입니다. CT Image, MR Image 등이 해당합니다.
`mediaStorageSopInstance`	`string`	필수	Media Storage SOP Instance UID입니다.
`transferSyntax`	`string`	필수	압축 방식과 바이트 순서 등 DICOM 인코딩 방식을 식별하는 Transfer Syntax UID입니다.

`commonDataElements`의 구조

이름	자료형	필수 여부	의미와 조건
`numberFrames`	`integer`	선택	DICOM 파일의 프레임 수입니다.
`modality`	`enum`	선택	DICOM 모달리티 코드입니다. 코드의 의미는 DICOM 규격을 따릅니다. DICOM 모달리티 값을 사용합니다.
`patientId`	`string`	선택	환자 ID입니다.
`studyId`	`string`	선택	검사(study) ID입니다.
`studyUid`	`string`	선택	검사 UID입니다.
`seriesUid`	`string`	선택	시리즈 UID입니다.
`studyTime`	`string (date-time)`	선택	검사 시각입니다.
`seriesTime`	`string (date-time)`	선택	시리즈 시각입니다.

`otherDataElements`의 구조

맵의 키는 DicomDataElementKey(string), 값은 any(any)입니다.

키: DICOM 데이터 요소의 키입니다.

분기 `email`

이메일 항목의 메타데이터입니다.

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	분기를 구분하는 `type` 값입니다. 허용값: `email`.	`email`
`format`	`enum`	필수	이메일 항목의 형식입니다. 허용값: `EML`.
`sizeBytes`	`integer`	필수	사용을 권장하지 않는 기존 필드이며 `sizeBytesLong`을 사용합니다. 항목이 2GiB 이상이면 2,147,483,647에서 포화됩니다.
`sizeBytesLong`	`long`	필수	미디어 항목의 바이트 크기입니다.	`72526847`
`sender`	`list<Mailbox>`	선택	이메일 발신자 목록입니다.
`date`	`string (date-time)`	필수	이메일을 보낸 시각입니다.
`attachmentCount`	`integer`	필수	이메일 첨부 수입니다.
`to`	`list<MailboxOrGroup>`	선택	이메일 수신자 목록입니다.
`cc`	`list<MailboxOrGroup>`	선택	이메일 참조 수신자 목록입니다.
`subject`	`string`	선택	이메일 제목입니다.
`attachments`	`list<EmailAttachment>`	선택	이메일 첨부 목록입니다.

`sender`의 구조

배열 항목은 Mailbox이며 자료형은 object입니다.

이메일 주소와 선택적인 표시 이름을 담은 메일함입니다.

이름	자료형	필수 여부	의미와 조건	예시 값
`displayName`	`string`	선택	메일함 표시 이름입니다.
`emailAddress`	`string`	필수	메일함의 이메일 주소입니다.

`to`의 구조

배열 항목은 MailboxOrGroup이며 자료형은 union<mailbox, group>입니다.

개별 메일함 또는 메일함 그룹입니다.

분기 `mailbox`

MailboxOrGroup에서 개별 메일함을 담는 래퍼입니다.

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	분기를 구분하는 `type` 값입니다. 허용값: `mailbox`.	`mailbox`
`mailbox`	`object`	필수	이메일 주소와 선택적인 표시 이름을 담은 메일함입니다.

`mailbox`의 구조

이름	자료형	필수 여부	의미와 조건	예시 값
`displayName`	`string`	선택	메일함 표시 이름입니다.
`emailAddress`	`string`	필수	메일함의 이메일 주소입니다.

분기 `group`

MailboxOrGroup에서 메일함 그룹을 담는 래퍼입니다.

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	분기를 구분하는 `type` 값입니다. 허용값: `group`.	`group`
`group`	`object`	필수	이름이 있는 메일함 그룹입니다.

`group`의 구조

이름	자료형	필수 여부	의미와 조건	예시 값
`groupName`	`string`	필수	그룹 이름입니다.
`mailboxes`	`list<Mailbox>`	선택	그룹에 속한 메일함 목록입니다.

`mailboxes`의 구조

배열 항목은 Mailbox이며 자료형은 object입니다.

이메일 주소와 선택적인 표시 이름을 담은 메일함입니다.

이름	자료형	필수 여부	의미와 조건	예시 값
`displayName`	`string`	선택	메일함 표시 이름입니다.
`emailAddress`	`string`	필수	메일함의 이메일 주소입니다.

`cc`의 구조

배열 항목은 MailboxOrGroup이며 자료형은 union<mailbox, group>입니다.

개별 메일함 또는 메일함 그룹입니다.

분기 `mailbox`

MailboxOrGroup에서 개별 메일함을 담는 래퍼입니다.

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	분기를 구분하는 `type` 값입니다. 허용값: `mailbox`.	`mailbox`
`mailbox`	`object`	필수	이메일 주소와 선택적인 표시 이름을 담은 메일함입니다.

`mailbox`의 구조

이름	자료형	필수 여부	의미와 조건	예시 값
`displayName`	`string`	선택	메일함 표시 이름입니다.
`emailAddress`	`string`	필수	메일함의 이메일 주소입니다.

분기 `group`

MailboxOrGroup에서 메일함 그룹을 담는 래퍼입니다.

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	분기를 구분하는 `type` 값입니다. 허용값: `group`.	`group`
`group`	`object`	필수	이름이 있는 메일함 그룹입니다.

`group`의 구조

이름	자료형	필수 여부	의미와 조건	예시 값
`groupName`	`string`	필수	그룹 이름입니다.
`mailboxes`	`list<Mailbox>`	선택	그룹에 속한 메일함 목록입니다.

`mailboxes`의 구조

배열 항목은 Mailbox이며 자료형은 object입니다.

이메일 주소와 선택적인 표시 이름을 담은 메일함입니다.

이름	자료형	필수 여부	의미와 조건	예시 값
`displayName`	`string`	선택	메일함 표시 이름입니다.
`emailAddress`	`string`	필수	메일함의 이메일 주소입니다.

`attachments`의 구조

배열 항목은 EmailAttachment이며 자료형은 object입니다.

이메일 첨부의 메타데이터입니다.

이름	자료형	필수 여부	의미와 조건
`attachmentIndex`	`integer`	필수	이메일 안에서 첨부를 식별하는 인덱스입니다.
`fileName`	`string`	선택	제공되는 경우 첨부 파일 이름입니다.
`mimeType`	`string`	필수	검증된 첨부 MIME 유형입니다.

이미지와 좌표 정보

이미지 속성은 도메인별 맵이며 기본 도메인의 키는 빈 문자열입니다. ICC 프로필은 Base64 문자열입니다. 지리 참조 정보에는 CRS의 WKT, 아핀 변환, 지상 기준점과 EXIF GPS 정보가 각각 선택적으로 들어갑니다.

CAD 길이 단위는 원래 이름을 반환합니다. 대소문자를 구분하지 않고 해석하되 알 수 없는 단위 문자열을 임의의 기본 단위로 바꾸지 않습니다.

DICOM 모달리티 값

다음은 commonDataElements.modality가 허용하는 값입니다. 이름과 의미의 대응은 DICOM 규격을 따릅니다.

AR
ASMT
AU
BDUS
BI
BMD
CR
CT
CTPROTOCOL
DG
DOC
DX
ECG
EPS
ES
FID
GM
HC
HD
IO
IOL
IVOCT
IVUS
KER
KO
LEN
LS
MG
MR
M3D
NM
OAM
OCT
OP
OPM
OPT
OPTBSV
OPTENF
OPV
OSS
OT
PLAN
PR
PT
PX
REG
RESP
RF
RG
RTDOSE
RTIMAGE
RTINTENT
RTPLAN
RTRAD
RTRECORD
RTSEGANN
RTSTRUCT
RWV
SEG
SM
SMR
SR
SRF
STAIN
TEXTUREMAP
TG
US
VA
XA
XC
AS
CD
CF
CP
CS
DD
DF
DM
DS
EC
FA
FS
LP
MA
MS
OPR
ST
VF

이미지 예시

가상 PNG 항목의 메타데이터입니다.

{
  "type": "imagery",
  "format": "PNG",
  "dimensions": {
    "width": 1920,
    "height": 1080
  },
  "sizeBytes": 2048576,
  "sizeBytesLong": "2048576"
}

Keyboard shortcuts

팔란티어 플랫폼 한국어 해설