TO_GEOGRAPHY¶

구문¶

다음 중 하나를 사용하십시오.

TO_GEOGRAPHY( <varchar_expression> [ , <allow_invalid> ] )

TO_GEOGRAPHY( <binary_expression> [ , <allow_invalid> ] )

TO_GEOGRAPHY( <variant_expression> [ , <allow_invalid> ] )

TO_GEOGRAPHY( <geometry_expression> [ , <allow_invalid> ] )

인자¶

필수:

varchar_expression

인자는 다음 형식 중 하나로 유효한 기하학적 오브젝트를 나타내는 문자열 식이어야 합니다.

• WKT(well-known text).

• 16진수 형식의 WKB(well-known binary)(선행 0x 제외).

• EWKT(extended well-known text).

• 16진수 형식의 EWKB(extended well-known binary)(선행 0x 제외).

• GeoJSON.

binary_expression

인자는 WKB 또는 EWKB 형식의 이진 식이어야 합니다.

variant_expression

인자는 GeoJSON 형식의 OBJECT여야 합니다.

geometry_expression

인자는 SRID가 4326인 GEOMETRY 형식의 식이어야 합니다.

선택 사항:

allow_invalid

TRUE인 경우 입력 형태가 유효하지 않고 복구할 수 없는 경우에도 함수가 GEOGRAPHY 또는 GEOMETRY 오브젝트를 반환하도록 지정합니다. 자세한 내용은 유효하지 않은 지리 공간 도형을 처리하는 방법 지정하기 섹션을 참조하세요.

반환¶

함수는 GEOGRAPHY 형식의 값을 반환합니다.

사용법 노트¶

• 지원되는 형식(WKT, WKB, EWKT, EWKB, GeoJSON) 중 하나로 입력을 구문 분석할 수 없는 경우, 오류가 발생합니다.

• 입력 형식이 EWKT 또는 EWKB이고 SRID가 4326이 아닌 경우, 오류가 발생합니다. EWKT 및 EWKB 처리에 관한 참고 사항 을 참조하십시오.

• WKT 또는 EWKT 입력에서 GEOGRAPHY 오브젝트를 구성하려면 ST_GEOGRAPHYFROMWKT 를 사용할 수도 있습니다.

• WKB 또는 EWKB 입력에서 GEOGRAPHY 오브젝트를 구성하려면 ST_GEOGRAPHYFROMWKB 를 사용할 수도 있습니다.

• WKT, EWKT, GeoJSON 의 좌표의 경우 경도가 위도 앞에 표시됩니다(예: POINT(lon lat)).

예¶

이는 VARCHAR 데이터가 있는 TO_GEOGRAPHY 함수의 간단한 사용법을 보여줍니다.

select TO_GEOGRAPHY('POINT(-122.35 37.55)');

Copy

+--------------------------------------+
| TO_GEOGRAPHY('POINT(-122.35 37.55)') |
|--------------------------------------|
| POINT(-122.35 37.55)                 |
+--------------------------------------+

다음 예는 WKT 형식으로 설명된 Z축을 가진 지리 공간 오브젝트에 대한 GEOGRAPHY 오브젝트를 반환합니다.

select TO_GEOGRAPHY('POINTZ(-122.35 37.55 30)');

Copy

+------------------------------------------+
| TO_GEOGRAPHY('POINTZ(-122.35 37.55 30)') |
|------------------------------------------|
| POINTZ(-122.35 37.55 30)                 |
+------------------------------------------+