--- title: "Memasang pustaka Geospatial" version: 2.2 locale: id source: https://docs.djangoproject.com/id/2.2/ref/contrib/gis/install/geolibs/ canonical: https://djangodocs.dev/id/2.2/ref/contrib/gis/install/geolibs/ --- # Memasang pustaka Geospatial GeoDjango menggunakan dan/atau menyediakan antarmuka untuk pustaka geospatial sumber terbuka berikut: | Program | Deskripsi | Dibutuhkan | Versi Didukung | | --- | --- | --- | --- | | [GEOS](/id/2.2/ref/contrib/gis/geos/) | Geometry Engine Open Source | Ya | 3.7, 3.6, 3.5, 3.4 | | [PROJ.4](https://github.com/OSGeo/proj.4/wiki/) | Pustaka Cartographic Projections | Ya (hanya PostgreSQL dan SQLite ) | 5.2, 5.1, 5.0, 4.x | | [GDAL](/id/2.2/ref/contrib/gis/gdal/) | Pustaka Abstrak Data Geospatial | Ya | 2.3, 2.2, 2.1, 2.0, 1.11 | | [GeoIP](/id/2.2/ref/contrib/gis/geoip2/) | Pustaka geolokasi berdasarkan-IP | Tidak | 2 | | [PostGIS](https://postgis.net/) | Tambahan spasial untuk PostgreSQL | Ya (hanya PostgreSQL) | 2.5, 2.4, 2.3, 2.2, 2.1 | | [SpatiaLite](https://www.gaia-gis.it/gaia-sins/) | Tambahan spasial untuk SQLite | Ya (hanya SQLite ) | 4.3, 4.2, 4.1 | Catat bahwa terlama atau lebih versi saat ini dari pustaka-pustaka ini *mungkin* juga bekerja sepenuhnya baik dengan GeoDjango. Jarak tempuh anda mungkin beragam. > **Note** > > Antarmuka GeoDjango pada GEOS, GDAL, dan GeoIP mungkin digunakan secara berdisi sendiri dari Django. Dengan kata lain, tidak ada basisdata atau berkas pengaturan dibutuhkan -- cukup mengimpor mereka seperti biasanya dari [`django.contrib.gis`](/id/2.2/ref/contrib/gis/#module-django.contrib.gis). Pada Debian/Ubuntu, anda disarankan memasang paket-paket berikut yang akan memasang, secara langsung atau secara terpisah, pustaka-pustaka geospasial yang dibutuhkan: ```console $ sudo apt-get install binutils libproj-dev gdal-bin ``` Harap juga rundingkan petunjuk serambi-spesifik jika anda berada pada [macOS](/id/2.2/ref/contrib/gis/install/#macos) atau [Windows](/id/2.2/ref/contrib/gis/testing/#windows). ## Membangun dari sumber Ketika memasang dari sumber pada sistem UNIX dan GNU/Linux, harap ikuti petunjuk pemakaian dengan hati-hati, dan pasang pustaka-pustaka dalam urutan yang diberikan. Jika menggunakan MySQL atau Oracle sebagai basisdata spasial, hanya GEOS dibutuhkan. > **Note** > > Pada serambi Linux, itu mungkin sangat diperlukan menjalankan perintah `ldconfig` setelah memasang setiap pustaka. Sebagai contoh: > > ``` > $ sudo make install > $ sudo ldconfig > ``` > **Note** > > Pengguna macOS harus memasang Xcode\`\_ untuk menyusun perangkat lunak dari sumber. ### GEOS GEOS adalah sebuah pustaka C++ untuk melakukan tindakan geometrik, dan adalah pewakilan geometri internal awalan digunakan oleh GeoDjango (itu dibelakang geometri "lazy"). Khususnya, pustaka API C dipanggil (misalnya, `libgeos_c.so`) langsung dari Python menggunakan ctype. Pertama, unduh GEOS dari situs jaringan GEOS dan keluarkan arsip sumber: ``` $ wget https://download.osgeo.org/geos/geos-X.Y.Z.tar.bz2 $ tar xjf geos-X.Y.Z.tar.bz2 ``` Selanjutnya, rubah kedalam direktori dimana GEOS dibuka, jalankan tulisan konfigurasi, susun, dan pasang: ``` $ cd geos-X.Y.Z $ ./configure $ make $ sudo make install $ cd .. ``` #### Menyelesaikan masalah ##### Tidak dapat menemukan pustaka GEOS Ketika GeoDjango tidak dapat menemukan GEOS, kesalahan ini akan muncul: ```text ImportError: Could not find the GEOS library (tried "geos_c"). Try setting GEOS_LIBRARY_PATH in your settings. ``` Pemecahan paling umum adalah dengan benar mengkonfigurasi [Pustaka pengaturan lingkungan](/id/2.2/ref/contrib/gis/install/#libsettings) anda *atau* menyetel [GEOS\_LIBRARY\_PATH](#geoslibrarypath) di pengaturan anda. Jika menggunakan paket biner dari GEOS (misalnya, pada Ubuntu), anda mungkin butuh untuk [Pasang binutils](/id/2.2/ref/contrib/gis/install/#binutils). ##### `GEOS_LIBRARY_PATH` Jika pustaka GEOS anda berada dalam tempat bukan-standar, atau anda tidak ingin merubah jalur pustaka sistem kemudian pengaturan [`GEOS_LIBRARY_PATH`](/id/2.2/ref/contrib/gis/geos/#std-setting-GEOS_LIBRARY_PATH) mungkin ditambahkan ke berkas pengaturan Django anda dengan jalur penuh pada pustaka C GEOS. Sebagai contoh: ``` GEOS_LIBRARY_PATH = '/home/bob/local/lib/libgeos_c.so' ``` > **Note** > > Pengaturan harus berupa jalur *penuh* pada pustaka berbagi *C*; dengan kata lain anda ingin menggunakan `libgeos_c.so`, bukan `libgeos.so`. Lihat juga [Catatan saya diisi dengan kesalahan terkait GEOS](/id/2.2/ref/contrib/gis/geos/#geos-exceptions-in-logfile). ### PROJ.4 [PROJ.4](https://github.com/OSGeo/proj.4/wiki/) adalah sebuah pustaka untuk merubah data geospasial menjadi sistem acuan kordinat berbeda. Pertama, unduh kode sumber PROJ.4 dan fakta meindahkan berkas-berkas [^1]: ``` $ wget https://download.osgeo.org/proj/proj-X.Y.Z.tar.gz $ wget https://download.osgeo.org/proj/proj-datumgrid-X.Y.tar.gz ``` Selanjutnya, buka arsip kode sumber, dan keluarkan berkas-berkas pemindahan datum dalam sub direktori `nad`. Ini harus selesai *prior* pada konfigurasi: ``` $ tar xzf proj-X.Y.Z.tar.gz $ cd proj-X.Y.Z/nad $ tar xzf ../../proj-datumgrid-X.Y.tar.gz $ cd .. ``` Akhirnya, konfigurasi, buat dan pasang PROJ.4: ``` $ ./configure $ make $ sudo make install $ cd .. ``` ### GDAL [GDAL](https://trac.osgeo.org/gdal/) adalah sebuah pustaka geospasial sumber terbuka yang luar biasa yang mempunyai dukungan untuk membaca kebanyakan bentuk data vektor dan raster. Saat ini, GeoDjango hanya mendukung [GDAL's vector data](/id/2.2/ref/contrib/gis/gdal/) kemampuan-kemampuan [^2]. [GEOS](#geosbuild) dan [PROJ.4](#proj4) harus dipasang sebelum membangun GDAL. Pertama unduh versi terbitan GDAL terakhir dan keluarkan arsip: ``` $ wget https://download.osgeo.org/gdal/X.Y.Z/gdal-X.Y.Z.tar.gz $ tar xzf gdal-X.Y.Z.tar.gz $ cd gdal-X.Y.Z ``` Konfigurasi, buat dan pasang: ``` $ ./configure $ make # Go get some coffee, this takes a while. $ sudo make install $ cd .. ``` > **Note** > > Karena GeoDjango mempunyai antarmuka Python milik sendiri, petunjuk-petunjuk terdahulu tidak membangun ikatan Python milik sendiri GDAL. Ikatan mungkin dibangun dengan menambahkan bendera `--with-python` ketika menjalankan `configure`. Lihat [GDAL/OGR In Python](https://trac.osgeo.org/gdal/wiki/GdalOgrInPython) untuk informasi lebih pada ikatan GDAL. Jika anda mempunyai masalah apapun, harap melihat bagian penyelesaian masalah dibawah untuk saran dan pemecahan. #### Menyelesaikan masalah ##### Tidak dapat menemukan pustaka GDAL Ketika GeiDjango tidak dapat menemukan pustaka GDAL, konfigurasikan [Pustaka pengaturan lingkungan](/id/2.2/ref/contrib/gis/install/#libsettings) anda *atau* setel [GDAL\_LIBRARY\_PATH](#gdallibrarypath) dalam pengaturan anda. ##### `GDAL_LIBRARY_PATH` Jika pustaka GDAL anda berada di tempat bukan-standar, atau anda tidak ingin merubah jalur pustaka sistem kemudkan pengaturan [`GDAL_LIBRARY_PATH`](/id/2.2/ref/contrib/gis/gdal/#std-setting-GDAL_LIBRARY_PATH) mungkin ditambahkan ke berkas pengaturan Django anda dengan jalur penuh pada pustaka GDAL. Sebagai contoh: ``` GDAL_LIBRARY_PATH = '/home/sue/local/lib/libgdal.so' ``` **Catatan kaki** [^1]: Berkas-berkas bergeser datum dibutuhkan untuk merubah data ke dan dari proyeksi tertentu. Sebagai contoh. String PROJ.4 untuk Google projection (900913 or 3857) \<\>\`\_ membutuhkan hanya berkas jaring `null` disertakan dalam berkas-berkas pergeseran datum tambahan. Itu lebih mudah memasang berkas-berkas pergeseran sekarang, kemudian untuk melakukan pencarian kesalahan sebuah masalah disebabkan oleh ketiadaan mereka kemudian. [^2]: Specifically, GeoDjango provides support for the [OGR](https://gdal.org/user/vector_data_model.html) library, a component of GDAL.