GEOS kepanjangan untuk Geometry Engine - Open Source, dan adalah sebuah pustaka C++, dihubungkan dari Java Topology Suite. GEOS menerapkan OpenGIS Simple Features for SQL fungsi predikat spasial dan penghubung spasial. GEOS, sekarang sebuah proyek OSGeo, yang aslinya dikembangkan dan dirawat oleh Refractions Research dari Victoria, Canada.
\nGeoDjango menerapkan pembungkus Python tingkat-tinggi untuk pustaka GEOS, fitur-fiturnya termasuk:
\nSebuah antarmuka berlisensi-BSD pada rutin geometri GEOS, diterapkan sepenuhnya dalam Python menggunakan ctypes.
Loosely-coupled to GeoDjango. For example, GEOSGeometry objects\nmay be used outside of a Django project/application. In other words,\nno need to have DJANGO_SETTINGS_MODULE set or use a database, etc.
Berubah-ubah: obyek GEOSGeometry mungkin dirubah.
Lintas-serambi dan teruji; cocok dengan serambi Windows, Linux, Solaris, dan macOS.
Bagian ini mengandung perkenalan singkat dan pengajaran tambahan menggunakan obyek GEOSGeometry.
Obyek GEOSGeometry mungkin dibuat dalam beberapa cara. Pertama cukup menginstansiasi obyek pada beberapa masukan spasial -- berikut adalah contoh dari membuat geometri sama dari WKT, HEX, WKB, dan GeoJSON:
>>> from django.contrib.gis.geos import GEOSGeometry\n>>> pnt = GEOSGeometry('POINT(5 23)') # WKT\n>>> pnt = GEOSGeometry('010100000000000000000014400000000000003740') # HEX\n>>> pnt = GEOSGeometry(buffer('\\x01\\x01\\x00\\x00\\x00\\x00\\x00\\x00\\x00\\x00\\x00\\x14@\\x00\\x00\\x00\\x00\\x00\\x007@'))\n>>> pnt = GEOSGeometry('{ "type": "Point", "coordinates": [ 5.000000, 23.000000 ] }') # GeoJSON\nPilihan lain adalah menggunakan pembangun untuk jenis geometri khusus yang anda harap dibuat. Sebagai contoh, obyek Point mungkin dibuat dengan melewatkan dalam kordinat X dan Y kedalam pembangunnya:
>>> from django.contrib.gis.geos import Point\n>>> pnt = Point(5, 23)\nSemua pembangun ini mengambil argumen kata kunci srid. Sebagai contoh:
>>> from django.contrib.gis.geos import GEOSGeometry, LineString, Point\n>>> print(GEOSGeometry('POINT (0 0)', srid=4326))\nSRID=4326;POINT (0 0)\n>>> print(LineString((0, 0), (1, 1), srid=4326))\nSRID=4326;LINESTRING (0 0, 1 1)\n>>> print(Point(0, 0, srid=32140))\nSRID=32140;POINT (0 0)\nAkhirnya, ada metode pabrik fromfile() yang mengembalikan obyek GEOSGeometry dari sebuah berkas:
>>> from django.contrib.gis.geos import fromfile\n>>> pnt = fromfile('/path/to/pnt.wkt')\n>>> pnt = fromfile(open('/path/to/pnt.wkt'))\nObyek-obyek GEOSGeometry adalah 'Pythonic', dengan kata lain komponen-komponen dapat diakses, dirubah, dan diperulangkan menggunakan kebiasaan Python standar. Sebagai contoh, anda dapat mengulangi kordinat dalam Point:
>>> pnt = Point(5, 23)\n>>> [coord for coord in pnt]\n[5.0, 23.0]\nDengan obyek geometri apapun, sifat GEOSGeometry.coords mungkin digunakan untuk mendapatkan kordinat geometri sebagai sebuah tuple Python:
>>> pnt.coords\n(5.0, 23.0)\nAnda dapat mendapatkan/menyetel komponen geometri menggunakan teknik-teknik pengindeksan Python standar. bagaimanapun, apa yang dikembalikan bergantung pada jenis geometri dari obyek. Sebagai contoh, pengindeksan pada LineString mengembalikan sebuah kordinat tuple:
>>> from django.contrib.gis.geos import LineString\n>>> line = LineString((0, 0), (0, 50), (50, 50), (50, 0), (0, 0))\n>>> line[0]\n(0.0, 0.0)\n>>> line[-2]\n(50.0, 0.0)\nDimana pengindeksan pada Polygon akan mengembalikan lingkaran (sebuah obyek LinearRing) berhubungan pada index:
>>> from django.contrib.gis.geos import Polygon\n>>> poly = Polygon( ((0.0, 0.0), (0.0, 50.0), (50.0, 50.0), (50.0, 0.0), (0.0, 0.0)) )\n>>> poly[0]\n<LinearRing object at 0x1044395b0>\n>>> poly[0][-2] # second-to-last coordinate of external ring\n(50.0, 0.0)\nSebagai tambahan, kordinat/komponen dari geometri mungkin ditambahkan atau dirubah, seperti list Python:
\n>>> line[0] = (1.0, 1.0)\n>>> line.pop()\n(0.0, 0.0)\n>>> line.append((1.0, 1.0))\n>>> line.coords\n((1.0, 1.0), (0.0, 50.0), (50.0, 50.0), (50.0, 0.0), (1.0, 1.0))\nGeometri mendukung penghubung set-like:
\n>>> from django.contrib.gis.geos import LineString\n>>> ls1 = LineString((0, 0), (2, 2))\n>>> ls2 = LineString((1, 1), (3, 3))\n>>> print(ls1 | ls2) # equivalent to `ls1.union(ls2)`\nMULTILINESTRING ((0 0, 1 1), (1 1, 2 2), (2 2, 3 3))\n>>> print(ls1 & ls2) # equivalent to `ls1.intersection(ls2)`\nLINESTRING (1 1, 2 2)\n>>> print(ls1 - ls2) # equivalent to `ls1.difference(ls2)`\nLINESTRING(0 0, 1 1)\n>>> print(ls1 ^ ls2) # equivalent to `ls1.sym_difference(ls2)`\nMULTILINESTRING ((0 0, 1 1), (2 2, 3 3))\nGEOSGeometryLink to this heading#geo_input -- Nilai masukan geometri (string atau buffer)
srid (int) -- penciri acuan spasial
Ini adalah kelas dasar untuk semua obyek geometri GEOS. Itu menginisialisasikan pada argumen geo_input yang diberikan, dan kemudian mengganggap subkelas geometri sesuai (misalnya, GEOSGeometry('POINT(1 1)') akan membuat sebuah obyek Point).
Parameter srid, jika diberikan, disetel sebagai SRID dari geometri dibuat jika geo_input tidak memiliki SRID. Jika SRID berbeda disediakan melalui geo_input dan parameter srid, ValueError dimunculkan:
>>> from django.contrib.gis.geos import GEOSGeometry\n>>> GEOSGeometry('POINT EMPTY', srid=4326).ewkt\n'SRID=4326;POINT EMPTY'\n>>> GEOSGeometry('SRID=4326;POINT EMPTY', srid=4326).ewkt\n'SRID=4326;POINT EMPTY'\n>>> GEOSGeometry('SRID=1;POINT EMPTY', srid=4326)\nTraceback (most recent call last):\n...\nValueError: Input geometry already has SRID: 1.\nBentuk-bentuk masukan berikut, bersama dengan jenis-jenis Python yang sesuai, adalah diterima:
\nBentuk | \nJenis Masukan | \n
|---|---|
WKT / EWKT | \n
| \n
HEX / HEXEWKB | \n
| \n
WKB / EWKB | \n
| \n
| \n |
| \n
Untuk bentuk GeoJSON, SRID disetel berdasarkan pada anggota crs. jika crs tidak disediakan, SRID awalan pada 4326.
Membangun sebuah GEOSGeometry dari string GML yang diberikan.
Mengembalikan kordinat dari geometri sebagai tuple.
\nMengembalikan dimensi dari geometri:
\n0 untuk Point dan MultiPoint
1 untuk LineString dan MultiLineString
2 untuk Polygon dan MultiPolygon
-1 untuk GeometryCollection kosong
dimensi maksimal dari unsur-unsurnya untuk GeometryCollection bukan-kosong.
Mengembalikan apakah atau tidak disetel dari titik-titik dalam geometri adalah kosong.
\nMengembalikan string sesuai pada jenis dari geometri. Sebagai contoh:
\n>>> pnt = GEOSGeometry('POINT(5 23)')\n>>> pnt.geom_type\n'Point'\nMengembalikan angka penciri jenis geometri GEOS. Tabel berikut menunjukkan nilai untuk setipa jenis geometri:
\nGeometri | \nID | \n
|---|---|
| \n | 0 | \n
| \n | 1 | \n
| \n | 2 | \n
| \n | 3 | \n
| \n | 4 | \n
| \n | 5 | \n
| \n | 6 | \n
| \n | 7 | \n
Mengembalikan angka dari kordinat di geometri.
\nMengembalikan sejumlah geometri dalam geometri ini. Dengan kata lain, akan mengembalikan 1 pada apapun kecuali kumpulan geometri.
\nMengembalikan sebuah boolean menunjukkan apalah geometri adalah tiga-dimensi.
\nMengembalikan sebuah boolean menunjukkan apakah geometri adalah LinearRing.
Mengembalikan sebuah boolean menunjukkan apakah geometri adalah 'simple'. Sebuah geometri adalah sederhana jika dan hanya jika itu tidak menyilang itu sendiri (kecuali pada titik batasan). Sebagai contoh, sebuah obyek LineString tidak sederhana jika itu bersilangan itu sendiri. Dengan demikian, obyek LinearRing dan Polygon selalu sederhana karena mereka tidak dapat melakukan bersilangan mereka sendiri, menurut pengertian.
Mengembalikan sebuah boolean menunjukkan apakah geometri adalah sah.
\nMengembalikan deretan kalimat menggambarkan alasan mengapa geometri sah.
\nSifat yang mungkin digunakan untuk mengambil atau menyetel SRID berkaitan dengan geometri. Sebagai contoh:
\n>>> pnt = Point(5, 23)\n>>> print(pnt.srid)\nNone\n>>> pnt.srid = 4326\n>>> pnt.srid\n4326\nSifat dalam bagian ini mengexpor obyek GEOSGeometry menjadi sebuah yang berbeda. Keluaran ini mungkin dalam bentuk string, penyangga, atau bahkan obyek lain.
Mengembalikan "extended" Well-Known Text dari geometri ini. Perwakilan ini khusus untuk PostGIS dan superset dari standar WKT OGC. [1] Pada dasarnya SRID ditambahkan pada perwakilan WKT, sebagai contoh SRID=4326;POINT(5 23).
Mengembalikan WKB dari Geometri dalam bentuk heksadesimal. Harap catat bahwa nilai SRID tidak disertakan dalam perwakilan ini karena itu bukan bagian dari spesifikasi OGC (gunakan sifat GEOSGeometry.hexewkb sebagai gantinya).
Mengembalikan WKB dari Geometri dalam bentuk heksadesimal. Ini adalah sebuah tambahan dari spesifikasi WKB yang menyertakan nilai SRID yang merupakan bagian dari geometri ini.
\nMengembalikan perwakilan GeoJSON dari geometri. Catat bahwa ahsiladalah bukan struktur GeoJSON lengkap tetapi hanya isi kunci geometry dari struktur GeoJSON. Lihat juga Penserial GeoJSON.
Nama lain dari GEOSGeometry.json.
Mengembalikan perwakilan KML (Keyhole Markup Language) dari geometri. Ini jangan hanya digunakan untuk geometri dengan SRID dari 4326 (WGS84), tetapi pembatasan ini tidak dilaksanakan.
\nMengembalikan obyek OGRGeometry terkait pada permintaan pada geometri GEOS.
Mengembalikan perwakilan WKB (Well-Known Binary) dari Geometry ini sebagai sebuah penyangga Python. Nilai SRID tidak disertakan, gunakan sifat GEOSGeometry.ewkb sebagai gantinya.
Mengembalikan perwakilan EWKB dari Geometry sebagai sebuah penyangga Python. Ini adalah sebuah tambahan dari spesifikasi WKB yang menyertakan nilai SRID apapun yang bagian dari geometri ini.
\nMengembalikan Well-Known Text dari geometri (sebuah standar OGC).
\nSemua dari metode-metode predikat spasial berikut mengambil contoh GEOSGeometry lain (other) sebagai sebuah parameter, dan mengembalikan boolean.
Mengembalikan True jika other.within(this) mengembalikan True.
Mengembalikan True jika geometri mencangkup geometri tertentu.
Sebutan covers mempunyai pengertian kesetaraan berikut:
Setiap titik dari geometri lain adalah sebuah titik dari geometri ini.
The DE-9IM Intersection Matrix untuk dua geometri adalah T*****FF*, *T****FF*, ***T**FF*, atau ****T*FF*.
Jika salah satu geometri adalah kosong, kembalikan False.
Prediakt ini mirip pada GEOSGeometry.contains(), tetapi lebih termasuk (yaitu mengembalikan True untuk kasus-kasus lebih). Khususnya, tidak seperti contains() itu tidak membedakan diantara titik-titik dalam batasan dan dalam interior dari geometri. Untuk kebanyakan situasi, covers() harus dipilih pada contains(). Sebagai sebuah keuntungan tambahan, covers() lebih menerima untuk optimalisasi dan karena itu harus mengungguli contains().
Mengembalikan True jika matriks persimpangan DE-9IM untuk dua geometri adalah T*T****** (untuk titik dan kurva, titik dan kawasan atau baris dan kawasan) 0******** (untuk dua kurva).
Mengembalikan True jika matriks persimpangan DE-9IM untuk dua geometri adalah FF*FF****.
Mengembalikan True jika matriks persimpangan DE-9IM untuk dua geometri adalah T*F**FFF*.
Mengembalikan true jika dua geometri tepatnya setara, sampai toleransi yang ditentukan. Nilai tolerance harus berupa angka floating point mewakili toleransi kesalahan dalam perbandingan, misalnya, poly1.equals_exact(poly2, 0.001) akan membandingkan kesetaraan dalam ribuan dari sebuah satuan.
Mengembalikan True jika GEOSGeometry.disjoint() adalah False.
Mengembalikan True jika matriks persimpangan DE-9IM untuk dua geometri adalah T*T***T** (untuk titik dan kurva, titik dan kawasan atau baris dan kawasan) 1*T***T** (untuk dua kurva).
Mengembalikan True jika matriks persimpangan DE-9IM untuk geometri ini dah lainnya cocok pada pattern yang diberikan -- string dari sembilan karakter dari alfabet: {T, F, *, 0}.
Mengembalikan True jika matriks persimpangan DE-9IM untuk dua geometri adalah FT*******, F**T***** or F***T****.
Mengembalikan True jika matriks persimpangan DE-9IM untuk dua geometri adalah T*F**F***.
Mengembalikan sebuah GEOSGeometry yang mewakili semua titik-titik yang jaraknya dari geometri ini kurang dari atau setara pada width yang diberikan. Kata kunci quadsegs pilihan mensetel angka dari bagian-bagian digunakan untuk memperkirakan seperempat lingkaran (awalan adalah 8).
Sama seperti buffer(), tetapi mengizinkan gaya dari penyangga.
end_cap_style dapat berupa round (1), flat (2), atau square (3).
join_style dapat berupa round (1), mitre (2), atau bevel (3).
Batas rasio siku (mitre_limit) hanya mempengaruhi gaya gabungan sudut.
Mengembalikan GEOSGeometry mewakili titik-titik membuat geometri ini yang tidak membuat lain.
Diberikan sebuah jarak (float), mengembalikan titik (atau titik terdekat) dalam geometri (LineString atau MultiLineString) pada jarak itu. Versi biasa mengambil jarak sebagai sebuah float diantara 0 (asli) dan 1 (titik akhir).
Membalikkan dari GEOSGeometry.project().
Mengembalikan GEOSGeometry mewakili titik-titik dibgi oleh geometri ini dan lainnya.
Mengembalikan jarak (float) dari asli geometri (LineString atau MultiLineString) ke titik diproyeksikan pada geometri (yaitu pada titik dari baris terdekat pada titik yang diberikan). Versi biasa mengembalikan jarak sebagai sebuah float diantara 0 (asli) dan 1 (titik akhir).
Membalikkan dari GEOSGeometry.interpolate().
Mengembalikan matriks (string) persimpangan DE-9IM mewakili hubungan topologi diantara geometri ini dan lainnya.
\nMengembalikan sebuah GEOSGeometry baru, disederhanakan pada toleransi yang ditentukan menggunakan algoritma Douglas-Peucker. Nilai toleransi lebih tinggi mengartikan sedikit titik dalam keluaran. Jika toleransi tidak disediakan, awalan itu pada 0.
Secara awalan, fungsi ini tidak mempertahankan topologi. Sebagai contoh, obyek-obyek Polygon dapat dipisah, dirobohkan menjadi baris-baris, atau hilang. Lubang-lubang Polygon dapat dibuat atau hilang, dan baris-baris mungkin bersilangan. Dengan menentukan preserve_topology=True, hasil akan mempunyai dimensi sama dan jumlah komponen sebagai masukan; ini secara signifikan lebih lama, bagaimanapun.
Mengembalikan GEOSGeometry menggabungkan titik-titik dalam geometri ini bukan yang lain, dan titik-titik di lainnya bukan dalam geometri ini.
Mengembalikan GEOSGeometry mewakili semua titik dalam geometri ini dan lainnya.
Mengembalikan batasan sebagai sebuah obyek Geometri baru dialokasikan.
\nMengembalikan obyek Point mewakili pusat geometri dari geometri. Titik tidak menjamin menjadi interior dari geometri.
Mengembalikan Polygon terkecil yang mengandung semua titik dalam geometri.
Mengembalikan sebuah Polygon yang meakili batasan bungkus dari geometri. Catat bahwa itu dapat juga mengembalikan sebuah Point jika masukan geometri adalah sebuah titik.
Menghitung dan mengembalikan jaminan Point untuk berada dalam interior dari geometri ini.
Menghitung gabungan dari semua unsur dari geometri ini.
\nHasil mematuhi kontrak berikut:
\nUnioning a set of LineStrings has the effect of fully noding and\ndissolving the linework.
Menyatukan kumpulan dari Polygon akan selalu mengembalikan geometri Polygon atau MultiPolygon (tidak seperti GEOSGeometry.union(), yang mungkin mengembalikan geometri dari dimensi terendah jika topologi runtuh timbul).
Sifat ini mengembalikan kawasan dari Geometri.
\nSifat ini mengembalikan jangkauan dari geometri ini sebagai 4-tuple, terdiri dari (xmin, ymin, xmax, ymax).
Metode ini mengembalikan GEOSGeometry yaitu sebuah kloningan dari asli.
Mengembalikan jarak diantara titik-titik terdekat pada geometri ini dan geom yang diberikan (obyek GEOSGeometry lain).
Mengembalikan panjang dari geometri (misalnya, 0 untuk sebuah Point, panjang dari sebuah LineString, atau lingkaran dari sebuah Polygon).
Mengembalikan PreparedGeometry GEOS untuk isi dari geometri ini. Obyek-obyek PreparedGeometry dioptimalkan untuk mengandung, bersimpangan, menutupi, bersilangan, menguraikan, tumpang tindih, menyentuh dan dalam tindakan-tindakan. Mengacu pada dokumentasi Prepared Geometry untuk informasi lebih.
Mengembalikan obyek SpatialReference yang sesuai pada SRID dari geometri atau None.
Transforms the geometry according to the given coordinate transformation\nparameter (ct), which may be an integer SRID, spatial reference WKT\nstring, a PROJ string, a SpatialReference\nobject, or a CoordTransform object. By\ndefault, the geometry is transformed in-place and nothing is returned.\nHowever if the clone keyword is set, then the geometry is not modified\nand a transformed clone of the geometry is returned instead.
Merubah geometri ini menjadi bentuk resmi:
\n>>> g = MultiPoint(Point(0, 0), Point(2, 2), Point(1, 1))\n>>> print(g)\nMULTIPOINT (0 0, 2 2, 1 1)\n>>> g.normalize()\n>>> print(g)\nMULTIPOINT (2 2, 1 1, 0 0)\nPointLink to this heading#Obyek point dipakai menggunakan argumen-argumen yang mewakili komponen kordinat dari titik atau dengan kordinat urutan tunggal. Sebagai contoh, berikut adalah setara:
>>> pnt = Point(5, 23)\n>>> pnt = Point([5, 23])\nObyek-obyek Point Empty mungkin dipakai dengan melewatkan tidak ada argumen atau urutan kosong. Berikut adalah setara:
>>> pnt = Point()\n>>> pnt = Point([])\nLineStringLink to this heading#Obyek-obyek LineString dipakai menggunakan argumen-argumen yang baik urutan dari kordinat atau obyek Point. Sebagai contoh, berikut adalah setara:
>>> ls = LineString((0, 0), (1, 1))\n>>> ls = LineString(Point(0, 0), Point(1, 1))\nSebagai tambahahan, obyek LineString mungkin juga dibuat dengan melewatkan dalam urutan tunggal dari kordinat atau obyek Point.
>>> ls = LineString( ((0, 0), (1, 1)) )\n>>> ls = LineString( [Point(0, 0), Point(1, 1)] )\nObyek-obyek LineString Empty mungkin dipakai dengan melewatkan tidak ada argumen atau urutan kosong. Berikut adalah setara:
>>> ls = LineString()\n>>> ls = LineString([])\nMengembalikan apakah atau tidak LineString ini ditutup.
LinearRingLink to this heading#Obyek-obyek LinearRing dibangun dalam cara sama yang tepat seperti obyek-obyek LineString, bagaimanapun kordinat-kordinat harus tertutup, dengan kata lain, kordinat pertama harus sama seperti kordinat terakhir. Sebagai contoh:
>>> ls = LinearRing((0, 0), (0, 1), (1, 1), (0, 0))\nPerhatikan bahwa (0, 0) adalah kordinat pertama dan terakhir -- jika mereka tidak setara, sebuah kesalahan akan dimunculkan.
Returns whether this LinearRing is counterclockwise.
PolygonLink to this heading#Obyek-obyek Polygon mungkin digunakan dengan melewatkan parameter yang mewakili lingkaran dari poligon. Parameters harus berupa salah satu instance LinearRing, atau urutan yang mungkin digunakan untuk membangun sebuah LinearRing:
>>> ext_coords = ((0, 0), (0, 1), (1, 1), (1, 0), (0, 0))\n>>> int_coords = ((0.4, 0.4), (0.4, 0.6), (0.6, 0.6), (0.6, 0.4), (0.4, 0.4))\n>>> poly = Polygon(ext_coords, int_coords)\n>>> poly = Polygon(LinearRing(ext_coords), LinearRing(int_coords))\nMengembalikan sebuah obyek poligon dari kotak-dikelilingi diberikan, 4-tuple meliputi (xmin, ymin, xmax, ymax).
Mengembalikan sejumlah lingkaran interior di geometri ini.
\nMultiPointLink to this heading#Obyek-obyek MultiPoint mungkin digunakan dengan melewatkan obyek-obyek Point sebagai argumen, atau urutan tunggal dari obyek-obyek Point:
>>> mp = MultiPoint(Point(0, 0), Point(1, 1))\n>>> mp = MultiPoint( (Point(0, 0), Point(1, 1)) )\nMultiLineStringLink to this heading#Obyek-obyek MultiLineString mungkin digunakan dengan melewatkan dalam obyek-obyek LineString sebagai argumen, atau urutan tunggal dari obyek-obyek LineString:
>>> ls1 = LineString((0, 0), (1, 1))\n>>> ls2 = LineString((2, 2), (3, 3))\n>>> mls = MultiLineString(ls1, ls2)\n>>> mls = MultiLineString([ls1, ls2])\nMengembalikan sebuah LineString mewakili baris menggabungkan semua komponen di MultiLineString ini.
Returns True if and only if all elements are closed.
MultiPolygonLink to this heading#Obyek-obyek MultiPolygon mungkin digunakan dengan melewatkan obyek-obyek Polygon sebagai argumen, atau urutan tunggal dari obyek-obyek Polygon:
>>> p1 = Polygon( ((0, 0), (0, 1), (1, 1), (0, 0)) )\n>>> p2 = Polygon( ((1, 1), (1, 2), (2, 2), (1, 1)) )\n>>> mp = MultiPolygon(p1, p2)\n>>> mp = MultiPolygon([p1, p2])\nGeometryCollectionLink to this heading#Obyek-obyek GeometryCollection mungkin digunakan dengan melewatkan GEOSGeometry lain sebagai argumen, atau urutan tunggal dari obyek-obyek GEOSGeometry:
>>> poly = Polygon( ((0, 0), (0, 1), (1, 1), (0, 0)) )\n>>> gc = GeometryCollection(Point(0, 0), MultiPoint(Point(0, 0), Point(1, 1)), poly)\n>>> gc = GeometryCollection((Point(0, 0), MultiPoint(Point(0, 0), Point(1, 1)), poly))\nIn order to obtain a prepared geometry, access the\nGEOSGeometry.prepared property. Once you have a\nPreparedGeometry instance its spatial predicate methods, listed below,\nmay be used with other GEOSGeometry objects. An operation with a prepared\ngeometry can be orders of magnitude faster -- the more complex the geometry\nthat is prepared, the larger the speedup in the operation. For more information,\nplease consult the GEOS wiki page on prepared geometries.
Sebagai contoh:
\n>>> from django.contrib.gis.geos import Point, Polygon\n>>> poly = Polygon.from_bbox((0, 0, 5, 5))\n>>> prep_poly = poly.prepared\n>>> prep_poly.contains(Point(2.5, 2.5))\nTrue\nPreparedGeometryLink to this heading#Semua metode pada PreparedGeometry mengambil sebuah argumen other, yang harus berupa instance GEOSGeometry.
file_h (a Python file object or a string path to the file) -- masukan berkas yang mengandung data spasial
GEOSGeometry berhubungan ke data spasial dalam berkas
Contoh:
\n>>> from django.contrib.gis.geos import fromfile\n>>> g = fromfile('/home/bob/geom.wkt')\nGEOSGeometry terkait pada data spasial di deretan karakter
fromstr(string, srid) setara dengan GEOSGeometry(string, srid).
Contoh:
\n>>> from django.contrib.gis.geos import fromstr\n>>> pnt = fromstr('POINT(-90.5 29.5)', srid=4326)\nThe reader I/O classes return a GEOSGeometry instance from the WKB\nand/or WKT input given to their read(geom) method.
Contoh:
\n>>> from django.contrib.gis.geos import WKBReader\n>>> wkb_r = WKBReader()\n>>> wkb_r.read('0101000000000000000000F03F000000000000F03F')\n<Point object at 0x103a88910>\nContoh:
\n>>> from django.contrib.gis.geos import WKTReader\n>>> wkt_r = WKTReader()\n>>> wkt_r.read('POINT(1 1)')\n<Point object at 0x103a88b50>\nSemua penulis obyek-obyek memiliki sebuah metode write(geom) yang mengembalikan salah satu WKB atau WKT dari geometri diberikan. Sebagai tambahan, obyek-obyek WKBWriter juga memiliki sifat yang mungkin digunakan untuk merubah urutan byte, dan atau menyertakan nilai SRID (dengan kata lain, EWKB).
WKBWriter menyediakan kendali kebanyakan terhadap keluarannya. Secara awalan itu mengembalikan WKB sesuai-OGC ketika metode write nya dipanggil. Bagaimanapun, itu mempunyai sifat yang mengizinkan untuk pembuatan dari EWKB, sebuah superset dari standar WKB yang menyertakan informasi tambahan. Lihat dokumentasi WKBWriter.outdim untuk lebih rinci tentang argumen dim.
Mengembalikan WKB dari geometri yang diberikan sebagai obyek buffer Python. Contoh:
>>> from django.contrib.gis.geos import Point, WKBWriter\n>>> pnt = Point(1, 1)\n>>> wkb_w = WKBWriter()\n>>> wkb_w.write(pnt)\n<read-only buffer for 0x103a898f0, size -1, offset 0 at 0x103a89930>\nMengembalikan WKB dari geometri di heksadesimal. Contoh:
\n>>> from django.contrib.gis.geos import Point, WKBWriter\n>>> pnt = Point(1, 1)\n>>> wkb_w = WKBWriter()\n>>> wkb_w.write_hex(pnt)\n'0101000000000000000000F03F000000000000F03F'\nMilik ini mungkin disetel untuk merubah urutan-byte dari perwakilan geometri.
\nNilai Byteorder | \nDeskripsi | \n
|---|---|
0 | \nBig Endian (misalnya, cocok dengan sistem RISC) | \n
1 | \nLittle Endian (misalnya, cocok dengan sistem x86) | \n
Contoh:
\n>>> from django.contrib.gis.geos import Point, WKBWriter\n>>> wkb_w = WKBWriter()\n>>> pnt = Point(1, 1)\n>>> wkb_w.write_hex(pnt)\n'0101000000000000000000F03F000000000000F03F'\n>>> wkb_w.byteorder = 0\n'00000000013FF00000000000003FF0000000000000'\nSifat ini mungkin disetel untuk merubah dimensi keluaran dari perwakilan geometri. Dengan kata lain, jika anda memiliki geometri 3D kemudian disetel menjadi 3 sehingga nilai Z disertakan dalam WKB.
\nNilai Outdim | \nDeskripsi | \n
|---|---|
2 | \nAwalan, keluaran 2D WKB. | \n
3 | \nKeluaran 3D WKB. | \n
Contoh:
\n>>> from django.contrib.gis.geos import Point, WKBWriter\n>>> wkb_w = WKBWriter()\n>>> wkb_w.outdim\n2\n>>> pnt = Point(1, 1, 1)\n>>> wkb_w.write_hex(pnt) # By default, no Z value included:\n'0101000000000000000000F03F000000000000F03F'\n>>> wkb_w.outdim = 3 # Tell writer to include Z values\n>>> wkb_w.write_hex(pnt)\n'0101000080000000000000F03F000000000000F03F000000000000F03F'\nSetel sifat ini dengan sebuah boolean untuk menunjukkan apakah SRID dari geometri harus disertakan dengan perwakilan WKB.
\n>>> from django.contrib.gis.geos import Point, WKBWriter\n>>> wkb_w = WKBWriter()\n>>> pnt = Point(1, 1, srid=4326)\n>>> wkb_w.write_hex(pnt) # By default, no SRID included:\n'0101000000000000000000F03F000000000000F03F'\n>>> wkb_w.srid = True # Tell writer to include SRID\n>>> wkb_w.write_hex(pnt)\n'0101000020E6100000000000000000F03F000000000000F03F'\nKelas ini mengeizinkan pengeluaran perwakilan WKT dari geometri. Lihat atribut WKBWriter.outdim, trim, dan precision untuk rincian tentang argumen pembangun.
Mengembalikan WKT dari geometri diberikan. Contoh:
\n>>> from django.contrib.gis.geos import Point, WKTWriter\n>>> pnt = Point(1, 1)\n>>> wkt_w = WKTWriter()\n>>> wkt_w.write(pnt)\n'POINT (1.0000000000000000 1.0000000000000000)'\nLihat WKBWriter.outdim.
Sifat ini digunakan untuk mengadakan atau meniadakan memangkas dari desimal yang tidak diperlukan.
\n>>> from django.contrib.gis.geos import Point, WKTWriter\n>>> pnt = Point(1, 1)\n>>> wkt_w = WKTWriter()\n>>> wkt_w.trim\nFalse\n>>> wkt_w.write(pnt)\n'POINT (1.0000000000000000 1.0000000000000000)'\n>>> wkt_w.trim = True\n>>> wkt_w.write(pnt)\n'POINT (1 1)'\nSifat ini mengendalikan ketelitian pembulatan dari kordinat; jika disetel menjadi None pembulatan adalah ditiadakan.
>>> from django.contrib.gis.geos import Point, WKTWriter\n>>> pnt = Point(1.44, 1.66)\n>>> wkt_w = WKTWriter()\n>>> print(wkt_w.precision)\nNone\n>>> wkt_w.write(pnt)\n'POINT (1.4399999999999999 1.6599999999999999)'\n>>> wkt_w.precision = 0\n>>> wkt_w.write(pnt)\n'POINT (1 2)'\n>>> wkt_w.precision = 1\n>>> wkt_w.write(pnt)\n'POINT (1.4 1.7)'\nCatatan kaki
\n\nGEOS_LIBRARY_PATHLink to this heading#Sebuah string menentukan tempat dari pustaka C GEOS. Khususnya, pengaturan ini hanya digunakan jika pustaka C GEOS adalah di tempat bukan-standar (misalnya, /home/bob/lib/libgeos_c.so).
Pengecualian GEOS dasar, menunjukkan kesalahan terkait-GEOS.
\n