ST funkcje geoprzestrzenne

Dotyczy:, sprawdź, czy usługa SQL databricks Databricks Runtime 17.1 lub nowsza

Important

Ta funkcja jest dostępna w publicznej wersji testowej.

Funkcje geoprzestrzenne st działają na obiektach typu GEOGRAPHY i/lub GEOMETRY, lub umożliwiają konstruowanie GEOGRAPHY i GEOMETRY wartości ze standardowych lub popularnych formatów geoprzestrzennych albo eksportowanie GEOGRAPHY i GEOMETRY wartości do standardowych lub popularnych formatów geoprzestrzennych.

Zobacz również:

• Alfabetyczna lista funkcji geoprzestrzennych st

Importowanie funkcji Databricks, aby uzyskać funkcje ST (Databricks Runtime)

Nie jest wymagane importowanie dla Databricks SQL i Spark SQL.

Aby zaimportować funkcje st dla języka Python lub Scala w notesach, użyj następujących poleceń:

Python

from pyspark.databricks.sql import functions as dbf

Scala

import com.databricks.sql.functions._

Lista funkcji geoprzestrzennych ST (Databricks SQL)

Import

Function	Description
st_geogfromgeojson(geojsonExpr)	GEOGRAPHY(4326) Zwraca wartość z reprezentacji GeoJSON.
st_geogfromtext(wktExpr)	Zwraca wartość GEOGRAPHY(4326) z jego reprezentacji WKT.
st_geogfromwkb(wktExpr)	Zwraca wartość GEOGRAPHY(4326) z jej reprezentacji WKB.
st_geogfromwkt(wktExpr)	Zwraca wartość GEOGRAPHY(4326) z jego reprezentacji WKT.
st_geomfromewkb(wktExpr)	Zwraca wartość GEOMETRY(ANY) z reprezentacji EWKB.
st_geomfromgeohash (geohashExpr)	Zwraca pole siatki geohash odpowiadające wartości wejściowego geohash jako wielokąt 2D GEOMETRY.
st_geomfromgeojson(geojsonExpr)	GEOMETRY(4326) Zwraca wartość z reprezentacji GeoJSON.
st_geomfromtext(wktExpr[, sridExpr])	Zwraca wartość GEOMETRY(srid) lub GEOMETRY(ANY) z jego reprezentacji WKT i ustawia wartość SRID na sridExpr, lub na 0, jeśli sridExpr zostanie pominięte.
st_geomfromwkb(wkbExpr[, sridExpr])	Zwraca wartość GEOMETRY(srid) lub GEOMETRY(ANY) z jej reprezentacji WKB i ustawia wartość SRID na sridExpr, lub na 0 jeśli sridExpr jest pominięte.
st_geomfromwkt(wktExpr[, sridExpr])	Zwraca wartość GEOMETRY(srid) lub GEOMETRY(ANY) z jego reprezentacji WKT i ustawia wartość SRID na sridExpr, lub na 0, jeśli sridExpr zostanie pominięte.
st_pointfromgeohash (geohash)	Zwraca środek pola siatki geohash odpowiadający wartości wejściowego geohash jako punkt geometryczny 2D.
to_geography (georepExpr)	GEOGRAPHY(ANY) Zwraca wartość z reprezentacji GeoJSON, WKB lub WKT.
to_geometry (georepExpr)	Zwraca wartość GEOMETRY(ANY) z jej reprezentacji EWKB, GeoJSON, WKB lub WKT.
try_to_geography (georepExpr)	GEOGRAPHY(ANY) Zwraca wartość z reprezentacji GeoJSON, WKB lub WKT albo NULL jeśli reprezentacja wejściowa jest nieprawidłowa.
try_to_geometry (georepExpr)	GEOMETRY(ANY) Zwraca wartość z reprezentacji EWKB, GeoJSON, WKB lub WKT albo NULL jeśli reprezentacja wejściowa jest nieprawidłowa.

Export

