Dokumen ini menjelajahi rincian dari API Model GeoDjango. Melalui bagian ini, kami akan menggunakan model geografis berikut dari ZIP code dan Digital Elevation Model seperti contoh kami:
\nfrom django.contrib.gis.db import models\n\nclass Zipcode(models.Model):\n code = models.CharField(max_length=5)\n poly = models.PolygonField()\n\nclass Elevation(models.Model):\n name = models.CharField(max_length=100)\n rast = models.RasterField()\nBidang-bidang spasial terdiri dari deretan dari jenis bidang geometri dan satu jenis bidang raster. Setiap jenis-jenis bidang geometri sesuai pada spesifikasi OpenGIS Simple Features [1]. Tidak ada standar untuk data raster.
\nGeometryFieldLink to this heading#Kelas dasar untuk bidang geometri.
\nPointFieldLink to this heading#Menyimpan Point.
LineStringFieldLink to this heading#Menyimpan LineString.
PolygonFieldLink to this heading#Menyimpan Polygon.
MultiPointFieldLink to this heading#Menyimpan MultiPoint.
MultiLineStringFieldLink to this heading#Menyimpan MultiLineString.
MultiPolygonFieldLink to this heading#Menyimpan MultiPolygon.
GeometryCollectionFieldLink to this heading#Menyimpan GeometryCollection.
RasterFieldLink to this heading#Menyimpan GDALRaster.
RasterField saat ini hanya diterapkan untuk backend PostGIS.
Sebagai tambahan pada Pilihan bidang biasa tersedia untuk bidang model Django, bidang-bidang spasial mempunyai pilihan tambahan berikut. Semua adalah pilihan.
\nsridLink to this heading#Setel SRID [2] (Spatial Reference System Identity) dari bidang geometri pada nilai diberikan. Awalan pada 4326 (juga dikenal sebagai WGS84, satuan-satuan adalah dalam derajat dari garis bujur dan garis lintang).
\nMemilih sebuah SRID yang sesuai untuk model anda adalah keputusan penting yang pengembang harus dipertimbangkan secara hati-hati. SRID adalah sebuah integer menentukan yang sesuai ke sistem proyeksi yang akan digunakan untuk menterjemahkan data dalam basisdata spasial. [3] Sistem proyeksi memberikan konteks ke kordinat yang menentukan sebuah tempat. meskipun rincian dari geodesy diluar cakupan dari dokumentasi ini, masaalh umum adalah bahwa bumi adalah bulat dan perwakilan dari bumi (misalnya, peta kertas, peta Jaringan) adalah bukan.
\nKebanyakan orang akrab dengan menggunakan garis lintang dan bujur untuk mengacu sebuah lokasi pada permukaan bumi. Bagaimanapun, garis lintang dan bujur adalah sudut, bukan jarak. Dengan kata lain, selagi jalur terpendek diantara dua titik pada permukaan datar adalah garis lurus, jalur terpendek diantara dua titik pada permukaan melengkung (seperti bumi) adalah sebuah arc dari great circle. [4] Dengan demikian, perhitungan tambahan diwajibkan untu mendapatkan jarak dalam satuan planar (misalnya, kilometer dan mil). menggunakan sistem kordinat geografis mungkin memperkenalkan kerumitan untuk pengembang kemudian. Sebagai contoh, SpatiaLite tidak mempunyai kemampuan melakukan perhitungan jarak diantara geometri menggunakan sistem kordinat geometri, misalnya membangun sebuah permintaan untuk menemukan semua titik dalam 5 mil dari batasan daerah disimpan sebagai WGS84. [5]
\nBagian-bagian dari permukaan bumi mungkin diproyeksikan menjadi dua-dimensi, atau kartesian, bidang. Sistem kordinat proyeksi adalah khususnya meyakinkan untuk aplikasi wilayah-tertentu, misalnya, jika anda mengetahui bahwa basisdata anda hanya mencangkup geometri dalam North Kansas, kemudian anda mungkin mempertimbangkan sistem proyeksi spesifik ke wilayah itu. Terlebih lagi, sistem kordinat proyeksi ditentukan dalam satuan kartesian (seperti meter atau kaki), melonggarkan perhitungan jarak.
\n\nSumber daya Tambahan:
\nspatialreference.org: Sebuah basisdata ditenagai-Django dari sistem acuan spasial.
The State Plane Coordinate System: Sebuah situs jaringan mencangkup beragam sistem proyeksi digunakan dalam Amerika Serikat. Banyak ditemui data spasial AS akan menjadi satu dari sistem kordinat ini daripada dalam sistem kordinat geografis seperti WGS84.
spatial_indexLink to this heading#Awalan pada True. Membuat indeks spasial untuk bidang geometri yang diberikan.
Ada pilihan tambahan tersedia untuk bidang Geometri. Semua pilihan berikut adalah pilihan.
\ndimLink to this heading#Pilihan ini mungkin digunakan untuk menyesuaikan dimensi kordinat dari bidang geometri. Secara awalan, itu menyetel ke 2, untuk perwakilan geometri dua-dimensi. Untuk backend spasial yang mendukung itu, itu mungkin disetel menjadi 3 untuk dukungan 3-dimensi.
\n\ngeographyLink to this heading#Jika disetel menjadi True, pilihan ini akan membuat sebuah kolom basisdata dari jenis geografi, daripada geometri. Harap mengacu pada bagian geography type dibawah untuk lebih rinci.
Jenis geografi menyediakan dukungan asli untuk fitur-fitur spasial diwakili dengan kordinat geografis (misalnya, bujur/lintang WGS84). [6] Tidak seperti plane digunakan oleh jenis geometri, jenis geografi menggunakan perwakilan bulat dari datanya. jarak dan tindakan pengukuran dilakukan pada kolom geografis secara otomatis menggunakan perhitungan busur lingkaran hebat dan mengembalikan satuan segaris. Dengan kata lain, ketika ST_Distance dipanggil pada dua geografis, sebuah nilai dalam meter dikembalikan (sebagai lawan dari tingkatan jika dipanggil pada kolom geometri dalam WGS84).
Karena perhitungan geografis melibatkan matematika lebih, hanya bagian dari pencarian spasial PostGIS tersedia untuk jenis geografi. Secara praktik, ini berarti bahwa sebagai tambahan pada distance lookups hanya berikut tambahan spatial lookups tersedia untuk kolom geografi:
\nJika anda butuh menggunakan pencarian spasial atau pengumpulan yang tidak mendukung jenis geografi sebagai masukan, anda dapat menggunakan fungsi basisdata Cast untuk merubah kolom geografi menjadi jenis geometri dalam permintaan:
from django.contrib.gis.db.models import PointField\nfrom django.db.models.functions import Cast\n\nZipcode.objects.annotate(\n geom=Cast('geography_field', PointField())\n).filter(geom__within=poly)\nUntuk informasi lebih, dokumentasi PostGIS mengandung bagian membantu pada menentukan when to use geography data type over geometry data type.
\nCatatan kaki
\n\n