Categorias:: Funções geoespaciais, 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> ] )

Copy

Argumentos¶

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 TRUE, especifica que a função deve retornar um objeto GEOGRAPHY ou GEOMETRY, mesmo quando a forma de entrada for inválida e não puder ser reparada. Para obter mais detalhes, consulte Specifying How Invalid Geospatial Shapes Are Handled.

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';

Copy

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

Copy

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';

Copy

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)                         |
+--------------------------------------------------------+

Copy