Function	Description
st_asbinary (geoExpr)	Zwraca reprezentację WKB wartości GEOGRAPHY lub GEOMETRY jako wartość BINARY.
st_asewkb (geoExpr)	Zwraca reprezentację EWKB dla wartości wejściowej GEOMETRY jako wartość BINARY.
st_asgeojson (geoExpr)	Zwraca reprezentację GeoJSON wartości wejściowej GEOGRAPHY lub GEOMETRY jako wartość STRING.
st_asewkt (geoExpr)	Zwraca reprezentację EWKT wartości wejściowej GEOGRAPHY lub GEOMETRY jako wartość STRING.
st_astext (geoExpr)	Zwraca reprezentację WKT wartości danych wejściowych GEOGRAPHY lub GEOMETRY jako wartość STRING.
st_aswkb (geoExpr)	Zwraca reprezentację WKB wartości GEOGRAPHY lub GEOMETRY jako wartość BINARY.
st_aswkt (geoExpr)	Zwraca reprezentację WKT wartości danych wejściowych GEOGRAPHY lub GEOMETRY jako wartość STRING.
st_geohash (geoExpr [, precisionExpr])	Zwraca geohash geometrii danych wejściowych z daną dokładnością.

Measurements

Function	Description
st_area (geoExpr)	Zwraca obszar wartości wejściowej GEOGRAPHY lub GEOMETRY.
st_distance (geoExpr1, geoExpr2)	Zwraca odległość kartezjańską 2D między dwiema wartościami wejściowymi GEOMETRY .
st_distancesphere (geoExpr1, geoExpr2)	Zwraca odległość sferyczną (w metrach) między dwiema wartościami punktów GEOMETRY mierzoną na sferze, której promień jest średni promień wielokropka WGS84.
st_distancespheroid (geoExpr1, geoExpr2)	Zwraca odległość geodesyczną (w metrach) między dwiema wartościami punktów GEOMETRY wielokropka WGS84.
st_length (geoExpr)	Zwraca długość danej wejściowej GEOGRAPHY lub wartości GEOMETRY.
st_perimeter (geoExpr)	Zwraca obwód wartości wejściowej GEOGRAPHY lub GEOMETRY.

Constructors

Function	Description
st_makeline (geoArray)	Zwraca wartość linestring GEOMETRY , której punkty są niepustymi punktami geometrii w tablicy wejściowej geometrii, które powinny być punktami, ciągami liniowymi lub punktami wielopunktowymi.
st_makepolygon(zewnętrzne[, innerArray])	Tworzy wartość wielokąta GEOMETRY z zewnętrznej granicy wejściowej i opcjonalnej tablicy granic wewnętrznych, reprezentowanych jako zamknięte ciągi liniowe.
st_point(x, y [, srid])	Zwraca wartość punktu GEOMETRY z podanymi współrzędnymi X i Y oraz wartością SRID (jeśli podano).

Accessors

