st_closestpoint Função

Aplica-se a: Databricks SQL Databricks Runtime 18.0 e superior

Retorna a projeção 2D de um ponto no valor do primeiro GEOMETRY, que é mais próximo do valor do segundo GEOMETRY em relação à distância euclidiana.

Sintaxe

st_closestpoint ( geoExpr1, geoExpr2 )

Arguments

• geoExpr1: Valor primeiro de GEOMETRY.
• geoExpr2: o segundo valor GEOMETRY.

Devoluções

Retorna a projeção 2D de um ponto no valor do primeiro GEOMETRY, que é mais próximo do valor do segundo GEOMETRY em relação à distância euclidiana. A expressão retornará um erro ST_DIFFERENT_SRID_VALUES se as duas geometrias de entrada tiverem valores SRID diferentes. O valor SRID do ponto retornado é o mesmo que o valor SRID comum das geometrias de entrada. A expressão retornará o ponto vazio 2D se qualquer uma das duas geometrias de entrada estiver vazia.

NULL será retornado se qualquer uma das duas geometrias de entrada estiver vazia.

Condições de erro

• Se as duas geometrias de entrada tiverem valores SRID diferentes, a função retornará ST_DIFFERENT_SRID_VALUES.

Exemplos

> SELECT st_closestpoint(st_geomfromwkt('MULTIPOINT ZM (-10 10 -1 -10,2 10 -2 -20,20 10 -3 -30)', 3857), st_geomfromwkt('POINT Z (0 0 300)', 3857));
  SRID=3857;POINT(2 10)

Funções relacionadas

• st_distance função
• st_dwithin função