Funzione st_closestpoint

Si applica a: Databricks Runtime 18.0 e versioni successive

Importante

Questa funzionalità è in Anteprima Pubblica.

Annotazioni

Questa funzionalità non è disponibile in Databricks SQL Classic Warehouses. Per altre informazioni sui databricks SQL Warehouse, vedere Tipi di SQL Warehouse.

Restituisce la proiezione 2D di un punto sul primo GEOMETRY valore più vicino al secondo GEOMETRY rispetto alla distanza euclidea.

Sintassi

st_closestpoint ( geoExpr1, geoExpr2 )

Arguments

• geoExpr1: il primo GEOMETRY valore.
• geoExpr2: il secondo valore GEOMETRY.

Restituzioni

Restituisce la proiezione 2D di un punto sul primo GEOMETRY valore più vicino al secondo GEOMETRY rispetto alla distanza euclidea. L'espressione restituisce un errore ST_DIFFERENT_SRID_VALUES se le due geometrie di input hanno valori SRID diversi. Il valore SRID del punto restituito corrisponde al valore SRID comune delle geometrie di input. L'espressione restituisce il punto vuoto 2D se una delle due geometrie di input è vuota.

NULL viene restituito se una delle due geometrie di input è vuota.

Condizioni di errore

• Se le due geometrie di input hanno valori SRID diversi, la funzione restituisce ST_DIFFERENT_SRID_VALUES.

Esempi

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

Funzioni correlate

• st_distance Funzione
• st_dwithin Funzione