Fungsi geospasial ST

Berlaku untuk: pemeriksaan Databricks SQL Databricks Runtime 17.1 ke atas

Important

Fitur ini ada di Pratinjau Publik.

Fungsi geospasial ST beroperasi pada objek jenis GEOGRAPHY dan/atau GEOMETRY, atau memungkinkan untuk membangun GEOGRAPHY dan GEOMETRY nilai dari format geospasial standar atau populer, atau mengekspor GEOGRAPHY dan GEOMETRY nilai ke format geospasial standar atau populer.

Lihat juga:

• Daftar alfabet fungsi geospasial ST

Mengimpor fungsi Databricks untuk mendapatkan fungsi ST (Databricks Runtime)

Tidak diperlukan impor untuk Databricks SQL dan Spark SQL.

Untuk mengimpor fungsi ST untuk Python atau Scala di notebook, gunakan perintah berikut:

Python

from pyspark.databricks.sql import functions as dbf

Scala

import com.databricks.sql.functions._

Daftar fungsi geospasial ST (Databricks SQL)

Import

Function	Description
st_geogfromgeojson(geojsonExpr)	Mengembalikan GEOGRAPHY(4326) nilai dari representasi GeoJSON-nya.
st_geogfromtext(wktExpr)	Mengembalikan nilai GEOGRAPHY(4326) berdasar representasi WKT-nya.
st_geogfromwkb(wktExpr)	Mengembalikan GEOGRAPHY(4326) nilai dari representasi WKB-nya.
st_geogfromwkt(wktExpr)	Mengembalikan nilai GEOGRAPHY(4326) berdasar representasi WKT-nya.
st_geomfromewkb(wktExpr)	Mengembalikan nilai GEOMETRY(ANY) dari representasi EWKB.
st_geomfromgeohash(geohashExpr)	Mengembalikan kotak kisi geohash yang sesuai dengan nilai input geohash dalam bentuk nilai poligon 2D GEOMETRY.
st_geomfromgeojson(geojsonExpr)	Mengembalikan GEOMETRY(4326) nilai dari representasi GeoJSON-nya.
st_geomfromtext(wktExpr[, sridExpr])	Mengembalikan nilai GEOMETRY(srid) atau GEOMETRY(ANY) dari representasi WKT-nya, dan menetapkan nilai SRID-nya ke nilai sridExpr; jika 0 dihilangkan, nilai sridExpr akan digunakan.
st_geomfromwkb(wkbExpr[, sridExpr])	Mengembalikan nilai GEOMETRY(srid) atau GEOMETRY(ANY) dari representasi WKB-nya, dan menetapkan nilai SRID-nya ke sridExpr, atau 0 jika sridExpr tidak disertakan.
st_geomfromwkt(wktExpr[, sridExpr])	Mengembalikan nilai GEOMETRY(srid) atau GEOMETRY(ANY) dari representasi WKT-nya, dan menetapkan nilai SRID-nya ke nilai sridExpr; jika 0 dihilangkan, nilai sridExpr akan digunakan.
st_pointfromgeohash(geohash)	Mengembalikan pusat dari kotak grid geohash yang sesuai dengan nilai geohash masukan dalam bentuk geometri titik 2D.
to_geography(georepExpr)	Mengembalikan GEOGRAPHY(ANY) nilai dari representasi GeoJSON, WKB, atau WKT-nya.
to_geometry(georepExpr)	Mengembalikan GEOMETRY(ANY) nilai dari representasi EWKB, GeoJSON, WKB, atau WKT.
try_to_geography(georepExpr)	Mengembalikan GEOGRAPHY(ANY) nilai dari representasi GeoJSON, WKB, atau WKT, atau NULL jika representasi input tidak valid.
try_to_geometry(georepExpr)	Mengembalikan GEOMETRY(ANY) nilai dari representasi EWKB, GeoJSON, WKB, atau WKT, atau NULL jika representasi input tidak valid.

Export

