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

ST_GEOMETRYFROMWKT¶

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

Aliases:

ST_GEOMFROMWKT , ST_GEOMETRYFROMEWKT , ST_GEOMFROMEWKT , ST_GEOMETRYFROMTEXT , ST_GEOMFROMTEXT

Consulte também:: TO_GEOMETRY

Sintaxe¶

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

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

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

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

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

ST_GEOMFROMTEXT( <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 GEOMETRY.

Notas de uso¶

Emite um erro se a entrada não puder ser analisada como WKT ou EWKT.
Para uma entrada de WKT, o SRID do objeto GEOMETRY resultante é definido como 0.

Para alterar o SRID de um objeto GEOMETRY, passe o objeto GEOMETRY para ST_SETSRID especificando o SRID que você deseja definir. ST_SETSRID retorna o objeto GEOMETRY que tem o SRID especificado.

Exemplos¶

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

-- Set the output format to EWKT
ALTER SESSION SET GEOMETRY_OUTPUT_FORMAT='EWKT';

SELECT ST_GEOMETRYFROMEWKT('SRID=32633;POINT(389866.35 5819003.03)');

Copy

+---------------------------------------------------------------+
| ST_GEOMETRYFROMEWKT('SRID=32633;POINT(389866.35 5819003.03)') |
|---------------------------------------------------------------|
| SRID=32633;POINT(389866.35 5819003.03)                        |
+---------------------------------------------------------------+

Copy

No próximo exemplo, a entrada está no formato WKT, que não especifica o SRID:

-- Set the output format to WKT
ALTER SESSION SET GEOMETRY_OUTPUT_FORMAT='EWKT';

SELECT ST_GEOMETRYFROMWKT('POINT(389866.35 5819003.03)');

Copy

+----------------------------------------------------+
| ST_GEOMETRYFROMWKT('POINT(389866.35 5819003.03)')  |
|----------------------------------------------------|
| SRID=0;POINT(389866.35 5819003.03)                 |
+----------------------------------------------------+

Copy