I allmänhet kräver installationen av GeoDjango:
\nspatial_databas
Detaljer för varje krav och installationsanvisningar finns i avsnitten nedan. Dessutom finns plattformsspecifika instruktioner tillgängliga för:
\nfönster
Eftersom GeoDjango ingår i Django hänvisar vi till Djangos installationsinstruktioner för mer information om hur du installerar.
\nPostgreSQL (med PostGIS), MySQL, Oracle och SQLite (med SpatiaLite) är de spatiala databaser som för närvarande stöds.
\n\nThe geospatial libraries required for a GeoDjango installation depends\non the spatial database used. The following lists the library requirements,\nsupported versions, and any notes for each of the supported database backends:
\nDatabas | \nKrav på bibliotek | \nVersioner som stöds | \nAnteckningar | \n
|---|---|---|---|
PostgreSQL | \nGEOS, GDAL, PROJ, PostGIS | \n14+ | \nKräver PostGIS. | \n
MySQL | \nGEOS, GDAL | \n8.0.11+ | \n\n |
Oracle | \nGEOS, GDAL | \n19+ | \nXE stöds inte. | \n
SQLite | \nGEOS, GDAL, PROJ, SpatiaLite | \n3.31.0+ | \nKräver SpatiaLite 4.3+ | \n
Se även `den här jämförelsematrisen`__ på OSGeo Wiki för PostgreSQL / PostGIS /GEOS / GDAL möjliga kombinationer.
\nDATABASER konfigurationLink to this heading#Ange inställningen ENGINE till en av spatial backends.
django.contrib.gis i INSTALLED_APPSLink to this heading#Precis som andra Django Contrib-applikationer behöver du bara lägga till django.contrib.gis till INSTALLED_APPS i dina inställningar. Detta är så att gis-mallarna kan lokaliseras - om det inte görs kommer funktioner som den geografiska administratören eller KML-webbplatskartor inte att fungera korrekt.
Om du inte hittar lösningen på ditt problem här kan du delta i gemenskapen! Detta kan du göra:
\nStäll din fråga på forumet `GeoDjango`__.
File a ticket on the `Django trac`__ if you think there’s a bug. Make\nsure to provide a complete description of the problem, versions used,\nand specify the component as ”GIS”.
Det överlägset vanligaste problemet vid installation av GeoDjango är att de externa delade biblioteken (t.ex. för GEOS och GDAL) inte kan hittas. [Orsaken till detta problem är vanligtvis att operativsystemet inte känner till den katalog där biblioteken som byggts från källan installerades.
\nI allmänhet kan bibliotekssökvägen ställas in för varje användare genom att ange en miljövariabel eller genom att konfigurera bibliotekssökvägen för hela systemet.
\nLD_LIBRARY_PATHLink to this heading#A user may set this environment variable to customize the library paths\nthey want to use. The typical library directory for software\nbuilt from source is /usr/local/lib. Thus, /usr/local/lib needs\nto be included in the LD_LIBRARY_PATH variable. For example, the user\ncould place the following in their bash profile:
export LD_LIBRARY_PATH=/usr/local/lib\nOn GNU/Linux systems, there is typically a file in /etc/ld.so.conf, which\nmay include additional paths from files in another directory, such as\n/etc/ld.so.conf.d. As the root user, add the custom library path (like\n/usr/local/lib) on a new line in ld.so.conf. This is one example of\nhow to do so:
$ sudo echo /usr/local/lib >> /etc/ld.so.conf\n$ sudo ldconfig\nFor OpenSolaris users, the system library path may be modified using the\ncrle utility. Run crle with no options to see the current configuration\nand use crle -l to set with the new library path. Be very careful when\nmodifying the system library path:
# crle -l $OLD_PATH:/usr/local/lib\nbinutilsLink to this heading#GeoDjango uses the find_library function (from the ctypes.util Python\nmodule) to discover libraries. The find_library routine uses a program\ncalled objdump (part of the binutils package) to verify a shared\nlibrary on GNU/Linux systems. Thus, if binutils is not installed on your\nLinux system then Python’s ctypes may not be able to find your library even if\nyour library path is set correctly and geospatial libraries were built\nperfectly.
Paketet binutils kan installeras på Debian- och Ubuntu-system med följande kommando:
$ sudo apt-get install binutils\nPå samma sätt på Red Hat- och CentOS-system:
\n$ sudo yum install binutils\nPå grund av de olika paketeringssystemen som finns tillgängliga för macOS har användarna flera olika alternativ för att installera GeoDjango. Dessa alternativ är:
\nPostgres.app (enklast och rekommenderas)
bygga_från_källa
Detta avsnitt innehåller även instruktioner för att installera en uppgraderad version av Python från paket som tillhandahålls av Python Software Foundation, men detta är inte nödvändigt.
\nAlthough macOS comes with Python installed, users can use `framework\ninstallers`__ provided by the Python Software Foundation. An advantage to\nusing the installer is that macOS’s Python will remain ”pristine” for internal\noperating system use.
\n\nPostgres.app is a standalone PostgreSQL server\nthat includes the PostGIS extension. You will also need to install gdal\nwith Hemmabryggare.
När du har installerat Postgres.app lägger du till följande i din .bash_profile så att du kan köra paketets program från kommandoraden. Ersätt X.Y med versionen av PostgreSQL i Postgres.app som du installerade:
export PATH=$PATH:/Applications/Postgres.app/Contents/Versions/X.Y/bin\nDu kan kontrollera om sökvägen är korrekt inställd genom att skriva which psql i en terminalprompt.
`Homebrew`__ tillhandahåller ”recept” för att bygga binära filer och paket från källan. Det ger recept för GeoDjango-förutsättningarna på Macintosh-datorer som kör macOS. Eftersom Homebrew fortfarande bygger programvaran från källan krävs Xcode.
\nSammanfattning:
\n$ brew install postgresql\n$ brew install postgis\n$ brew install gdal\n`Kurt Schwehr`__ har varit snäll nog att skapa GeoDjango-paket för användare av `Fink`__-paketsystemet. olika paket finns tillgängliga (börjar med django-gis), beroende på vilken version av Python du vill använda.
`MacPorts`__ may be used to install GeoDjango prerequisites on computers\nrunning macOS. Because MacPorts still builds the software from source,\nXcode is required.
\nSammanfattning:
\n$ sudo port install postgresql14-server\n$ sudo port install geos\n$ sudo port install proj6\n$ sudo port install postgis3\n$ sudo port install gdal\nFortsätt genom följande avsnitt i tur och ordning för att installera GeoDjango på Windows. I denna handledning kommer vi att installera 64-bitarsversioner av varje applikation.
\nInstallera en 64-bitarsversion av Python. Se Installera Python för ytterligare information.
\nDownload the latest `PostgreSQL 15.x installer`__ from the\n`EnterpriseDB`__ website. After downloading, run the installer, follow the\non-screen directions, and keep the default options unless you know the\nconsequences of changing them.
\n\nNär installationsprogrammet är klart kommer det att fråga om ”Launch Stack Builder at exit?” – håll detta markerat, eftersom det är nödvändigt att installera PostGIS.
\n\nFrån Stack Builder (för att köra utanför installationsprogrammet, ), välj från rullgardinsmenyn och klicka på nästa. Expandera menyträd och välj .
\nNär du har klickat på nästa uppmanas du att bekräfta det valda paketet och ”Download directory”. Klicka på nästa igen, detta kommer att ladda ner PostGIS och du kommer att bli ombedd att klicka på nästa för att starta PostGIS-installationsprogrammet. Välj standardalternativ under installationen. Installationsprocessen innehåller fyra Ja/Nej-dialogrutor, standardalternativet för alla fyra är ”Nej”.
\nThe OSGeo4W installer helps to install the PROJ, GDAL, and GEOS libraries\nrequired by GeoDjango. First, download the OSGeo4W installer, and\nrun it. Select and click next. In the\n’Select Packages’ list, ensure that GDAL is selected. If any other packages are\nenabled by default, they are not required by GeoDjango and may be unchecked\nsafely. After clicking next and accepting the license agreements, the packages\nwill be automatically downloaded and installed, after which you may exit the\ninstaller.
\nIn order to use GeoDjango, you will need to add your OSGeo4W\ndirectories to your Windows system Path, as well as create GDAL_DATA\nand PROJ_LIB environment variables. The following set of commands,\nexecutable with cmd.exe, will set this up. Restart your device\nonce this is complete for new environment variables to be recognized:
set OSGEO4W_ROOT=C:\\OSGeo4W\nset GDAL_DATA=%OSGEO4W_ROOT%\\apps\\gdal\\share\\gdal\nset PROJ_LIB=%OSGEO4W_ROOT%\\share\\proj\nset PATH=%PATH%;%OSGEO4W_ROOT%\\bin\nreg ADD "HKLM\\SYSTEM\\CurrentControlSet\\Control\\Session Manager\\Environment" /v Path /t REG_EXPAND_SZ /f /d "%PATH%"\nreg ADD "HKLM\\SYSTEM\\CurrentControlSet\\Control\\Session Manager\\Environment" /v GDAL_DATA /t REG_EXPAND_SZ /f /d "%GDAL_DATA%"\nreg ADD "HKLM\\SYSTEM\\CurrentControlSet\\Control\\Session Manager\\Environment" /v PROJ_LIB /t REG_EXPAND_SZ /f /d "%PROJ_LIB%"\nInstallera Django på ditt system. Det rekommenderas att du skapar en virtuell miljö för varje projekt du skapar.
\nPython-modulen `` psycopg`` tillhandahåller gränssnittet mellan Python och PostgreSQL-databasen. psycopg kan installeras via pip inom din virtuella Python-miljö:
...\\> py -m pip install psycopg\nFotnoter
\n\n