Function	Description
st_asbinary(geoExpr)	Mengembalikan representasi WKB dari input GEOGRAPHY atau GEOMETRY nilai sebagai BINARY nilai.
st_asewkb(geoExpr)	Mengembalikan representasi EWKB dari nilai input GEOMETRY sebagai BINARY nilai.
st_asgeojson(geoExpr)	Mengembalikan representasi GeoJSON dari input GEOGRAPHY atau GEOMETRY nilai sebagai STRING nilai.
st_asewkt(geoExpr)	Mengembalikan representasi EWKT dari nilai input GEOGRAPHY atau GEOMETRY sebagai STRING.
st_astext(geoExpr)	Mengembalikan representasi WKT dari nilai input GEOGRAPHY atau GEOMETRY sebagai STRING.
st_aswkb(geoExpr)	Mengembalikan representasi WKB dari input GEOGRAPHY atau GEOMETRY nilai sebagai BINARY nilai.
st_aswkt(geoExpr)	Mengembalikan representasi WKT dari nilai input GEOGRAPHY atau GEOMETRY sebagai STRING.
st_geohash(geoExpr [, precisionExpr])	Mengembalikan geohash geometri input pada presisi yang diberikan.

Measurements

Function	Description
st_area(geoExpr)	Menghasilkan area dari nilai input GEOGRAPHY atau GEOMETRY.
st_distance(geoExpr1, geoExpr2)	Mengembalikan jarak Kartesius 2D di antara dua nilai input GEOMETRY .
st_distancesphere(geoExpr1, geoExpr2)	Mengembalikan jarak bulat (dalam meter) di antara dua nilai titik GEOMETRY , yang diukur pada bola yang radiusnya adalah radius rata-rata Elipsoid WGS84.
st_distancespheroid(geoExpr1, geoExpr2)	Mengembalikan jarak geodesik (dalam meter) di antara dua nilai titik GEOMETRY pada elipsoid WGS84.
st_length(geoExpr)	Mengembalikan panjang input GEOGRAPHY atau GEOMETRY nilai.
st_perimeter(geoExpr)	Mengembalikan perimeter dari nilai input GEOGRAPHY atau GEOMETRY.

Constructors

Function	Description
st_makeline(geoArray)	Mengembalikan nilai linestring GEOMETRY di mana titik-titiknya adalah titik tidak kosong dari geometri-geometri dalam array input, yang diharapkan berupa titik, linestring, atau multipoint.
st_makepolygon(outer[, innerArray])	Dari batas luar input dan array opsional batas dalam, membangun nilai poligon GEOMETRY yang diwakili sebagai linestring tertutup.
st_point(x, y [, srid])	Mengembalikan nilai poin GEOMETRY dengan koordinat X dan Y yang diberikan dan nilai SRID (jika disediakan).

Accessors

