--- title: "Installera geospatiala bibliotek" version: 5.2 locale: sv source: https://docs.djangoproject.com/sv/5.2/ref/contrib/gis/install/geolibs/ canonical: https://djangodocs.dev/sv/5.2/ref/contrib/gis/install/geolibs/ --- # Installera geospatiala bibliotek GeoDjango använder och/eller tillhandahåller gränssnitt för följande geospatiala bibliotek med öppen källkod: | Program | Beskrivning | Obligatorisk | Versioner som stöds | | --- | --- | --- | --- | | [GEOS](/sv/5.2/ref/contrib/gis/geos/) | Geometry Engine Open Source | Ja | 3.13, 3.12, 3.11, 3.10, 3.9, 3.8 | | [PROJ](https://postgis.net/) | Bibliotek för kartografiska projektioner | Ja (endast PostgreSQL och SQLite) | 9.x, 8.x, 7.x, 6.x | | [GDAL](/sv/5.2/ref/contrib/gis/gdal/) | Bibliotek för abstraktion av geospatiala data | Ja | 3.10, 3.9, 3.8, 3.7, 3.6, 3.5, 3.4, 3.3, 3.2, 3.1 | | [GeoIP](/sv/5.2/ref/contrib/gis/geoip2/) | IP-baserat bibliotek för geolokalisering | Nej | 2 | | PostGIS\`\_\_\_\_ | Rumsliga tillägg för PostgreSQL | Ja (endast PostgreSQL) | 3.4, 3.3, 3.2, 3.1 | | [SpatiaLite](https://www.gaia-gis.it/gaia-sins/) | Spatiala tillägg för SQLite | Ja (endast SQLite) | 5.1, 5.0, 4.3 | Observera att äldre eller nyare versioner av dessa bibliotek *kan* också fungera helt bra med GeoDjango. Din körsträcka kan variera. > **Note** > > GeoDjango-gränssnitten till GEOS, GDAL och GeoIP kan användas oberoende av Django. Med andra ord, ingen databas eller inställningsfil krävs - importera dem som vanligt från [`django.contrib.gis`](/sv/5.2/ref/contrib/gis/#module-django.contrib.gis). På Debian/Ubuntu rekommenderas att du installerar följande paket som installerar, direkt eller genom beroenden, de nödvändiga geospatiala biblioteken: ```console $ sudo apt-get install binutils libproj-dev gdal-bin ``` Se även plattformsspecifika instruktioner om du använder [macOS](/sv/5.2/ref/contrib/gis/install/#macos) eller [Fönster](/sv/5.2/ref/contrib/gis/install/#windows). ## Bygga från källan Vid installation från källkod på UNIX- och GNU/Linux-system, följ installationsanvisningarna noggrant och installera biblioteken i angiven ordning. Om du använder MySQL eller Oracle som spatial databas krävs endast GEOS. > **Note** > > På Linux-plattformar kan det vara nödvändigt att köra kommandot `ldconfig` efter att varje bibliotek har installerats. Ett exempel: > > ```shell > $ sudo make install > $ sudo ldconfig > ``` > **Note** > > macOS-användare måste installera [Xcode](https://developer.apple.com/xcode/) för att kunna kompilera programvara från källan. ### GEOS GEOS är ett C++-bibliotek för att utföra geometriska operationer och är den interna standardgeometrirepresentationen som används av GeoDjango (den ligger bakom de ”lata” geometrierna). Specifikt anropas C API-biblioteket (t.ex. `libgeos_c.so`) direkt från Python med hjälp av ctypes. Först laddar du ner GEOS från GEOS webbplats och avtar källarkivet: ```shell $ wget https://download.osgeo.org/geos/geos-X.Y.Z.tar.bz2 $ tar xjf geos-X.Y.Z.tar.bz2 ``` Gå sedan in i GEOS-katalogen, skapa en `build`-mapp och gå in i den: ```shell $ cd geos-X.Y.Z $ mkdir build $ cd build ``` Bygg sedan och installera paketet: ```shell $ cmake -DCMAKE_BUILD_TYPE=Release .. $ cmake --build . $ sudo cmake --build . --target install ``` #### Felsökning ##### Kan inte hitta GEOS-biblioteket När GeoDjango inte kan hitta GEOS utlöses detta fel: ```text ImportError: Could not find the GEOS library (tried "geos_c"). Try setting GEOS_LIBRARY_PATH in your settings. ``` Den vanligaste lösningen är att korrekt konfigurera din [Inställningar för biblioteksmiljö](/sv/5.2/ref/contrib/gis/install/#libsettings) *eller* ange [GEOS\_BIBLIOTEK\_ SÖKVÄG](#geoslibrarypath) i dina inställningar. Om du använder ett binärt paket av GEOS (t.ex. på Ubuntu) kan du behöva [Installera binutils](/sv/5.2/ref/contrib/gis/install/#binutils). ##### `GEOS_BIBLIOTEK_ SÖKVÄG` Om ditt GEOS-bibliotek finns på en plats som inte är standard, eller om du inte vill ändra systemets bibliotekssökväg, kan inställningen [`GEOS_LIBRARY_PATH`](/sv/5.2/ref/contrib/gis/geos/#std-setting-GEOS_LIBRARY_PATH) läggas till i din Django-inställningsfil med den fullständiga sökvägen till GEOS C-biblioteket. Till exempel: ```shell GEOS_LIBRARY_PATH = '/home/bob/local/lib/libgeos_c.so' ``` > **Note** > > Inställningen måste vara den *fullständiga* sökvägen till det delade **C**-biblioteket; med andra ord vill du använda `libgeos_c.so`, inte `libgeos.so`. Se även [Mina loggar är fyllda med GEOS-relaterade fel](/sv/5.2/ref/contrib/gis/geos/#geos-exceptions-in-logfile). ### PROJ [PROJ](https://proj.org/) är ett bibliotek för konvertering av geospatiala data till olika koordinatreferenssystem. Först laddar du ner PROJ-källkoden: ```shell $ wget https://download.osgeo.org/proj/proj-X.Y.Z.tar.gz ``` … och datumskiftningsfiler (ladda ner `proj-datumgrid-X.Y.tar.gz` för PROJ \< 7.x) [^1]: ```shell $ wget https://download.osgeo.org/proj/proj-data-X.Y.tar.gz ``` Ta sedan fram källkodsarkivet och extrahera datumskiftfilerna i underkatalogen `data`. Detta måste göras *förut* för konfigurationen: ```shell $ tar xzf proj-X.Y.Z.tar.gz $ cd proj-X.Y.Z/data $ tar xzf ../../proj-data-X.Y.tar.gz $ cd ../.. ``` För PROJ 9.x och senare stöder utgåvorna endast byggande med `CMake` (se [PROJ RFC-7](https://proj.org/community/rfc/rfc-7.html#rfc7)). För att bygga med `CMake` måste du se till att ditt system uppfyller [build requirements](https://proj.org/install.html#build-requirements). Skapa sedan en `build`-mapp i PROJ-katalogen och gå in i den: ```shell $ cd proj-X.Y.Z $ mkdir build $ cd build ``` Slutligen ska du konfigurera, skapa och installera PROJ: ```shell $ cmake .. $ cmake --build . $ sudo cmake --build . --target install ``` ### GDAL [GDAL](https://gdal.org/) är ett utmärkt geospatialt bibliotek med öppen källkod som har stöd för att läsa de flesta vektor- och rasterformat för spatiala data. För närvarande stöder GeoDjango endast [GDAL:s vektordata](/sv/5.2/ref/contrib/gis/gdal/)-funktioner [^2]. [GEOS](#geosbuild) och [PROJ](#proj4) bör installeras innan GDAL byggs. Ladda först ner den senaste versionen av GDAL och öppna arkivet: ```shell $ wget https://download.osgeo.org/gdal/X.Y.Z/gdal-X.Y.Z.tar.gz $ tar xzf gdal-X.Y.Z.tar.gz ``` För GDAL 3.6.x och senare stöder utgåvorna endast byggande med `CMake`. Om du vill bygga med `CMake` skapar du en `build`-mapp i GDAL-katalogen och går in i den: ```shell $ cd gdal-X.Y.Z $ mkdir build $ cd build ``` Slutligen ska du konfigurera, skapa och installera GDAL: ```shell $ cmake .. $ cmake --build . $ sudo cmake --build . --target install ``` Om du har några problem, se felsökningsavsnittet nedan för förslag och lösningar. #### Felsökning ##### Hittar inte GDAL-biblioteket När GeoDjango inte kan hitta GDAL-biblioteket, konfigurera din [Inställningar för biblioteksmiljö](/sv/5.2/ref/contrib/gis/install/#libsettings) *eller* ange [GDAL\_BIBLIOTEK\_VÄG](#gdallibrarypath) i dina inställningar. ##### `GDAL_BIBLIOTEK_VÄG` Om ditt GDAL-bibliotek finns på en plats som inte är standard, eller om du inte vill ändra systemets bibliotekssökväg, kan inställningen [`GDAL_LIBRARY_PATH`](/sv/5.2/ref/contrib/gis/gdal/#std-setting-GDAL_LIBRARY_PATH) läggas till i din Django-inställningsfil med den fullständiga sökvägen till GDAL-biblioteket. Till exempel: ```shell GDAL_LIBRARY_PATH = '/home/sue/local/lib/libgdal.so' ``` **Fotnoter** [^1]: Datumskiftesfilerna behövs för att konvertera data till och från vissa projektioner. PROJ-strängen för [Google-projektionen (900913 eller 3857)](https://spatialreference.org/ref/epsg/3857/) kräver t.ex. gridfilen `null` som endast ingår i de extra datumskiftfilerna. Det är lättare att installera skiftfilerna nu än att behöva felsöka ett problem som orsakas av att de saknas senare. [^2]: GeoDjango ger specifikt stöd för biblioteket [OGR](https://gdal.org/user/vector_data_model.html), en komponent i GDAL.