KML 문자열을 도형 목록으로 해석

항목	값
화면 이름	Parse KML string as geometry list
식별자	`parseKmlAsGeometryListV1`
지원 실행 방식	Batch, Streaming
범주	지리공간 (Geospatial)
반환 자료형	`Array<Geometry> \| Struct<ok:Array<Struct<ok:Geometry, error:String>>, error:String>`

KML 문자열을 GeoJSON 목록으로 해석하며 모든 KML 속성을 무시합니다.

입력 인자

이름	지정 여부	자료형	의미와 조건
`KML string to parse`	필수	`Expression<String>`	도형으로 해석할 유효한 KML 문자열입니다.
`Output mode`	선택	`Enum<Simple, With errors>`	오류를 null로 반환할지, 도형 목록의 `ok` 또는 설명형 메시지의 `error` 필드를 가진 결과 유형으로 반환할지 선택합니다. 목록 내부의 각 도형에도 같은 모드를 적용합니다.
`Prepare geometry after parse`	선택	`Literal<Boolean>`	KML을 Foundry 도형 규칙에 맞게 준비할지 지정합니다. 인덱싱 실패를 예방하기 위해 보통 준비하는 것이 권장되며, 범위 밖 좌표 같은 잘못된 도형은 null로 바꿉니다.

입출력 예시

예시 1: 기본 동작

인자 값:

KML string to parse: col
Output mode: simple
Prepare geometry after parse: true

col	출력
<?xml version="1.0" encoding="utf-8"?> <kml xmlns="http://www.opengis.net/kml/2.2"> <Do...	[ {"coordinates":[[-122.43193945401, 37.801983684521], [-122.431564131101, 37.8020327731402], [-122.43... ]

예시 2: 기본 동작

인자 값:

KML string to parse: col
Output mode: simple
Prepare geometry after parse: false

col	출력
<?xml version="1.0" encoding="utf-8"?> <kml xmlns="http://www.opengis.net/kml/2.2"> <Do...	[ {"coordinates":[[-122.43193945401, 37.801983684521], [-122.431564131101, 37.8020327731402], [-122.43... ]

예시 3: 기본 동작

인자 값:

KML string to parse: col
Output mode: with_errors
Prepare geometry after parse: true

col	출력
<?xml version="1.0" encoding="utf-8"?> <kml xmlns="http://www.opengis.net/kml/2.2"> <Do...	{ error: null, ok: [ { error: null, ok: {"ty...

예시 4: 기본 동작

인자 값:

KML string to parse: col
Output mode: with_errors
Prepare geometry after parse: false

col	출력
<?xml version="1.0" encoding="utf-8"?> <kml xmlns="http://www.opengis.net/kml/2.2"> <Do...	{ error: null, ok: [ { error: null, ok: {"ty...

예시 5: 기본 동작

인자 값:

KML string to parse: col
Output mode: simple
Prepare geometry after parse: false

col	출력
randomKmlFileString	null

예시 6: 기본 동작

인자 값:

KML string to parse: col
Output mode: with_errors
Prepare geometry after parse: false

col	출력
randomKmlFileString	{ error: Failed to parse String. Error: Unexpected character 'r' (code 114) in prolog; expected '<' at [row,col {unknown-source}]: [1,1], ok: null, }

예시 7: null 처리

인자 값:

KML string to parse: col
Output mode: simple
Prepare geometry after parse: false

col	출력
null	null

예시 8: null 처리

인자 값:

KML string to parse: col
Output mode: with_errors
Prepare geometry after parse: false

col	출력
null	{ error: Null input: KML, ok: null, }

긴 구조값 안의 줄임표는 생략한 내용을 나타냅니다.