Function	Description
st_dimension(geoExpr)	Mengembalikan dimensi topologi dari proyeksi 2D nilai GEOMETRY.
st_dump(geoExpr)	Mengembalikan array yang berisi geometri tunggal dalam geometri input.
st_endpoint(geoExpr)	Mengembalikan titik terakhir input GEOGRAPHY atau GEOMETRY nilai, jika nilai geospasial input adalah linestring yang tidak kosong.
st_envelope(geoExpr)	Mengembalikan nilai Kartesius GEOMETRY 2D yang mewakili kotak batas minimum (amplop) nilai input GEOMETRY yang diratakan sumbu 2D.
st_envelope_agg(geoCol)	Mengembalikan amplop semua geometri dalam kolom, atau NULL jika kolom memiliki baris nol, atau hanya berisi nilai NULL.
st_exteriorring(geoExpr)	Mengembalikan cincin eksterior poligon GEOGRAPHY input atau GEOMETRY sebagai linestring.
st_geometryn(geoExpr, nExpr)	Mengembalikan elemen ke-n berbasis 1 dari nilai input GEOMETRY sebagai nilai GEOMETRY.
st_geometrytype(geoExpr)	Mengembalikan jenis input GEOGRAPHY atau GEOMETRY nilai sebagai string.
st_interiorringn(geoExpr, indexExpr)	Mengembalikan cincin interior ke-n dari poligon GEOGRAPHY atau GEOMETRY sebagai linestring.
st_isempty(geoExpr)	Mengembalikan true jika input GEOGRAPHY atau GEOMETRY nilai tidak berisi titik yang tidak kosong.
st_m(geoExpr)	Mengembalikan koordinat M dari nilai titik GEOMETRY input, atau NULL jika titik kosong atau tidak memiliki koordinat M.
st_ndims(geoExpr)	Mengembalikan dimensi koordinat dari nilai input GEOGRAPHY atau GEOMETRY.
st_npoints(geoExpr)	Mengembalikan jumlah titik yang tidak kosong dalam nilai input GEOGRAPHY atau GEOMETRY.
st_numgeometries(geoExpr)	Mengembalikan jumlah geometri dalam nilai input GEOMETRY .
st_numinteriorrings(geoExpr)	Mengembalikan jumlah cincin interior dalam poligon GEOGRAPHY atau GEOMETRY nilai input.
st_pointn(geoExpr, indexExpr)	Mengembalikan poin ke-n dari linestring GEOGRAPHY atau GEOMETRY nilai input.
st_startpoint(geoExpr)	Mengembalikan titik pertama input GEOGRAPHY atau GEOMETRY nilai, jika nilai geospasial input adalah linestring yang tidak kosong.
st_x(geoExpr)	Mengembalikan koordinat X dari nilai titik GEOMETRY input, atau NULL jika titik kosong.
st_xmax(geoExpr)	Mengembalikan koordinat X maksimum dari nilai input GEOMETRY , atau NULL jika geometri kosong.
st_xmin(geoExpr)	Mengembalikan koordinat X minimum dari nilai input GEOMETRY , atau NULL jika geometri kosong.
st_y(geoExpr)	Mengembalikan koordinat Y dari nilai titik GEOMETRY input, atau NULL jika titik kosong.
st_ymax(geoExpr)	Mengembalikan koordinat Y maksimum dari nilai input GEOMETRY , atau NULL jika geometri kosong.
st_ymin(geoExpr)	Mengembalikan koordinat Y minimum dari nilai input GEOMETRY , atau NULL jika geometri kosong.
st_z(geoExpr)	Mengembalikan koordinat Z dari nilai titik GEOMETRY input, atau NULL jika titik kosong atau tidak memiliki koordinat Z.
st_zmax(geoExpr)	Mengembalikan koordinat Z maksimum dari nilai input GEOMETRY , atau NULL jika geometri kosong atau tidak memiliki koordinat Z.
st_zmin(geoExpr)	Mengembalikan koordinat Z minimum dari nilai input GEOMETRY , atau NULL jika geometri kosong atau tidak memiliki koordinat Z.

Editors

Function	Description
st_addpoint(geo1Expr, geo2Expr[, indexExpr])	Menambahkan titik baru ke posisi ke-n dalam linestring dari nilai input GEOGRAPHY atau GEOMETRY.
st_flipcoordinates(geoExpr)	Menukar koordinat X dan Y dari nilai input GEOMETRY .
st_multi(geoExpr)	Mengembalikan input GEOGRAPHY atau GEOMETRY nilai sebagai nilai multi-geospasial yang setara.
st_removepoint(geoExpr, indexExpr)	Menghapus titik ke-n dari linestring GEOGRAPHY atau GEOMETRY nilai input.
st_reverse(geoExpr)	Membalikkan nilai input GEOGRAPHY atau GEOMETRY.
st_setpoint(geo1Expr, indexExpr, geo2Expr)	Mengatur titik ke-n dari linestring input GEOGRAPHY atau nilai GEOMETRY.

Validasi Geometri

Function	Description
st_isvalid(geoExpr)	Mengembalikan benar jika nilai input GEOMETRY adalah geometri yang valid dalam pengertian OGC.

Fungsi Sistem Referensi Spasial

