st_closestpoint Função

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

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

Sintaxe

st_closestpoint ( geoExpr1, geoExpr2 )

Arguments

• geoExpr1: O primeiro GEOMETRY valor.
• geoExpr2: O segundo GEOMETRY valor.

Devoluções

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

NULL é 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.

Examples

> 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