Membuat, Membangun, dan Menjalankan kueri Instans geografi

Jenis data spasial geografi, geography, mewakili data dalam sistem koordinat bulat bumi. Jenis ini diimplementasikan sebagai jenis data .NET common language runtime (CLR) di SQL Server. Jenis data SQL Server geography menyimpan data elipsoidal (bumi bulat), seperti koordinat lintang dan bujur GPS.

geography Jenisnya telah ditentukan sebelumnya dan tersedia di setiap database. Anda dapat membuat kolom tabel jenis geography dan beroperasi pada geography data dengan cara yang sama seperti Anda akan menggunakan jenis yang disediakan sistem lainnya.

Membuat atau membangun entitas geografi baru

Membuat Instans geografi Baru dari Instans yang Sudah Ada

Jenis geography data menyediakan banyak metode bawaan yang dapat Anda gunakan untuk membuat instans baru geography berdasarkan instans yang ada.

Untuk membuat penyangga di sekitar wilayah
STBuffer (Tipe Data Geografi)

Untuk membuat buffer di sekeliling suatu area geografis, dengan mempertimbangkan toleransi
BufferWithTolerance (Jenis Data geografi)

Untuk membuat geografi dari persimpangan dua instans geografi
STIntersection (Jenis Data geografi)

Untuk membuat geografi dari penggabungan dua instans geografi
STUnion (Tipe Data Geografi)

Untuk membuat geografi dari titik di mana satu geografi tidak tumpang tindih dengan yang lain
STDifference (Jenis Data Geografi)

Membuat Instans geografi dari Input Teks Well-Known

Jenis geography data menyediakan beberapa metode bawaan yang menghasilkan geografi dari representasi WKT dari Open Geospatial Consortium (OGC). Standar WKT adalah string teks yang memungkinkan data geografi ditukar dalam bentuk tekstual.

Untuk membuat semua jenis instans geografi dari input WKT
STGeomFromText (Tipe Data Geografi)

Uraikan (Jenis Data geografi)

Untuk membuat instans Titik geografi dari input WKT
STPointFromText (Tipe Data Geografi)

Untuk membangun instance MultiPoint geografi dari masukan WKT
STMPointFromText (Tipe Data geografi)

Membangun contoh LineString geografi dari masukan WKT
STLineFromText (Tipe Data Geografi)

Untuk membuat instans geografi MultiLineString dari input WKT
STMLineDariText (Jenis Data geografi)

Untuk membuat instans Poligon geografi dari input WKT
STPolyFromText (Jenis Data geografi)

Untuk membuat objek MultiPolygon geografi dari input WKT
STMPolyFromText (Tipe Data Geografi)

Untuk membuat objek koleksi geometri tipe geografi dari input WKT
STGeomCollFromText (Tipe Data Geografi)

Membuat Instans geografi dari Input Biner Well-Known

WKB adalah format biner yang ditentukan oleh OGC yang mengizinkan Geography data untuk ditukar antara aplikasi klien dan database SQL. Fungsi berikut menerima input WKB untuk membuat instans geografi:

Untuk membuat semua jenis instans geografi dari input WKB
STGeomFromWKB (Tipe Data Geografi)

Untuk membangun elemen Titik geografi dari input WKB
STPointFromWKB (Tipe Data Geografi)

Cara membuat objek MultiPoint geografi dari input WKB
STMPointFromWKB (Geography Data Type)

Untuk membuat instans LineString geografi dari input WKB
STLineFromWKB (Jenis Data Geografi)

Untuk membuat instans MultiLineString geografi dari input WKB
STMLineFromWKB (Tipe Data Geografi)

Untuk membuat instans Poligon geografi dari input WKB
STPolyFromWKB (Tipe Data Geografi)

Untuk membuat sebuah instans MultiPolygon geografis dari input WKB
STMPolyFromWKB (Jenis Data Geografi)

Untuk membangun instans GeometryCollection geometri dari input WKB
STGeomCollFromWKB (Jenis Data Geografi)STGeomCollFromWKB (Jenis Data Geografi)

Membuat Instans geografi dari Input Teks GML

Tipe data geography menyediakan metode yang menghasilkan instans geography dari GML, perwakilan XML dari instans geography. SQL Server mendukung subset GML.

Untuk informasi selengkapnya tentang Bahasa Markup Geografi, lihat Spesifikasi OGC: Spesifikasi OGC, Bahasa Markup Geografi.

