RenderObjectsResponse의 renderables에는 지리적 콘텐츠와 스타일이, sourcings에는 그 콘텐츠의 데이터 출처가 들어 있습니다. 두 목록은 선택 필드입니다. Renderable.invocation은 요청의 호출 ID와 연결되며 Renderable.sourcing은 출처 ID를 가리킵니다.
클라이언트는 불투명한 ID를 그대로 보관하고 비교합니다. 기본 generic 심볼 유형은 항상 렌더링하도록 구현하는 것이 권장됩니다. 그 ID로 일반 심볼 PNG 를 가져오며 SDF 심볼 ID를 일반 심볼과 같은 유형으로 취급하지 않습니다.
GeoJSON은 경도와 위도 순서의 WGS 84 좌표를 사용합니다. 래스터 타일은 EPSG:3857이며 루트 타일 하나가 전 세계를 덮습니다. 응답의 URL 템플릿을 사용하여 타일 주소를 구성합니다. 타일을 덮는 coveringGeometry도 GeoJSON 입니다.
색상의 alpha와 스타일의 opacity는 0부터 255까지입니다. 크기와 선 너비 및 타일 표시 해상도는 고해상도 화면을 고려한 가상 픽셀 값입니다. 일반 심볼 다운로드 API의 별도 정수 size와 구분하여 각 클라이언트의 화면 배율을 적용합니다.
선과 채우기의 기존 color는 전체 스타일을 설명하지 못하므로 pattern과 opacity를 우선 사용합니다. 응답에서 color는 여전히 필수 필드입니다. 단색뿐 아니라 SDF 또는 일반 심볼 패턴도 처리합니다.
이름 자료형 필수 여부 의미와 조건 예시 값
renderableslist<Renderable>선택 sourcingslist<Sourcing>선택
배열 항목은 Renderable이며 자료형은 object입니다.
호출 하나에서 Foundry 객체의 속성, 즉 데이터 출처를 표현하는 RenderableContent 모음입니다.
이름 자료형 필수 여부 의미와 조건 예시 값
idstring필수 세션 안에서 전체적으로 고유한 렌더링 요소 ID입니다. 내부 구조를 해석하지 않는 불투명 식별자입니다. invocationstring필수 특정 렌더 함수 호출을 식별하기 위해 클라이언트가 제공하는 값이며 세션 안에서 고유해야 합니다. sourcingstring필수 세션 안에서 전체적으로 고유한 데이터 출처 ID입니다. 내부 구조를 해석하지 않는 불투명 식별자입니다. contentmap<RenderablePartId, RenderableContent>선택
맵의 키는 RenderablePartId(string), 값은 RenderableContent(union<geometry, rasterTilesWebMercator>)입니다.
키: 한 렌더링 요소 안에서 부분을 식별하는 고유 값입니다.
지도에 그릴 지리적 도형과 대응하는 스타일입니다.
GeoJSON 도형으로 표현하는 렌더링 콘텐츠입니다.
이름 자료형 필수 여부 의미와 조건 예시 값
typeenum필수 허용값: geometry. geometrygeometryGeoJSON필수 GeoJSON 객체입니다. 좌표는 WGS 84 기준의 지리 좌표계이며 경도와 위도는 십진수 도 단위입니다. 선택적인 세 번째 값은 WGS 84 기준 타원체 위나 아래의 높이를 미터로 나타냅니다. 높이가 없으면 높이나 깊이에 민감한 애플리케이션은 해당 위치를 현지 지표면 또는 해수면으로 해석하는 것이 권장됩니다. styleobject필수 GeoJSON 도형의 스타일입니다.
전체 필드와 재귀적인 도형 구조는 GeoJSON 유형 을 따릅니다.
이름 자료형 필수 여부 의미와 조건 예시 값
symbolStyleobject선택 렌더링 콘텐츠에 표시할 심볼입니다. strokeStyleobject선택 렌더링 요소의 구성 부분에 적용할 색상입니다. fillStyleobject선택 렌더링 요소의 구성 부분에 적용할 채우기입니다. labelStyleobject선택 렌더링 콘텐츠에 표시할 텍스트입니다.
이름 자료형 필수 여부 의미와 조건 예시 값
symbolunion<solid, sdf, generic>필수 심볼 로드 API에서 심볼을 가져오는 데 필요한 정보입니다. sizedouble필수 고해상도 화면을 고려한 가상 픽셀 크기입니다. 브라우저에서는 CSS 픽셀과 devicePixelRatio를 고려하여 해석합니다. opacityinteger필수 0부터 255까지의 알파 값입니다.
RGB 색상을 지정하는 분기입니다.
이름 자료형 필수 여부 의미와 조건 예시 값
typeenum필수 허용값: solid. solidrgbstring필수 #RRGGBB 형식의 16진수 RGB 색상입니다.
이름 자료형 필수 여부 의미와 조건 예시 값
typeenum필수 허용값: sdf. sdfidstring필수 SDF를 PNG로 가져오는 데 사용할 고유 심볼 ID입니다. colorobject필수 렌더링 요소의 구성 부분에 적용할 색상입니다.
이름 자료형 필수 여부 의미와 조건 예시 값
rgbstring필수 #RRGGBB 형식의 16진수 RGB 색상입니다.alphainteger필수 0부터 255까지의 알파 값입니다.
기본 일반 심볼입니다. 클라이언트가 이 심볼 유형을 항상 렌더링하도록 구현하는 것이 권장됩니다.
이름 자료형 필수 여부 의미와 조건 예시 값
typeenum필수 허용값: generic. genericidstring필수 일반 심볼을 PNG로 가져오는 데 사용할 고유 ID입니다. 내부 구조를 해석하지 않는 불투명 식별자입니다. temp
이름 자료형 필수 여부 의미와 조건 예시 값
colorobject필수 전체 스타일을 나타내지 못하므로 사용을 권장하지 않는 기존 필드입니다. 가능하면 pattern과 opacity를 사용합니다. widthdouble필수 고해상도 화면을 고려한 가상 픽셀 크기입니다. 브라우저에서는 CSS 픽셀과 devicePixelRatio를 고려하여 해석합니다. patternunion<solid, sdf, generic>필수 심볼 로드 API에서 심볼을 가져오는 데 필요한 정보입니다. opacityinteger필수 0부터 255까지의 알파 값입니다.
이름 자료형 필수 여부 의미와 조건 예시 값
rgbstring필수 #RRGGBB 형식의 16진수 RGB 색상입니다.alphainteger필수 0부터 255까지의 알파 값입니다.
RGB 색상을 지정하는 분기입니다.
이름 자료형 필수 여부 의미와 조건 예시 값
typeenum필수 허용값: solid. solidrgbstring필수 #RRGGBB 형식의 16진수 RGB 색상입니다.
이름 자료형 필수 여부 의미와 조건 예시 값
typeenum필수 허용값: sdf. sdfidstring필수 SDF를 PNG로 가져오는 데 사용할 고유 심볼 ID입니다. colorobject필수 렌더링 요소의 구성 부분에 적용할 색상입니다.
이름 자료형 필수 여부 의미와 조건 예시 값
rgbstring필수 #RRGGBB 형식의 16진수 RGB 색상입니다.alphainteger필수 0부터 255까지의 알파 값입니다.
기본 일반 심볼입니다. 클라이언트가 이 심볼 유형을 항상 렌더링하도록 구현하는 것이 권장됩니다.
이름 자료형 필수 여부 의미와 조건 예시 값
typeenum필수 허용값: generic. genericidstring필수 일반 심볼을 PNG로 가져오는 데 사용할 고유 ID입니다. 내부 구조를 해석하지 않는 불투명 식별자입니다. temp
이름 자료형 필수 여부 의미와 조건 예시 값
colorobject필수 전체 스타일을 나타내지 못하므로 사용을 권장하지 않는 기존 필드입니다. 가능하면 pattern과 opacity를 사용합니다. patternunion<solid, sdf, generic>필수 심볼 로드 API에서 심볼을 가져오는 데 필요한 정보입니다. opacityinteger필수 0부터 255까지의 알파 값입니다.
이름 자료형 필수 여부 의미와 조건 예시 값
rgbstring필수 #RRGGBB 형식의 16진수 RGB 색상입니다.alphainteger필수 0부터 255까지의 알파 값입니다.
RGB 색상을 지정하는 분기입니다.
이름 자료형 필수 여부 의미와 조건 예시 값
typeenum필수 허용값: solid. solidrgbstring필수 #RRGGBB 형식의 16진수 RGB 색상입니다.
이름 자료형 필수 여부 의미와 조건 예시 값
typeenum필수 허용값: sdf. sdfidstring필수 SDF를 PNG로 가져오는 데 사용할 고유 심볼 ID입니다. colorobject필수 렌더링 요소의 구성 부분에 적용할 색상입니다.
이름 자료형 필수 여부 의미와 조건 예시 값
rgbstring필수 #RRGGBB 형식의 16진수 RGB 색상입니다.alphainteger필수 0부터 255까지의 알파 값입니다.
기본 일반 심볼입니다. 클라이언트가 이 심볼 유형을 항상 렌더링하도록 구현하는 것이 권장됩니다.
이름 자료형 필수 여부 의미와 조건 예시 값
typeenum필수 허용값: generic. genericidstring필수 일반 심볼을 PNG로 가져오는 데 사용할 고유 ID입니다. 내부 구조를 해석하지 않는 불투명 식별자입니다. temp
이름 자료형 필수 여부 의미와 조건 예시 값
colorobject필수 렌더링 요소의 구성 부분에 적용할 색상입니다. textstring필수 sizedouble필수 고해상도 화면을 고려한 가상 픽셀 크기입니다. 브라우저에서는 CSS 픽셀과 devicePixelRatio를 고려하여 해석합니다.
이름 자료형 필수 여부 의미와 조건 예시 값
rgbstring필수 #RRGGBB 형식의 16진수 RGB 색상입니다.alphainteger필수 0부터 255까지의 알파 값입니다.
Web Mercator(EPSG:3857)의 래스터 타일입니다. 루트 타일 (z=0, x=0, y=0)이 전 세계를 덮습니다. 제공한 URL 템플릿으로 개별 타일의 주소를 구성합니다.
이름 자료형 필수 여부 의미와 조건 예시 값
typeenum필수 허용값: rasterTilesWebMercator. rasterTilesWebMercatorurlstring필수 tileDisplayResolutiondouble필수 고해상도 화면을 고려한 가상 픽셀 크기입니다. 브라우저에서는 CSS 픽셀과 devicePixelRatio를 고려하여 해석합니다. coveringGeometryGeoJSON필수 GeoJSON 객체입니다. 좌표는 WGS 84 기준의 지리 좌표계이며 경도와 위도는 십진수 도 단위입니다. 선택적인 세 번째 값은 WGS 84 기준 타원체 위나 아래의 높이를 미터로 나타냅니다. 높이가 없으면 높이나 깊이에 민감한 애플리케이션은 해당 위치를 현지 지표면 또는 해수면으로 해석하는 것이 권장됩니다. styleobject필수 래스터 타일의 스타일입니다.
전체 필드와 재귀적인 도형 구조는 GeoJSON 유형 을 따릅니다.
이름 자료형 필수 여부 의미와 조건 예시 값
opacityinteger필수 0부터 255까지의 알파 값입니다.
배열 항목은 Sourcing이며 자료형은 object입니다.
렌더링 요소를 만들 때 사용한 개별 데이터 단위의 참조입니다.
이름 자료형 필수 여부 의미와 조건 예시 값
idstring필수 세션 안에서 전체적으로 고유한 데이터 출처 ID입니다. 내부 구조를 해석하지 않는 불투명 식별자입니다. contentunion<object, objectV2>필수 데이터 출처와 메타데이터를 찾는 정보입니다. titlestring필수
고유한 Foundry 객체를 식별하는 정보입니다.
이름 자료형 필수 여부 의미와 조건 예시 값
typeenum필수 허용값: object. objectobjectTypestring필수 Foundry 객체 유형의 고유 식별자입니다. primaryKeymap<FoundryObjectPropertyTypeRid, FoundryObjectPropertyValueUntyped>선택
맵의 키는 FoundryObjectPropertyTypeRid(string), 값은 FoundryObjectPropertyValueUntyped(any)입니다.
키: Foundry 객체 속성의 고유 식별자입니다.
객체 속성의 값입니다. 원래 속성의 유형 정보는 보존하지 않습니다.
이름 자료형 필수 여부 의미와 조건 예시 값
typeenum필수 허용값: objectV2. objectV2objectTypestring필수 Foundry 객체 유형의 고유 식별자입니다. objectRidstring필수 객체의 고유 식별자입니다.