STBuffer (Jenis Data geografi)

Artikel
12/22/2023

Berlaku untuk: SQL Server Azure SQL Database Azure SQL Managed Instance

Mengembalikan objek geografi yang mewakili gabungan semua titik yang jaraknya dari instans geografi kurang dari atau sama dengan nilai yang ditentukan.

Metode jenis data geografi ini mendukung instans FullGlobe atau instans spasial yang lebih besar dari belahan.

Sintaksis

  
.STBuffer ( distance )

Catatan

Untuk melihat sintaks Transact-SQL untuk SQL Server 2014 (12.x) dan versi yang lebih lama, lihat Dokumentasi versi sebelumnya.

Argumen

jarak
Adalah nilai jenis float (ganda dalam .NET Framework) yang menentukan jarak dari instans geografi di mana untuk menghitung buffer.

Jarak maksimum buffer tidak boleh melebihi 0,999 * π * minorAxis * minorAxis / majorAxis (~0,999 * 1/2 lingkar Bumi) atau seluruh dunia.

Jenis Kembalian

Jenis pengembalian SQL Server: geografi

Jenis pengembalian CLR: SqlGeography

Keterangan

STBuffer() menghitung buffer dengan cara yang sama seperti BufferWithTolerance, menentukan toleransi = abs(distance) * .001 dan relatif = false.

Buffer negatif menghapus semua titik dalam jarak tertentu dari batas instans geografi .

STBuffer() akan mengembalikan instans FullGlobe dalam kasus tertentu; misalnya, STBuffer() mengembalikan instans FullGlobe ketika jarak buffer lebih besar dari jarak dari khatulistiwa ke kutub. Buffer tidak boleh melebihi seluruh dunia.

Metode ini akan melempar ArgumentException dalam instans FullGlobe di mana jarak buffer melebihi batasan berikut:

0,999 * π * minorAxis * minorAxis / majorAxis (~0,999 * 1/2 lingkar Bumi)

Batas jarak maksimum memungkinkan pembangunan buffer sesempurna mungkin.

Kesalahan antara buffer teoritis dan komputasi adalah maks(toleransi, sejauh * 1,E-7) di mana toleransi = jarak * .001. Untuk informasi selengkapnya tentang tingkatan, lihat Referensi Metode Jenis Data geografi.

Contoh

Contoh berikut membuat instans LineString``geography . Kemudian menggunakan STBuffer() untuk mengembalikan wilayah dalam jarak 1 meter dari instans.

DECLARE @g geography;  
SET @g = geography::STGeomFromText('LINESTRING(-122.360 47.656, -122.343 47.656)', 4326);  
SELECT @g.STBuffer(1).ToString();

Lihat Juga

BufferWithTolerance (Jenis Data geografi)
Metode OGC pada Instans Geografi

Bagikan melalui