Categorias:

Funções geospaciais, 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> [ , <srid> ] [ , <allow_invalid> ] ) ST_GEOMFROMWKT( <varchar_expression> [ , <srid> ] [ , <allow_invalid> ] ) ST_GEOMETRYFROMEWKT( <varchar_expression> [ , <srid> ] [ , <allow_invalid> ] ) ST_GEOMFROMEWKT( <varchar_expression> [ , <srid> ] [ , <allow_invalid> ] ) ST_GEOMETRYFROMTEXT( <varchar_expression> [ , <srid> ] [ , <allow_invalid> ] ) ST_GEOMFROMTEXT( <varchar_expression> [ , <srid> ] [ , <allow_invalid> ] )
Copy

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:

srid

O valor inteiro do SRID a ser usado.

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

Notas de uso

  • Emite um erro se a entrada não puder ser analisada como WKT ou EWKT.

  • Para a entrada WKT, se o argumento srid não for especificado, o objeto GEOMETRY resultante terá o SRID definido como 0.

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

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

-- Set the output format to EWKT ALTER SESSION SET GEOMETRY_OUTPUT_FORMAT='EWKT'; SELECT ST_GEOMETRYFROMEWKT('SRID=32633;POINTZ(389866.35 5819003.03 30)');
Copy
+-------------------------------------------------------------------+ | ST_GEOMETRYFROMEWKT('SRID=32633;POINTZ(389866.35 5819003.03 30)') | |-------------------------------------------------------------------| | SRID=32633;POINTZ(389866.35 5819003.03 30) | +-------------------------------------------------------------------+

No próximo exemplo, a entrada está no formato WKT e a chamada de função especifica o SRID para usar:

-- Set the output format to EWKT ALTER SESSION SET GEOMETRY_OUTPUT_FORMAT='EWKT'; SELECT ST_GEOMETRYFROMWKT('POINT(389866.35 5819003.03)', 4326);
Copy
+----------------------------------------------------------+ | ST_GEOMETRYFROMWKT('POINT(389866.35 5819003.03)', 4326) | |----------------------------------------------------------| | SRID=4326;POINT(389866.35 5819003.03) | +----------------------------------------------------------+
Linguagem: Português