Delen via


st_closestpoint functie

Van toepassing op:aangevinkt als ja Databricks Runtime 18.0 en hoger

Belangrijk

Deze functie bevindt zich in openbare preview-versie.

Opmerking

Deze functie is niet beschikbaar in Databricks SQL Classic Warehouses. Zie SQL Warehouse-typen voor meer informatie over Databricks SQL-warehouses.

Berekent de 2D-projectie van een punt op de eerste GEOMETRY waarde die het dichtst bij de tweede GEOMETRY waarde ligt ten opzichte van de Euclidische afstand.

Syntaxis

st_closestpoint ( geoExpr1, geoExpr2 )

Arguments

  • geoExpr1: De eerste GEOMETRY waarde.
  • geoExpr2: De tweede GEOMETRY waarde.

Retouren

Berekent de 2D-projectie van een punt op de eerste GEOMETRY waarde die het dichtst bij de tweede GEOMETRY waarde ligt ten opzichte van de Euclidische afstand. De expressie retourneert een ST_DIFFERENT_SRID_VALUES fout als de twee invoergeometrieën verschillende SRID-waarden hebben. De SRID-waarde van het geretourneerde punt is hetzelfde als de gemeenschappelijke SRID-waarde van de invoergeometrieën. De expressie retourneert het lege 2D-punt als een van de twee invoergeometrieën leeg is.

NULL wordt geretourneerd als een van de twee invoergeometrieën leeg is.

Foutvoorwaarden

Voorbeelden

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