st_makepoint Função

Aplica-se a: Databricks SQL Databricks Runtime 18.2 and above

Retorna um valor de ponto GEOMETRY com as coordenadas fornecidas. A função usa 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, representando 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.

Returns

Um valor de tipo GEOMETRY, representando um ponto com as coordenadas especificadas.

O valor SRID da geometria retornada é sempre 0.

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

A função retornará NULL se qualquer uma das entradas for NULL.

Exemplos

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