Function	Description
st_setsrid(geo, srid)	Mengembalikan nilai baru GEOMETRY yang SRID-nya adalah nilai SRID yang ditentukan.
st_srid(geoExpr)	Mengembalikan nilai SRID dari input GEOGRAPHY atau GEOMETRY.
st_transform(geo, srid)	Mengubah koordinat X dan Y input GEOMETRY dari sistem referensi koordinat saat ini ke sistem referensi koordinat yang dijelaskan oleh nilai SRID yang disediakan.

Hubungan Jarak

Function	Description
st_dwithin(geoExpr1, geoExpr2, distanceExpr)	Mengembalikan true jika jarak Kartesius 2D antara dua nilai input GEOMETRY lebih kecil dari atau sama dengan nilai jarak input.

Hubungan Topologis

Function	Description
st_contains(geo1, geo2)	Mengembalikan true jika nilai pertama GEOMETRY berisi nilai kedua GEOMETRY .
st_covers(geoExpr1, geoExpr2)	Mengembalikan true jika nilai pertama GEOMETRY mencakup nilai kedua GEOMETRY .
st_disjoint(geoExpr1, geoExpr2)	Mengembalikan true jika dua nilai input GEOMETRY terpisah.
st_equals(geoExpr1, geoExpr2)	Mengembalikan true jika dua nilai input GEOMETRY sama secara geometris, yang berarti nilai tersebut sesuai dengan kumpulan titik yang sama.
st_intersects(geoExpr1, geoExpr2)	Mengembalikan true jika dua nilai input GEOMETRY bersinggungan.
st_touches(geo1, geo2)	Mengembalikan true jika dua nilai input GEOMETRY saling menyentuh.
st_within(geo1, geo2)	Mengembalikan true jika nilai pertama GEOMETRY berada dalam nilai kedua GEOMETRY .

Fungsi Overlay

Function	Description
st_difference(geoExpr1, geoExpr2)	Mengembalikan selisih point-set dari dua nilai input GEOMETRY sebagai nilai 2D GEOMETRY .
st_intersection(geoExpr1, geoExpr2)	Mengembalikan irisan set titik dari dua nilai input GEOMETRY sebagai nilai 2D GEOMETRY.
st_union(geo1, geo2)	Mengembalikan gabungan set titik dari dua nilai input GEOMETRY sebagai geometri 2D.
st_union_agg(geoCol)	Mengembalikan gabungan titik per titik dari semua geometri dalam kolom, atau NULL jika kolom tidak memiliki baris, atau hanya berisi nilai NULL.

Transformasi Affine

Function	Description
st_rotate(geoExpr, rotationAngle)	Memutar nilai input GEOMETRY di sekitar sumbu Z dengan sudut rotasi yang diberikan (dalam radian).
st_scale(geoExpr, xfactor, yfactor[, zfactor])	Menskalakan nilai input GEOMETRY dalam X, Y, dan, jika ditentukan, arah Z menggunakan faktor penskalakan yang disediakan.
st_translate(geoExpr, xoffset, yoffset[, zoffset])	Menerjemahkan nilai input GEOMETRY dalam X, Y, dan, jika ditentukan, arah Z menggunakan offset yang disediakan.

Pemrosesan Geometri

Function	Description
st_buffer(geoExpr, radiusExpr)	Mengembalikan buffer nilai input GEOMETRY menggunakan radius yang ditentukan.
st_centroid(geoExpr)	Mengembalikan sentroid nilai input GEOMETRY sebagai nilai poin GEOMETRY 2D.
st_concavehull(geoExpr, lengthRatioExpr[, allowHolesExpr])	Mengembalikan batas cekung dari nilai input GEOMETRY sebagai nilai GEOMETRY menggunakan rasio panjang yang ditentukan.
st_convexhull(geoExpr)	Mengembalikan lambung cembung dari nilai input GEOMETRY sebagai GEOMETRY nilai.
st_simplify(geo, toleransi)	Menyederhanakan nilai input GEOMETRY menggunakan algoritma Douglas-Peucker.