Untuk membuat semua jenis instans geografi dari input GML
GeomFromGML (Tipe Data Geografi)

Mengembalikan Teks Well-Known dan Biner Well-Known dari Instans Geografi

Anda dapat menggunakan metode berikut untuk mengembalikan instansi dalam format WKT atau WKB:

Untuk mengembalikan representasi WKT dari instans geografi
STAsText (Jenis Data Geografi)

ToString (Tipe Data geografi)

Untuk menampilkan representasi WKT dari instans geografi termasuk nilai Z dan M yang ada
AsTextZM (Jenis Data geografi)

Untuk mengembalikan representasi WKB dari instans geografi
STAsBinary (Jenis Data Geografi)

Untuk mengembalikan representasi GML dari instans geografi
AsGml (Jenis Data Geografi)

Mengkueri Properti dan Perilaku Instans geografi

Semua geography instans memiliki sejumlah properti yang dapat diambil melalui metode yang disediakan SQL Server. Topik berikut menentukan properti dan perilaku jenis geografi, dan metode untuk mengkueri masing-masing.

Validitas, Jenis Instans, dan Informasi Koleksi Geometri

Setelah instance geography dibuat, Anda dapat menggunakan metode berikut untuk mengembalikan jenis instance tersebut, atau jika merupakan instance GeometryCollection, mengembalikan instance geography tertentu.

Untuk mengembalikan jenis instans geografi
STGeometryType (Tipe Data Geografi)

Untuk menentukan apakah suatu wilayah geografi itu tipe instance tertentu
InstanceOf (Tipe Data geografi)

Untuk menentukan apakah instans geografi terbentuk dengan baik untuk jenis instansnya
STNumGeometries (Tipe Data geografi)

Untuk mengembalikan geografi tertentu dalam instans GeometryCollection
STGeometryN (Jenis Data geografi)STGeometryN (Jenis Data geografi)

Jumlah Titik

Semua instans yang tidak kosong geography terdiri dari poin. Titik-titik ini mewakili koordinat garis lintang dan bujur bumi tempat instans geography digambar. Jenis data geography menyediakan banyak metode bawaan untuk meminta titik-titik dari sebuah instans.

Untuk mengembalikan jumlah titik yang mencakup sebuah instance
STNumPoints (Tipe Data geografi)

Untuk mengembalikan titik tertentu dalam instans
STPointN (Geometry Data Type)

Untuk mengembalikan titik awal instans
STStartPoint (Jenis Data geografi)

Untuk mengembalikan titik akhir instans
STEndpoint (Jenis Data Geografi)

Dimensi

Instans yang tidak kosong geography bisa berdimensi 0-, 1-, atau 2-. Instans nol dimensi geography , seperti Point dan MultiPoint, tidak memiliki panjang atau area. Objek satu dimensi, seperti LineString, CircularString, , CompoundCurvedan MultiLineString, memiliki panjang. Instans dua dimensi, seperti Polygon, CurvePolygon, dan MultiPolygon, memiliki area dan panjang. Instans kosong melaporkan dimensi -1, dan GeometryCollection melaporkan dimensi maksimum kontennya.

Untuk menentukan dimensi sebuah instans
STDimension (Data Jenis geografi)

Untuk mengembalikan panjang instans
STLength (Tipe Data geografi)

Untuk mengembalikan nilai area dari sebuah instans
STArea (Tipe Data Geografi)

Kosong

Instans kosonggeography tidak memiliki poin apa pun. Panjang LineString, CircularString, CompoundCurve, dan MultiLineString instans kosong adalah 0. Luas dari instans kosong Polygon, CurvePolygon dan MultiPolygon adalah 0.

Untuk menentukan apakah instans kosong
STIsEmpty (Jenis Data Geografi)

Penutupan

Instans tertutupgeography adalah gambar yang titik awal dan titik akhirnya sama. Polygon instance dianggap telah selesai. Point instance belum ditutup.

Cincin adalah bentuk yang sederhana dan tertutup LineString.

Untuk menentukan apakah instans ditutup
STIsClosed (jenis data geografi)

Untuk mengembalikan jumlah cincin dalam instans Poligon
NumRings (Jenis Data geografi)

Untuk mengembalikan cincin tertentu dari instans geografi
RingN (Jenis Data Geografi)

ID Referensi Spasial (SRID)

