Funciones del constructor

Utilice las funciones del constructor para obtener representaciones binarias de tipos de datos geométricos point, line o polygon. También puede utilizar estas funciones para convertir datos binarios a texto y obtener valores binarios para los datos geométricos que se expresan como Well-Known Text (WKT).

ST_AsBinary(geometry)

Devuelve un tipo de datos binarios de longitud variable (varbinary) que contiene la representación WKB de la geometría especificada. Ejemplo:

SELECT ST_AsBinary(ST_Point(-158.54, 61.56))

ST_AsText(geometry)

Convierte todos los tipos de datos geométricos especificados en texto. Devuelve un valor en un tipo de datos varchar, que es una representación WKT del tipo de datos geométricos. Ejemplo:

SELECT ST_AsText(ST_Point(-158.54, 61.56))

ST_GeomAsLegacyBinary(geometry)

Devuelve un varbinary heredado de la geometría especificada. Ejemplo:

SELECT ST_GeomAsLegacyBinary(ST_Point(-158.54, 61.56)

ST_GeometryFromText(varchar)

Convierte texto en formato WKT en un tipo de datos geométricos. Devuelve un valor en un tipo de datos geométricos. Ejemplo:

SELECT ST_GeometryFromText(ST_AsText(ST_Point(1, 2)))

ST_GeomFromBinary(varbinary)

Devuelve un objeto de tipo geométrico de una representación WKB. Ejemplo:

SELECT ST_GeomFromBinary(ST_AsBinary(ST_Point(-158.54, 61.56)))

ST_GeomFromLegacyBinary(varbinary)

Devuelve un objeto de tipo geométrico de un tipo de varbinary heredado. Ejemplo:

SELECT ST_GeomFromLegacyBinary(ST_GeomAsLegacyBinary(ST_Point(-158.54, 61.56)))

ST_LineFromText(varchar)

Devuelve un valor en la line del tipo de datos geométricos. Ejemplo:

SELECT ST_Line('linestring(1 1, 2 2, 3 3)')

ST_LineString(array(point))

Devuelve un tipo geométrico LineString formado a partir de una matriz de tipos geométricos de punto. Si hay menos de dos puntos no vacíos en la matriz especificada, se devuelve una LineString vacía. Arroja una excepción si cualquier elemento de la matriz es nulo, está vacío o es el mismo que el anterior. La geometría devuelta puede no ser simple. Según la entrada especificada, la geometría devuelta puede intersecarse a sí misma o contener vértices duplicados. Ejemplo:

SELECT ST_LineString(ARRAY[ST_Point(-158.54, 61.56), ST_Point(-158.55, 61.56)])

ST_MultiPoint(array(point))

Devuelve un objeto geométrico MultiPoint formado a partir de los puntos especificados. Devuelve un valor nulo si la matriz especificada está vacía. Arroja una excepción si cualquier elemento de la matriz es nulo o está vacío. La geometría devuelta puede no ser simple y puede contener puntos duplicados si la matriz especificada tiene duplicados. Ejemplo:

SELECT ST_MultiPoint(ARRAY[ST_Point(-158.54, 61.56), ST_Point(-158.55, 61.56)])

ST_Point(double, double)

Devuelve un objeto point de tipo geométrico. Para los valores de datos de entrada a esta función, utilice valores geométricos, como, por ejemplo, el sistema de coordenadas cartesiano universal transversal de Mercator (UTM) o unidades de mapas geográficos (longitud y latitud) en grados decimales. Los valores de longitud y latitud utilizan el sistema geodésico mundial, también conocido como WGS 1984 o EPSG:4326. WGS 1984 es el sistema de coordenadas utilizado por el Sistema de posicionamiento global (GPS).

Por ejemplo, en la siguiente notación, las coordenadas del mapa se especifican en longitud y latitud, y el valor .072284, que es la distancia del búfer, se especifica en unidades angulares como grados decimales:

SELECT ST_Buffer(ST_Point(-74.006801, 40.705220), .072284)

Sintaxis:

SELECT ST_Point(longitude, latitude) FROM earthquakes LIMIT 1

En el siguiente ejemplo se utilizan coordenadas de longitud y de latitud específicas:

SELECT ST_Point(-158.54, 61.56)
FROM earthquakes
LIMIT 1

En el siguiente ejemplo se utilizan coordenadas de longitud y de latitud específicas:

SELECT ST_Point(-74.006801, 40.705220)

En el siguiente ejemplo se utiliza la función ST_AsText para obtener la geometría de WKT:

SELECT ST_AsText(ST_Point(-74.006801, 40.705220)) AS WKT

ST_Polygon(varchar)

Usando la secuencia de las ordenadas proporcionadas en el sentido de las agujas del reloj, de izquierda a derecha, devuelve un polygon de tipo de datos geométrico. Desde la versión 2 del motor Athena, solo se aceptan polígonos como entradas. Ejemplo:

SELECT ST_Polygon('polygon ((1 1, 1 4, 4 4, 4 1))') 

to_geometry(sphericalGeography)

Devuelve un objeto geométrico del objeto geográfico esférico especificado. Ejemplo:

SELECT to_geometry(to_spherical_geography(ST_Point(-158.54, 61.56)))

to_spherical_geography(geometry)

Devuelve un objeto geográfico esférico de la geometría especificada. Utilice esta función para convertir un objeto geométrico en un objeto geográfico esférico en el campo del radio de la Tierra. Esta función se puede utilizar solo en geometrías POINT, MULTIPOINT, LINESTRING, MULTILINESTRING, POLYGON y MULTIPOLYGON definidas en un espacio 2D o un GEOMETRYCOLLECTION de tales geometrías. Para cada punto de la geometría especificada, la función verifica que point.x esté dentro de [-180.0, 180.0] y point.y dentro de [-90.0, 90.0]. La función utiliza estos puntos como grados de longitud y latitud para construir la forma del resultado sphericalGeography.

Ejemplo:

SELECT to_spherical_geography(ST_Point(-158.54, 61.56))