Categorias:: Funções geospaciais, Funções de conversão

ST_GEOGRAPHYFROMWKT¶

Analisa uma entrada de WKT (texto bem-conhecido) ou EWKT (texto bem-conhecido estendido) e retorna um valor do tipo GEOGRAPHY.

Aliases:: ST_GEOGFROMWKT , ST_GEOGRAPHYFROMEWKT , ST_GEOGFROMEWKT , ST_GEOGRAPHYFROMTEXT , ST_GEOGFROMTEXT
Consulte também:: TO_GEOGRAPHY

Sintaxe¶

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

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

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

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

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

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

Argumentos¶

Obrigatório:

varchar_expression: O argumento deve ser uma expressão de cadeia de caracteres em WKT ou EWKT que represente um objeto geoespacial válido.

Opcional:

allow_invalid: Se for TRUE, especifica que a função retorna um objeto GEOGRAPHY ou GEOMETRY, mesmo quando a forma de entrada não é válida e não pode ser reparada. Para obter mais informações, consulte Especificação de como as formas geoespaciais inválidas são tratadas.

Retornos¶

A função retorna um valor do tipo GEOGRAPHY.

Notas de uso¶

Emite um erro se a entrada não puder ser analisada como WKT ou EWKT.
Emite um erro se o formato de entrada for EWKT e o SRID não for 4326. Consulte a nota sobre como lidar com EWKT e EWKB.

Para as coordenadas em WKT, EWKT e GeoJSON, a longitude aparece antes da latitude (por exemplo, POINT(lon lat)).

Exemplos¶

O exemplo a seguir retorna o objeto GEOGRAPHY para um objeto geoespacial descrito no formato WKT:

-- Set the output format to WKT
alter session set GEOGRAPHY_OUTPUT_FORMAT='WKT';

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

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

O exemplo a seguir retorna o objeto GEOGRAPHY para um objeto geoespacial com coordenada Z descrito no formato WKT:

-- Set the output format to WKT
alter session set GEOGRAPHY_OUTPUT_FORMAT='WKT';

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

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

O exemplo a seguir retorna o objeto GEOGRAPHY para um objeto geoespacial descrito no formato EWKT:

-- Set the output format to EWKT
alter session set GEOGRAPHY_OUTPUT_FORMAT='EWKT';

select ST_GEOGRAPHYFROMEWKT('SRID=4326;POINT(-122.35 37.55)');

+--------------------------------------------------------+
| ST_GEOGRAPHYFROMEWKT('SRID=4326;POINT(-122.35 37.55)') |
|--------------------------------------------------------|
| SRID=4326;POINT(-122.35 37.55)                         |
+--------------------------------------------------------+