st_closestpoint функция

Применяется к:помечено галочкой да Databricks SQL помечено галочкой да Databricks Runtime 18.0 и более поздних версий

Это важно

Эта функция доступна в общедоступной предварительной версии.

Замечание

Эта функция недоступна в классических хранилищах Databricks SQL. Дополнительные сведения о хранилищах SQL Databricks см. в разделе "Типы хранилища SQL".

Возвращает 2D-проекцию точки на первом GEOMETRY значении, которое ближе ко второму GEOMETRY значению с учетом евклидова расстояния.

Синтаксис

st_closestpoint ( geoExpr1, geoExpr2 )

Arguments

  • geoExpr1: первое GEOMETRY значение.
  • geoExpr2: второе GEOMETRY значение.

Возвраты

Возвращает 2D-проекцию точки на первом GEOMETRY значении, которое ближе ко второму GEOMETRY значению с учетом евклидова расстояния. Выражение возвращает ошибку ST_DIFFERENT_SRID_VALUES , если две входные геометрии имеют разные значения SRID. Значение SRID возвращаемой точки совпадает с общим значением SRID входных геометрий. Выражение возвращает пустую точку 2D, если любая из двух входных геометрий пуста.

NULL возвращается, если какая-либо из двух входных геометрий пуста.

Условия ошибок

  • Если две входные геометрии имеют разные значения SRID, функция возвращает ST_DIFFERENT_SRID_VALUES.

Примеры

> 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)
  • Last updated on