ID referensi spasial (SRID) adalah pengidentifikasi yang menentukan di mana sistem koordinat elipsoidal geography instans diwakili. Dua geography instans dengan SRID yang berbeda tidak dapat dibandingkan.

Untuk mengatur atau mengembalikan SRID instans
STSrid (Jenis data Geografi)

Properti ini dapat dimodifikasi.

Menentukan Hubungan antara Instans geografi

Jenis geography data menyediakan banyak metode bawaan yang dapat Anda gunakan untuk menentukan hubungan antara dua geography instans.

Untuk menentukan apakah dua instans terdiri dari kumpulan titik yang sama
STEquals (Geometri Jenis Data)

Untuk menentukan apakah dua instans saling terpisah
STDisjoint (Tipe Data Geometri)

Untuk menentukan apakah dua contoh bersinggungan
STIntersects (Tipe Data Geometri)

Untuk menentukan satu atau beberapa titik di mana dua kasus berpotongan
STIntersection (Tipe Data Geografi)

Untuk menentukan jarak terpendek antara titik dalam dua instans geografi
STDistance (Tipe Data Geometri)

Untuk menentukan perbedaan poin antara dua instans geografi
STDifference (Tipe Data Geografi)

Untuk mendapatkan perbedaan simetris, atau poin unik, dari satu instans geografi dibandingkan dengan instans lain
STSymDifference (Tipe Data Geografis)

Contoh geografi harus menggunakan SRID yang didukung

SQL Server mendukung SRID berdasarkan standar EPSG. SRID yang didukung SQL Server untuk geography instans harus digunakan saat melakukan penghitungan atau menggunakan metode dengan data spasial geografi. SRID harus cocok dengan salah satu SRID yang ditampilkan dalam tampilan katalog sys.spatial_reference_systems . Seperti disebutkan sebelumnya, ketika Anda melakukan perhitungan pada data spasial Anda menggunakan geography jenis data, hasil Anda akan bergantung pada elipsoid mana yang digunakan dalam pembuatan data Anda, karena setiap elipsoid diberi pengidentifikasi referensi spasial (SRID) tertentu.

SQL Server menggunakan SRID default 4326, yang sesuai dengan sistem referensi spasial WGS 84, ketika metode digunakan pada instans geography. Jika Anda menggunakan data dari sistem referensi spasial selain WGS 84 (atau SRID 4326), Anda harus menentukan SRID tertentu untuk data spasial geografi Anda.

Contoh

Contoh berikut menunjukkan cara menambahkan dan mengkueri data geografi.

• Contoh pertama membuat tabel dengan kolom identitas dan geography kolom GeogCol1. Kolom ketiga mengubah kolom geography ke dalam representasi Open Geospatial Consortium (OGC) Well-Known Text (WKT), dan menggunakan metode STAsText(). Dua baris kemudian disisipkan: satu baris berisi LineString instance dari geography, dan satu baris berisi Polygon instance.

  IF OBJECT_ID ( 'dbo.SpatialTable', 'U' ) IS NOT NULL   
      DROP TABLE dbo.SpatialTable;  
  GO  
  
  CREATE TABLE SpatialTable   
      ( id int IDENTITY (1,1),  
      GeogCol1 geography,   
      GeogCol2 AS GeogCol1.STAsText() );  
  GO  
  
  INSERT INTO SpatialTable (GeogCol1)  
  VALUES (geography::STGeomFromText('LINESTRING(-122.360 47.656, -122.343 47.656)', 4326));  
  
  INSERT INTO SpatialTable (GeogCol1)  
  VALUES (geography::STGeomFromText('POLYGON((-122.358 47.653, -122.348 47.649, -122.348 47.658, -122.358 47.658, -122.358 47.653))', 4326));  
  GO  
  

• Contoh kedua menggunakan metode STIntersection() untuk mengembalikan titik di mana dua instans geography yang disisipkan sebelumnya saling bersinggungan.

  DECLARE @geog1 geography;  
  DECLARE @geog2 geography;  
  DECLARE @result geography;  
  
  SELECT @geog1 = GeogCol1 FROM SpatialTable WHERE id = 1;  
  SELECT @geog2 = GeogCol1 FROM SpatialTable WHERE id = 2;  
  SELECT @result = @geog1.STIntersection(@geog2);  
  SELECT @result.STAsText();  
  

Lihat Juga

Data Spasial (SQL Server)