geo_line_centroid()

Menghitung sentroid garis atau multibaris di Bumi.

Sintaks

geo_line_centroid(lineString)

Pelajari selengkapnya tentang konvensi sintaksis.

Parameter

Nama	Jenis	Diperlukan	Deskripsi
lineString	dynamic	✔️	LineString atau MultiLineString dalam format GeoJSON.

Mengembalikan

Nilai koord sentroid dalam Format GeoJSON dan jenis data dinamis. Jika baris atau multibaris tidak valid, kueri menghasilkan hasil null.

Catatan

• Koordinat geospasial diinterpretasikan sebagaimana direpresentasikan oleh sistem referensi koordinat WGS-84.
• Datum geodetik yang digunakan untuk mengukur jarak di Bumi adalah bola. Tepi garis adalah geodesik pada bola.
• Jika tepi garis input adalah garis kartesius lurus, pertimbangkan untuk menggunakan geo_line_densify() untuk mengubah tepi planar menjadi geodesik.
• Jika input adalah multibaris dan berisi lebih dari satu baris, hasilnya akan menjadi sentroid penyatuan garis.

Batasan dan definisi LineString

dynamic({"type": "LineString","coordinates": [[lng_1,lat_1], [lng_2,lat_2], ..., [lng_N,lat_N]]})

dynamic({"type": "MultiLineString","coordinates": [[line_1, line_2, ..., line_N]]})

• Larik koordinat LineString harus berisi minimal dua entri.
• Koordinat [bujur, lintang] harus valid jika bujur adalah angka riil dalam rentang [-180, +180] dan lintang adalah angka riil dalam rentang [-90, +90].
• Panjang tepi harus kurang dari 180 derajat. Tepi terpendek antara dua simpul dipilih.

Contoh

Contoh berikut menghitung sentroid baris.

Menjalankan kueri

let line = dynamic({"type":"LineString","coordinates":[[-73.95796, 40.80042], [-73.97317, 40.764486]]});
print centroid = geo_line_centroid(line);

Output

sentroid
{"type": "Point", "coordinates": [-73.965567057230942, 40.782453249627416]}

Contoh berikut menghitung garis bujur sentroid.

Menjalankan kueri

let line = dynamic({"type":"LineString","coordinates":[[-73.95807266235352,40.800426144169315],[-73.94966125488281,40.79691751000055],[-73.97317886352539,40.764486356930334],[-73.98210525512695,40.76786669510221],[-73.96004676818848,40.7980870753293]]});
print centroid = geo_line_centroid(line)
| project lng = centroid.coordinates[0]

Output

lng
-73.9660675626837

Contoh berikut memvisualisasikan sentroid baris pada peta.

Menjalankan kueri

let line = dynamic({"type":"MultiLineString","coordinates":[[[-73.95798683166502,40.800556090021466],[-73.98193359375,40.76819171855746]],[[-73.94940376281738,40.79691751000055],[-73.97317886352539,40.76435634049001]]]});
print centroid = geo_line_centroid(line)
| render scatterchart with (kind = map)

Contoh berikut mengembalikan true karena baris yang tidak valid.

Menjalankan kueri

print is_bad_line = isnull(geo_line_centroid(dynamic({"type":"LineString","coordinates":[[1, 1]]})))

Output

is_bad_line
TRUE