st_makepoint Función

Se aplica a:check marcado yes Databricks Runtime 18.2 y versiones posteriores

Important

Esta característica está en versión preliminar pública.

Devuelve un valor de punto GEOMETRY con las coordenadas especificadas. La función toma 2, 3 o 4 DOUBLE valores, que representan las coordenadas (x, y), (x, y, z) o (x, y, z, m) del punto.

Syntax

st_makepoint ( x, y [, z [, m ] ] )

Arguments

  • x: valor DOUBLE que representa la primera coordenada del punto.
  • y: valor DOUBLE que representa la segunda coordenada del punto.
  • z: valor opcional DOUBLE , que representa la tercera coordenada (Z) del punto.
  • m: valor opcional DOUBLE , que representa la cuarta coordenada (M) del punto.

Devoluciones

Valor de tipo GEOMETRY, que representa un punto con las coordenadas especificadas.

El valor SRID de la geometría devuelta siempre 0es .

El número de coordenadas de entrada determina la dimensión del punto devuelto: 2D si proporciona solo x y y, 3DZ si también proporciona z, o 4D si proporciona las cuatro coordenadas (x, y, zy m).

La función devuelve NULL si alguna de las entradas es NULL.

Examples

-- Creates a 2D point with coordinates (10, 34).
> SELECT st_astext(st_makepoint(10.0, 34.0));
  POINT(10 34)
-- Creates a 3DZ point with coordinates (1, 2, 3).
> SELECT st_astext(st_makepoint(1.0, 2.0, 3.0));
  POINT Z (1 2 3)
-- Creates a 4D point with coordinates (1, 2, 3, 4).
> SELECT st_astext(st_makepoint(1.0, 2.0, 3.0, 4.0));
  POINT ZM (1 2 3 4)

-- The SRID of the returned geometry is always 0.
> SELECT st_srid(st_makepoint(10.0, 34.0));
  0
-- The type of the returned geometry is always geometry(0).
> SELECT typeof(st_makepoint(10.0, 34.0));
  geometry(0)

-- The function returns NULL if any of the inputs is NULL.
> SELECT st_astext(st_makepoint(10.0, NULL));
  NULL