ST_GeomFromText - Amazon Redshift
SintaxisArgumentosTipo de devoluciónEjemplos

Amazon Redshift dejará de admitir la creación de nuevas UDF de Python a partir del 1 de noviembre de 2025. Si desea utilizar las UDF de Python, créelas antes de esa fecha. Las UDF de Python existentes seguirán funcionando con normalidad. Para obtener más información, consulte la publicación del blog.

ST_GeomFromText

ST_GeomFromText construye un objeto geométrico a partir de la representación de texto conocida (WKT) de una geometría de datos de entrada.

ST_GeomFromText acepta 3DZ, 3DM y 4D donde el tipo de geometría tiene el prefijo Z, M o ZM, respectivamente.

Sintaxis

ST_GeomFromText(wkt_string)
ST_GeomFromText(wkt_string, srid)

Argumentos

wkt_string

Un valor de tipo de datos VARCHAR que es una representación WKT de una geometría.

Puede usar la palabra clave de WKT EMPTY para designar un punto vacío, un multipunto con un punto vacío o una colección de geometría con un punto vacío. En el siguiente ejemplo, se crea un multipunto con un punto vacío y un punto no vacío. 

ST_GeomFromEWKT('MULTIPOINT(1 0,EMPTY)');
srid

Un valor de tipo de datos INTEGER que es un identificador de referencia espacial (SRID). Si se proporciona un valor SRID, la geometría devuelta tiene este valor SRID. De lo contrario, el valor SRID de la geometría devuelta se establece en cero (0).

Tipo de devolución

GEOMETRY

Si wkt_string o srid son null, entonces se devuelve el valor null.

Si srid es negativo, se devuelve null.

Si wkt_string no es válido, se devuelve un error.

Si srid no es válido, se devuelve un error.

Ejemplos

El siguiente SQL construye un objeto geométrico a partir de la representación WKT y el valor SRID. 

SELECT ST_GeomFromText('POLYGON((0 0,0 1,1 1,1 0,0 0))',4326);

st_geomfromtext
--------------------------------
0103000020E61000000100000005000000000000000000000000000000000000000000000000000000000000000000F03F000000000000F03F000000000000F03F000000000000F03F000000000000000000000000000000000000000000000000