ST_AsText

ST_AsText retorna a representação de texto reconhecido (WKT) de uma geometria ou geografia de entrada. Para geometrias ou geografias 3DZ, 3DM e 4D, ST_AsEWKT acrescenta Z, M ou ZM ao valor de WKT para o tipo de geometria ou geografia.

Sintaxe

ST_AsText(geo)

ST_AsText(geo, precision)

Argumentos

geo

Um valor de tipo de dados GEOMETRY ou GEOGRAPHY ou uma expressão que é avaliada como tipo GEOMETRY ou GEOGRAPHY.

precisão

Um valor de tipo de dados INTEGER. Para geometrias, as coordenadas geo são exibidas usando a precisão especificada de 1 a 20. Se precision não for especificado, o padrão será 15. As coordenadas de geo são exibidas usando a precisão especificada. Se precision não for especificado, o padrão será 15.

Tipo de retorno

VARCHAR

Será retornado null, se geo for nulo.

Nulo será retornado se precision for nulo.

Se o resultado for maior que VARCHAR de 64 KB, um erro será retornado.

Exemplos

O seguinte SQL retorna a representação WKT de uma linestring.

SELECT ST_AsText(ST_GeomFromText('LINESTRING(3.141592653589793 -6.283185307179586,2.718281828459045 -1.414213562373095)', 4326));

st_astext
--------------------------------
LINESTRING(3.14159265358979 -6.28318530717959,2.71828182845905 -1.41421356237309)

O seguinte SQL retorna a representação WKT de uma linestring. As coordenadas das geometrias são exibidas com seis dígitos de precisão.

SELECT ST_AsText(ST_GeomFromText('LINESTRING(3.141592653589793 -6.283185307179586,2.718281828459045 -1.414213562373095)', 4326), 6);

st_astext
----------------------------------------------
 LINESTRING(3.14159 -6.28319,2.71828 -1.41421)

O SQL a seguir retorna a representação de WKT de uma geografia.

SELECT ST_AsText(ST_GeogFromText('LINESTRING(110 40, 2 3, -10 80, -7 9)'));

             st_astext
------------------------------------
 LINESTRING(110 40,2 3,-10 80,-7 9)