지도 렌더링의 GeoJSON 유형
지도 렌더링 결과의 도형과 래스터 타일의 coveringGeometry는 GeoJSON 객체입니다. 최상위에는 일곱 가지 도형뿐 아니라 Feature와 FeatureCollection도 사용할 수 있습니다.
좌표와 경계
Coordinate는 숫자이며 Position은 숫자 배열입니다. 최소 두 값이 필요하고 첫 두 값은 경도, 위도 순서입니다. 좌표는 WGS 84 기준의 십진수 도 단위입니다. 선택적인 세 번째 값은 WGS 84 기준 타원체 위나 아래의 높이를 미터로 나타냅니다.
높이가 없으면 높이나 깊이에 민감한 애플리케이션은 해당 위치를 현지 지표면 또는 해수면으로 해석하는 것이 권장됩니다. 세 개를 넘는 좌표값은 의미가 정해져 있지 않아 확장을 권장하지 않습니다. 네 번째 측정값이나 타임스탬프를 넣어도 파서가 이를 해석하지 못하거나 무시할 수 있습니다.
선택적인 bbox는 도형 차원이 n일 때 길이가 2*n인 숫자 배열입니다. 가장 남서쪽 지점의 모든 축 값 다음에 가장 북동쪽 지점의 모든 축 값을 놓습니다. 축 순서는 도형 좌표와 같습니다. 공간 조건에서 사용하는 경계 상자의 두 점과 이 배열의 모서리 순서를 구분합니다.
다음은 가상 위치의 점입니다.
{"type":"Point","coordinates":[127.0,37.5]}
도형 분기
type으로 도형을 선택합니다. 렌더링 응답 계약에서 아래의 coordinates, geometries와 bbox는 선택 필드입니다. 배열이 있으면 해당 좌표 구조와 최소 위치 수 조건을 따릅니다.
type | 필드와 배열 구조 |
|---|---|
Point | coordinates: list<Coordinate>가 위치 하나를 나타냄 |
MultiPoint | coordinates: list<Position> |
LineString | coordinates: list<Position>이며 두 개 이상의 위치 |
MultiLineString | coordinates: list<LineStringCoordinates>이며 각 항목이 두 개 이상의 위치 배열 |
Polygon | coordinates: list<LinearRing> |
MultiPolygon | coordinates가 다각형 목록이며 각 다각형은 list<LinearRing> |
GeometryCollection | geometries: list<Geometry> |
각 분기는 선택적인 bbox: list<Coordinate>도 가집니다. Geometry는 위 일곱 도형의 합집합 유형이므로 GeometryCollection을 재귀적으로 포함할 수 있지만 Feature나 FeatureCollection은 포함하지 않습니다.
단일 도형이나 같은 유형의 MultiPoint, MultiLineString 또는 MultiPolygon으로 표현할 수 있으면 불필요한 GeometryCollection을 피하는 것이 권장됩니다.
LinearRing
LinearRing은 네 개 이상의 위치로 구성된 닫힌 LineString입니다. 처음과 마지막 위치의 값은 같아야 하며 표현도 같게 하는 것이 권장됩니다. 표면과 구멍의 경계에는 오른손 규칙을 적용하여 외곽은 반시계 방향, 구멍은 시계 방향으로 배치합니다.
다음은 가상 영역의 경계입니다.
{
"type":"Polygon",
"coordinates":[
[[127.0,37.0],[128.0,37.0],[128.0,38.0],[127.0,38.0],[127.0,37.0]]
]
}
Feature
type: "Feature"인 객체입니다. 나머지 필드는 선택입니다.
| 필드 | 자료형과 조건 |
|---|---|
geometry | 위 일곱 도형 중 하나인 Geometry |
properties | 문자열 키인 FeaturePropertyKey와 any 값을 갖는 맵이며 JSON 객체 또는 JSON null |
id | 스키마의 자료형은 any이며 식별자로 사용하는 값은 JSON 문자열 또는 숫자 |
bbox | list<Coordinate> |
널리 사용하는 객체 식별자가 있으면 id에 포함하는 것이 권장됩니다. properties는 객체에 붙일 속성이며, 렌더링 응답의 별도 sourcings 목록과 동일한 구조로 해석하지 않습니다.
FeatureCollection
type: "FeatureCollection"인 객체입니다. 선택적인 features는 FeatureCollectionTypes 배열이며 허용되는 항목 분기는 Feature 하나입니다. 선택적인 bbox는 위에서 설명한 경계 배열입니다. FeatureCollection의 features에 일반 Geometry를 직접 넣는 구조와 구분합니다.