Function	Description
st_dimension (geoExpr)	Zwraca wymiar topologiczny projekcji wartości 2D GEOMETRY.
st_dump (geoExpr)	Zwraca tablicę zawierającą pojedyncze geometrie w geometrii wejściowej.
st_endpoint (geoExpr)	Zwraca ostatni punkt wejściowej wartości GEOGRAPHY lub GEOMETRY, jeśli wejściowa wartość geoprzestrzenna jest niepustą linią łamaną.
st_envelope (geoExpr)	Zwraca dwuwymiarową wartość kartezjańską GEOMETRY reprezentującą osiowo wyrównane minimalne pole ograniczające wartości wejściowej GEOMETRY.
st_envelope_agg(geoCol)	Zwraca kopertę wszystkich geometrii w kolumnie, lub NULL, jeśli kolumna ma zero wierszy, lub zawiera tylko wartości NULL.
st_exteriorring (geoExpr)	Zwraca zewnętrzny pierścień wielokąta GEOGRAPHY wejściowego lub GEOMETRY jako linię.
st_geometryn (geoExpr, nExpr)	Zwraca n-ty element wartości wejściowej GEOMETRY, zaczynając od 1, jako wartość GEOMETRY.
st_geometrytype (geoExpr)	Zwraca typ danych wejściowej GEOGRAPHY lub GEOMETRY jako ciąg znaków.
st_interiorringn (geoExpr, indexExpr)	Zwraca n-ty pierścień wewnętrzny zadanego wielokąta GEOGRAPHY lub GEOMETRY jako linestring.
st_isempty (geoExpr)	Zwraca wartość true, jeśli wartość danych wejściowych GEOGRAPHY lub GEOMETRY nie zawiera żadnych niepustych punktów.
st_m (geoExpr)	Zwraca współrzędną M wartości punktu GEOMETRY wejściowego lub NULL, jeśli punkt jest pusty lub nie ma współrzędnej M.
st_ndims (geoExpr)	Zwraca wymiar współrzędnych wartości wejściowej GEOGRAPHY lub wartości GEOMETRY.
st_npoints (geoExpr)	Zwraca liczbę niepustych punktów w wejściowej wartości GEOGRAPHY lub GEOMETRY.
st_numgeometries (geoExpr)	Zwraca liczbę geometrii w wartości wejściowej GEOMETRY .
st_numinteriorrings (geoExpr)	Zwraca liczbę pierścieni wewnętrznych w GEOGRAPHY wielokącie wejściowym lub wartości GEOMETRY.
st_pointn (geoExpr, indexExpr)	Zwraca n-ty punkt z wejściowego ciągu GEOGRAPHY liniowego lub GEOMETRY wartości.
st_startpoint (geoExpr)	Zwraca pierwsze miejsce wartości wejściowej GEOGRAPHY lub GEOMETRY, jeśli wartość wejściowa jest niepustą linią geoprzestrzenną.
st_x (geoExpr)	Zwraca współrzędną X wartości punktu GEOMETRY wejściowego lub NULL jeśli punkt jest pusty.
st_xmax (geoExpr)	Zwraca maksymalną współrzędną X wartości wejściowej GEOMETRY lub NULL jeśli geometria jest pusta.
st_xmin (geoExpr)	Zwraca minimalną współrzędną X wartości wejściowej GEOMETRY lub NULL jeśli geometria jest pusta.
st_y (geoExpr)	Zwraca współrzędną Y wartości punktu GEOMETRY wejściowego lub NULL jeśli punkt jest pusty.
st_ymax (geoExpr)	Zwraca maksymalną współrzędną Y wartości wejściowej GEOMETRY lub NULL jeśli geometria jest pusta.
st_ymin (geoExpr)	Zwraca minimalną współrzędną Y wartości wejściowej GEOMETRY lub NULL jeśli geometria jest pusta.
st_z (geoExpr)	Zwraca współrzędną Z wartości punktu GEOMETRY wejściowego lub NULL jeśli punkt jest pusty lub nie ma współrzędnej Z.
st_zmax (geoExpr)	Zwraca maksymalną współrzędną Z wartości wejściowej GEOMETRY lub NULL jeśli geometria jest pusta lub nie ma współrzędnej Z.
st_zmin (geoExpr)	Zwraca minimalną współrzędną Z wartości wejściowej GEOMETRY lub NULL jeśli geometria jest pusta lub nie ma współrzędnej Z.

Editors

Function	Description
st_addpoint(geo1Expr, geo2Expr[, indexExpr])	Dodaje nowy punkt do n-tej pozycji w wejściowej linii GEOGRAPHY lub w wartości GEOMETRY.
st_flipcoordinates (geoExpr)	Zamienia współrzędne X i Y wartości wejściowej GEOMETRY .
st_multi (geoExpr)	Zwraca dane wejściowe GEOGRAPHY lub wartość GEOMETRY jako równoważną wartość geoprzestrzenną.
st_removepoint (geoExpr, indexExpr)	Usuwa n-ty punkt z wejściowego ciągu GEOGRAPHY liniowego lub GEOMETRY wartości.
st_reverse (geoExpr)	Odwraca wartość wejściową GEOGRAPHY lub GEOMETRY.
st_setpoint(geo1Expr, indexExpr, geo2Expr)	Ustawia n-ty punkt linii GEOGRAPHY wejściowej lub GEOMETRY wartości.

Walidacja geometrii

Function	Description
st_isvalid (geoExpr)	Zwraca wartość true, jeśli wartość wejściowa GEOMETRY jest prawidłową geometrią w sensie OGC.

Funkcje systemu referencyjnego przestrzennego

