st_makepoint Função

Aplica-se a: Databricks Runtime 18.2 e superiores

Devolve um valor em pontos GEOMETRY com as coordenadas dadas. A função assume 2, 3 ou 4 DOUBLE valores, representando as coordenadas (x, y), (x, y, z) ou (x, y, z, m) do ponto.

Syntax

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

Arguments

• x: Um DOUBLE valor, que representa a primeira coordenada do ponto.
• y: Um DOUBLE valor, representando a segunda coordenada do ponto.
• z: Um valor opcional DOUBLE , representando a terceira coordenada (Z) do ponto.
• m: Um valor opcional DOUBLE , representando a quarta coordenada (M) do ponto.

Devoluções

Um valor do tipo GEOMETRY, que representa um ponto com as coordenadas especificadas.

O valor SRID da geometria devolvida é sempre 0.

O número de coordenadas de entrada determina a dimensão do ponto devolvido: 2D se fornecer apenas x e y, 3DZ se também fornecer z, ou 4D se fornecer as quatro coordenadas (x, y, z, e m).

A função retorna NULL se qualquer uma das entradas for 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

Funções relacionadas

• st_makeline Função
• st_makepolygon Função
• st_point Função