st_makepoint Fonction

S’applique à : Databricks Runtime 18.2 et versions ultérieures

Retourne une valeur de point GEOMETRY avec les coordonnées données. La fonction prend 2, 3 ou 4 DOUBLE valeurs, représentant les coordonnées (x, y, y, z) ou (x, y, z, m) du point.

Syntax

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

Arguments

• x: valeur DOUBLE représentant la première coordonnée du point.
• y: valeur DOUBLE représentant la deuxième coordonnée du point.
• z: valeur facultative DOUBLE représentant la troisième coordonnée (Z) du point.
• m: valeur facultative DOUBLE représentant la quatrième coordonnée (M) du point.

Returns

Valeur de type GEOMETRY, représentant un point avec les coordonnées spécifiées.

La valeur SRID de la géométrie retournée est toujours 0.

Le nombre de coordonnées d’entrée détermine la dimension du point retourné : 2D si vous fournissez uniquement x et y, 3DZ si vous fournissez zégalement , ou 4D si vous fournissez les quatre coordonnées (x, , yzet ).m

La fonction retourne NULL si l’une des entrées est NULL.

Exemples

-- 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

Fonctions associées

• Fonction st_makeline
• Fonction st_makepolygon
• Fonction st_point