Function	Description
st_setsrid (geo, srid)	Zwraca nową wartość GEOMETRY, której wartość SRID jest równa podanemu SRID.
st_srid (geoExpr)	Zwraca identyfikator SRID dla danych wejściowych GEOGRAPHY lub GEOMETRY.
st_transform (geo, srid)	Przekształca współrzędne X i Y danych wejściowych GEOMETRY z bieżącego układu odniesienia współrzędnych do układu odniesienia współrzędnych opisanego przez podaną wartość SRID.

Relacje odległości

Function	Description
st_dwithin(geoExpr1, geoExpr2, distanceExpr)	Zwraca true, jeśli odległość kartezjańska 2D między dwiema wartościami wejściowymi GEOMETRY jest mniejsza lub równa odległości wejściowej.

Relacje topologiczne

Function	Description
st_contains (geo1, geo2)	Zwraca wartość true, jeśli pierwsza GEOMETRY wartość zawiera drugą GEOMETRY wartość.
st_covers (geoExpr1, geoExpr2)	Zwraca wartość true, jeśli pierwsza GEOMETRY wartość obejmuje drugą GEOMETRY wartość.
st_disjoint (geoExpr1, geoExpr2)	Zwraca true, jeśli dwie wartości wejściowe GEOMETRY są rozłączne.
st_equals (geoExpr1, geoExpr2)	Zwraca wartość true, jeśli dwie wartości wejściowe GEOMETRY są geometrycznie równe, co oznacza, że odpowiadają one temu samemu zestawowi punktów.
st_intersects (geoExpr1, geoExpr2)	Zwraca wartość true, jeśli dwie wartości wejściowe GEOMETRY przecinają się.
st_touches (geo1, geo2)	Zwraca wartość true, jeśli dwie wartości wejściowe GEOMETRY dotykają siebie nawzajem.
st_within (geo1, geo2)	Zwraca wartość true, jeśli pierwsza GEOMETRY wartość znajduje się w drugiej GEOMETRY wartości.

Funkcje nakładki

Function	Description
st_difference (geoExpr1, geoExpr2)	Zwraca różnicę zestawu punktów dwóch wartości wejściowych GEOMETRY jako wartość 2D GEOMETRY .
st_intersection (geoExpr1, geoExpr2)	Zwraca skrzyżowanie zestawu punktów dwóch wartości wejściowych GEOMETRY jako wartość 2D GEOMETRY .
st_union (geo1, geo2)	Zwraca unię zestawu punktów dwóch wartości wejściowych GEOMETRY jako geometrię 2D.
st_union_agg(geoCol)	Zwraca związek punktowy wszystkich geometrii w kolumnie lub NULL jeśli kolumna ma zero wierszy lub zawiera tylko NULL wartości.

Przekształcenia affine

Function	Description
st_rotate (geoExpr, rotationAngle)	Obraca wartość wejściową GEOMETRY wokół osi Z według danego kąta obrotu (w radianach).
st_scale(geoExpr, xfactor, yfactor[, zfactor])	Skaluje wartość wejściową GEOMETRY w kierunkach X, Y i, jeśli określono, Z przy użyciu podanych czynników skalowania.
st_translate(geoExpr, xoffset, yoffset[, zoffset])	Tłumaczy wartość wejściową GEOMETRY w kierunkach X, Y i, jeśli określono, Z przy użyciu podanych przesunięć.

Przetwarzanie geometrii

Function	Description
st_buffer (geoExpr, radiusExpr)	Zwraca bufor wartości wejściowej GEOMETRY przy użyciu określonego promienia.
st_centroid (geoExpr)	Zwraca centroid wartości wejściowej GEOMETRY jako wartość punktu GEOMETRY 2D.
st_concavehull(geoExpr, lengthRatioExpr[, allowHolesExpr])	Zwraca wklęsłą otoczkę wartości wejściowej GEOMETRY jako wartość GEOMETRY przy użyciu określonego stosunku długości.
st_convexhull (geoExpr)	Zwraca otoczkę wypukłą wejściowej wartości GEOMETRY jako wartość GEOMETRY.
st_simplify (geograficzne, tolerancja)	Upraszcza wartość wejściową GEOMETRY przy użyciu algorytmu Douglas-Peucker.