{"title":"Suiteáil GeodJango","version":"6.1","locale":"ga","docname":"ref/contrib/gis/install/index","url":"/ga/6.1/ref/contrib/gis/install/","canonical":"https://djangodocs.dev/ga/6.1/ref/contrib/gis/install/","summary":"Go ginearálta, éilíonn suiteáil GeodJango: :ref: `Python agus Django `; Bunachar sonraí spásúil; Leabharlanna geospásúla.","html":"

Suiteáil GeodJangoLink to this heading#

\n
\n

ForbhreathnúLink to this heading#

\n

Go ginearálta, éilíonn suiteáil GeodJango:

\n
    \n

  1. <django>:ref: `Python agus Django `

    2. \n

  2. Bunachar sonraí spásúil

    3. \n

  3. Leabharlanna geospásúla

    4. \n
\n

Cuirtear sonraí maidir le gach ceann de na riachtanais agus na treoracha suiteála ar fáil sna hailt thíos. Ina theannta sin, tá treoracha ardán-shonracha ar fáil do:

\n\n\n
\n
\n

RiachtanaisLink to this heading#

\n
\n

Python agus DjangoLink to this heading#

\n

<installing-official-release>Toisc go bhfuil GeodJango san áireamh le Django, féach le do thoil Django's:ref: `treoracha suiteála `le haghaidh sonraí maidir le conas a shuiteáil.

\n
\n
\n

Bunachar sonraí spásúilLink to this heading#

\n

Is iad PostgreSQL (le PostGIS), MySQL, Oracle, agus SQLite (le SpatiaLite) na bunachair sonraí spásúla a dtacaítear leo faoi láthair.

\n\n

The 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:

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Bunachar Sonraí

Ceanglais Leabharlan

Leaganacha Tacaithe

Nótaí

PostgreSQL

GEOS, GDAL, PROJ, PostGIS

15+

Éilíonn PostGIS.

MySQL

GEOS, GDAL

8.4+

<mysql-spatial-limitations>:ref: `Feidhmiúlacht theoranta `.

Oracle

GEOS, GDAL

19+

Ní thacaítear le XE.

SQLite

GEOS, GDAL, PROJ, SPATALITE

3.37.0+

Éilíonn Spatialite 4.3+

\n
\n

Féach freisin `an maitrís chomparáide seo `__ ar an OSGeo Wiki le haghaidh teaglaim féideartha PostgreSQL/PostGIS/Geos/GDal.

\n
\n
\n
\n

SuiteáilLink to this heading#

\n
\n

Leabharlanna geospásúlaLink to this heading#

\n
\n\n
\n
\n
\n

Suiteáil bunachar sonraíLink to this heading#

\n
\n\n
\n
\n
\n

DATABASES configurationLink to this heading#

\n

<spatial-backends>Socraigh an socrú: socrú: INNEALL <DATABASE-ENGINE>`go ceann de na: ref: `cúltaca spásúla.

\n
\n
\n

Cuir django.contrib.gis chuig: socrú: INSTALLED_APPSLink to this heading#

\n

Cosúil le feidhmchláir contrib Django eile, ní mór duit* amháin a chur leis: mod: django.contrib.gis chuig: setting: INSTALLED_APPS i do shocruithe. Tá sé seo ionas gur féidir na teimpléid gis a shuíomh - mura ndéantar iad, ansin ní fheidhmeoidh gnéithe mar an riarachán geografach nó léarscáileanna láithreáin KML i gceart.

\n
\n
\n
\n

FabhtcheartúLink to this heading#

\n

Mura féidir leat an réiteach ar do fhadhb a fháil anseo ansin páirt sa phobal! Is féidir leat:

\n\n
\n

Socruithe timpeallachta leabharLink to this heading#

\n

Go fada, is é an fhadhb is coitianta agus GeodJango á shuiteáil ná nach féidir na leabharlanna roinnte seachtracha (m.sh., do GEOS agus GDAL) a lonnú. [#] _ De ghnáth, is é cúis leis an bhfadhb seo ná nach bhfuil an córas oibriúcháin ar an eolaire ina suiteáilíodh na leabharlanna tógtha ó fhoinse.

\n

Go ginearálta, féadfar cosán an leabharlainne a shocrú ar bhonn in aghaidh an úsáideora trí athróg comhshaoil a shocrú, nó trí chonair an leabharlainne a chumrú don chóras iomlán.

\n
\n

Athróg comhshaoil LD_LIBRARY_PATHLink to this heading#

\n

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:

\n
Shell
export LD_LIBRARY_PATH=/usr/local/lib\n
\n
\n
\n

Cosán leabharlainne córais a shocrúLink to this heading#

\n

On 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:

\n
Shell
$ sudo echo /usr/local/lib >> /etc/ld.so.conf\n$ sudo ldconfig\n
\n

For 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:

\n
Shell
# crle -l $OLD_PATH:/usr/local/lib\n
\n
\n
\n

Suiteáil binutilsLink to this heading#

\n

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.

\n

Is féidir an pacáiste ``binutils` a shuiteáil ar chórais Debian agus Ubuntu ag baint úsáide as an ordú seo a leanas:

\n
Shell
$ sudo apt-get install binutils\n
\n

Ar an gcaoi chéanna, ar chórais Red Hat agus CentOS:

\n
Shell
$ sudo yum install binutils\n
\n
\n
\n
\n
\n

Treoracha sonracha don ardánLink to this heading#

\n
\n

macOSLink to this heading#

\n

Mar gheall ar an éagsúlacht na gcóras pacáistithe atá ar fáil do MacOS, tá roinnt roghanna éagsúla ag úsáideoirí chun GeodJango a shuiteáil. Is iad na roghanna seo:

\n\n

Cuimsíonn an chuid seo treoracha freisin maidir le leagan uasghrádaithe de:ref: macos_python a shuiteáil ó phacáistí a sholáthraíonn Fondúireacht Bogearraí Python, áfach, níl sé seo ag teastáil.

\n
\n

PythonLink to this heading#

\n

Although 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\n
\n
\n

Postgres.appLink to this heading#

\n

Postgres.app is a standalone PostgreSQL server\nthat includes the PostGIS extension. You will also need to install gdal\nwith Bailebrew.

\n

Tar éis Postgres.app a shuiteáil, cuir an méid seo a leanas le do .bash_profile` ionas gur féidir leat cláir an phacáiste a reáchtáil ón líne ordaithe. Cuir leagan PostgreSQL in ionad X.Y` sa Postgres.app a shuiteáil tú:

\n
Shell
export PATH=$PATH:/Applications/Postgres.app/Contents/Versions/X.Y/bin\n
\n

Is féidir leat a sheiceáil an bhfuil an cosán curtha ar bun i gceart trí chlóscríobh which psql ag pras críochfoirt.

\n
\n
\n

BailebrewLink to this heading#

\n

Soláthraíonn `Homebrew`__ “oidis” chun dénártha agus pacáistí a thógáil ón bhfoinse. Soláthraíonn sé oidis do na réamhriachtanais GeodJango ar ríomhairí Macintosh atá ag rith macOS. Toisc go dtógann Homebrew na bogearraí ó fhoinse fós, tá Xcode ag teastáil.

\n

Achoimre:

\n
Shell
$ brew install postgresql\n$ brew install postgis\n$ brew install gdal\n
\n
\n
FinkLink to this heading#
\n

Bhí `Kurt Schwehr`__ grásta go leor chun pacáistí GeodJango a chruthú d'úsáideoirí an chórais pacáiste `Fink`__. Tá pacáistí éagsúla ar fáil `__ (ag tosú le ``django-gis`), ag brath ar an leagan de Python is mian leat a úsáid.

\n
\n
\n
\n

MacPortsLink to this heading#

\n

`MacPorts`__ may be used to install GeoDjango prerequisites on computers\nrunning macOS. Because MacPorts still builds the software from source,\nXcode is required.

\n

Achoimre:

\n
Shell
$ sudo port install postgresql15-server\n$ sudo port install geos\n$ sudo port install proj6\n$ sudo port install postgis3\n$ sudo port install gdal\n
\n\n
\n
\n
\n

FuinneogaLink to this heading#

\n

Lean ar aghaidh tríd na codanna seo a leanas go seicheamhach d'fhonn GeodJango a shuiteáil ar Windows. Sa rang teagaisc seo, suiteálfaimid leaganacha 64 giotán de gach feidhmchlár.

\n
\n

PythonLink to this heading#

\n

Suiteáil leagan 64 giotán de Python. Féach: Doc: Suiteáil Python le haghaidh tuilleadh faisnéise </howto/windows>.

\n
\n
\n

PostgreSQLLink to this heading#

\n

Download 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\n

Nuair a chríochnaíonn an suiteálaí, iarrfaidh sé “Seoladh Tógálaí Stack ag imeacht?” - coinnigh é seo a sheiceáil, mar is gá a shuiteáil:ref: postgisasb.

\n\n
\n
\n

PostGISLink to this heading#

\n

Ón taobh istigh den Tógálaí Stack (chun rith lasmuigh den suiteálaí, :menuselection: Start --> PostgreSQL 15 --> Tógálaí Stack Iarrataire), roghnaigh: menuselection: PostgreSQL 15 (x64) ar chalafort 5432 ón roghchlár anuas agus cliceáil ar aghaidh. Leathnaigh an crann roghchláir: menuselection: Catagóirí --> Síneadh spásúil agus roghnaigh: menuselection: PostGIS X.Y do PostgreSQL 15.

\n

Tar éis duit cliceáil ar aghaidh, cuirfear ort an pacáiste roghnaithe a dhearbhú agus “Íoslódáil eolaire”. Cliceáil ar aghaidh arís, íoslódóidh sé seo PostGIS agus iarrfar ort cliceáil in aice le suiteálaí PostGIS a thosú. Roghnaigh na roghanna réamhshocraithe le linn suite Cuimsíonn an próiseas suiteála ceithre bhosca dialóige Tai/Níl, is é “Níl” an rogha réamhshocraithe do gach ceathrar.

\n
\n
\n

OSGeo4wLink to this heading#

\n

The OSGeo4W installer helps to install the PROJ, GDAL, and GEOS libraries\nrequired by GeoDjango. First, download the OSGeo4W installer, and\nrun it. Select Express Web-GIS Install 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.

\n
\n
\n

Athraigh timpeallacht WindowsLink to this heading#

\n

In 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:

\n
Bat
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%"\n
\n\n\n
\n
\n

Suiteáil Django agus bunachar sonraí a bhunúLink to this heading#

\n

Install Django on your system. It is\nrecommended that you create a virtual environment for each project you create.

\n
\n
\n

PsychopgLink to this heading#

\n

Soláthraíonn modúl Python psycopg an comhéadan idir Python agus bunachar sonraí PostgreSQL. Is féidir psycopg` a shuiteáil trí phip laistigh de do thimpeallacht fhíorúil Python:

\n
Windows
...\\> py -m pip install psycopg\n
\n

Fonótaí

\n\n
\n
\n
","rootId":"geodjango-installation","toc":[{"title":"Forbhreathnú","anchor":"overview","children":[]},{"title":"Riachtanais","anchor":"requirements","children":[{"title":"Python agus Django","anchor":"python-and-django","children":[]},{"title":"Bunachar sonraí spásúil","anchor":"spatial-database","children":[]}]},{"title":"Suiteáil","anchor":"installation","children":[{"title":"Leabharlanna geospásúla","anchor":"geospatial-libraries","children":[]},{"title":"Suiteáil bunachar sonraí","anchor":"database-installation","children":[]},{"title":"DATABASES configuration","anchor":"databases-configuration","children":[]},{"title":"Cuir django.contrib.gis chuig: socrú: INSTALLED_APPS","anchor":"add-django-contrib-gis-to-installed-apps","children":[]}]},{"title":"Fabhtcheartú","anchor":"troubleshooting","children":[{"title":"Socruithe timpeallachta leabhar","anchor":"library-environment-settings","children":[{"title":"Athróg comhshaoil LD_LIBRARY_PATH","anchor":"ld-library-path-environment-variable","children":[]},{"title":"Cosán leabharlainne córais a shocrú","anchor":"setting-system-library-path","children":[]},{"title":"Suiteáil binutils","anchor":"install-binutils","children":[]}]}]},{"title":"Treoracha sonracha don ardán","anchor":"platform-specific-instructions","children":[{"title":"macOS","anchor":"macos","children":[{"title":"Python","anchor":"python","children":[]},{"title":"Postgres.app","anchor":"postgres-app","children":[]},{"title":"Bailebrew","anchor":"homebrew","children":[{"title":"Fink","anchor":"fink","children":[]}]},{"title":"MacPorts","anchor":"macports","children":[]}]},{"title":"Fuinneoga","anchor":"windows","children":[{"title":"Python","anchor":"id18","children":[]},{"title":"PostgreSQL","anchor":"postgresql","children":[]},{"title":"PostGIS","anchor":"postgis","children":[]},{"title":"OSGeo4w","anchor":"osgeo4w","children":[]},{"title":"Athraigh timpeallacht Windows","anchor":"modify-windows-environment","children":[]},{"title":"Suiteáil Django agus bunachar sonraí a bhunú","anchor":"install-django-and-set-up-database","children":[]},{"title":"Psychopg","anchor":"psycopg","children":[]}]}]}],"breadcrumbs":[{"docname":"ref/index","title":"Tagairt API","url":"/ga/6.1/ref/"},{"docname":"ref/contrib/index","title":"Pacáistí contrib","url":"/ga/6.1/ref/contrib/"},{"docname":"ref/contrib/gis/index","title":"GeodJango","url":"/ga/6.1/ref/contrib/gis/"}],"prev":{"docname":"ref/contrib/gis/tutorial","title":"Ranganna Teagaisc GeodJango","url":"/ga/6.1/ref/contrib/gis/tutorial/"},"next":{"docname":"ref/contrib/gis/install/geolibs","title":"Leabharlanna Geospásúla a","url":"/ga/6.1/ref/contrib/gis/install/geolibs/"},"formats":{"html":"/ga/6.1/ref/contrib/gis/install/","markdown":"/ga/6.1/ref/contrib/gis/install.md","json":"/ga/6.1/ref/contrib/gis/install.json"},"source":"https://github.com/django/django/blob/stable/6.1.x/docs/ref/contrib/gis/install/index.txt","official":"https://docs.djangoproject.com/ga/6.1/ref/contrib/gis/install/","inVersions":["6.1","6.0","5.2"],"inLocales":["en","sv","zh-hans","ga","fr","ja","id","it","pt-br","ko","es","el","pl"]}