Constructor functions in Lindorm spatial-temporal functions - - Centro de documentación de Alibaba Cloud

Utilice las funciones constructoras para construir objetos geométricos a partir de coordenadas o cadenas Well-Known Text (WKT). Estas funciones forman parte de Lindorm GanosBase y solo se aplican al motor LindormTable.

Motores y versiones

Las funciones constructoras solo se aplican a LindormTable.
Se requiere LindormTable 2.6.5 o posterior.
Se requiere Lindorm SQL 2.6.8 o posterior.

Para obtener instrucciones sobre cómo comprobar o actualizar su versión, consulte las Notas de la versión de LindormTable y el tema Actualizar la versión secundaria del motor de una instancia de Lindorm. Para conocer cómo consultar la versión de Lindorm SQL, consulte SQL versions.

Funciones

Función	Descripción
ST_GeomFromText	Convierte una cadena WKT en un objeto geométrico.
ST_LineFromMultiPoint	Convierte un objeto MultiPoint en un LineString.
ST_MakePoint	Construye un Point a partir de coordenadas de longitud y latitud.

ST_GeomFromText

Convierte una cadena WKT en un objeto geométrico. Utilice esta función cuando los datos de entrada ya estén en formato WKT. Si necesita construir un Point directamente desde coordenadas numéricas, use ST_MakePoint, ya que es más sencilla y no requiere analizar sintácticamente la cadena.

Sintaxis

geometry ST_GeomFromText(string wkt)

Parámetros

Parámetro	Tipo	Descripción
`wkt`	STRING	Cadena WKT que representa un objeto geométrico.

Valores devueltos

Un objeto geometry correspondiente a la cadena WKT de entrada.

Notas de uso:

Tipos de geometría compatibles: Point, LineString, Polygon, MultiPoint, MultiLineString, MultiPolygon y GeometryCollection.
No se admiten cadenas WKT que incluyan información del sistema de referencia espacial (SRS). Si su geometría tiene un identificador de referencia espacial (SRID), almacénelo en una columna independiente. El SRID se utiliza únicamente como identificador. El SRID predeterminado es 4326.
Los objetos EMPTY son compatibles con cualquier tipo de geometría (por ejemplo, 'POLYGON EMPTY').

Ejemplos

Ejemplo 1: Point

SELECT ST_GeomFromText('POINT(1 1)') AS geom;

Resultado:

+-------------+
|    geom     |
+-------------+
| POINT (1 1) |
+-------------+

Ejemplo 2: Polygon

SELECT ST_GeomFromText('POLYGON (( 1 1, 1 2, 2 2, 2 1, 1 1))') AS poly;

Resultado:

+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|                                                                                                poly                                                                                                |
+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| 0020000003000010E600000001000000053FF00000000000003FF00000000000003FF000000000000040000000000000004000000000000000400000000000000040000000000000003FF00000000000003FF00000000000003FF0000000000000 |
+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+

Ejemplo 3: Geometría EMPTY

SELECT ST_GeomFromText('POLYGON EMPTY') AS geom;

Resultado:

+---------------+
|     geom      |
+---------------+
| POLYGON EMPTY |
+---------------+

ST_LineFromMultiPoint

Convierte un objeto MultiPoint en un LineString. Esta función recibe un MultiPoint como entrada, no valores Point individuales. Por lo tanto, utilice ST_Collect para combinar los objetos Point en un MultiPoint antes de llamarla.

Sintaxis

geometry ST_LineFromMultiPoint(geometry aMultiPoint)

Parámetros

Parámetro	Tipo	Descripción
`aMultiPoint`	GEOMETRY (MultiPoint)	Objeto MultiPoint. Utilice `ST_Collect` para construir un MultiPoint a partir de objetos Point individuales.

Valores devueltos

Un objeto geometry del subtipo LineString.

Ejemplo

SELECT ST_AsText(
  ST_LineFromMultiPoint(
    ST_Collect(
      ST_MakePoint(1, 2),
      ST_MakePoint(3, 4),
      ST_MakePoint(5, 6)
    )
  )
) AS astext;

Resultado:

+-------------------------+
|         astext          |
+-------------------------+
| LINESTRING(1 2,3 4,5 6) |
+-------------------------+

ST_MakePoint

Construye una geometría Point a partir de coordenadas de longitud (x) y latitud (y). Utilice esta función cuando los datos de entrada sean valores de coordenadas numéricos. Solo admite puntos 2D y no permite configurar un sistema de referencia espacial.

Sintaxis

geometry ST_MakePoint(double x, double y)

Esta función solo admite puntos 2D. No es compatible con puntos 3D ni con la configuración de un sistema de referencia espacial.

Parámetros

Parámetro	Tipo	Descripción
`x`	DOUBLE	Valor de longitud. Los valores INTEGER y LONG se convierten automáticamente a DOUBLE.
`y`	DOUBLE	Valor de latitud. Los valores INTEGER y LONG se convierten automáticamente a DOUBLE.

Valores devueltos

Un objeto geometry del subtipo Point.

Ejemplo

SELECT ST_AsText(ST_MakePoint(1, 2)) AS text;

Resultado:

+-------------+
|    text     |
+-------------+
| POINT (1 2) |
+-------------+