{"title":"Suiteáil GeodJango","version":"5.2","locale":"ga","docname":"ref/contrib/gis/install/index","url":"/ga/5.2/ref/contrib/gis/install/","canonical":"https://djangodocs.dev/ga/5.2/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 a.","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 a

    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

Braitheann na leabharlanna geospásúla a theastaíonn le haghaidh suiteáil GeodJango ar an mbunachar sonraí spásúil a úsáidtear. Liostaíonn an méid seo a leanas na riachtanais leabharlainne, leaganacha tacaithe, agus aon nótaí do gach ceann de na cúltaca bunachar sonraí tacaithe:

\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

14+

Éilíonn PostGIS.

MySQL

GEOS, GDAL

8.0.11+

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

Oracle

GEOS, GDAL

19+

Ní thacaítear le XE.

SQLite

GEOS, GDAL, PROJ, SPATALITE

3.31+

É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

Féadfaidh úsáideoir an t-athróg comhshaoil seo a shocrú chun na cosáin leabharlainne is mian leo a úsáid a shaincheapadh Is é /usr/local/lib an eolaire leabharlainne tipiciúil do bhogearraí a tógadh ó fhoinse. Dá bhrí sin, ní mór /usr/local/lib a áireamh san athróg LD_LIBRARY_PATH. Mar shampla, d'fhéadfadh an t-úsáideoir na rudaí seo a leanas a chur ina bpróifíl bash:

\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

Ar chórais GNU/Linux, de ghnáth bíonn comhad ann i /etc/ld.so.conf, a d'fhéadfadh cosáin bhreise a áireamh ó chomhaid in eolaire eile, mar shampla /etc/ld.so.conf.d. Mar úsáideoir fréimhe, cuir an cosán leabharlainne saincheaptha (cosúil le /usr/local/lib) ar líne nua i ld.so.conf`. Seo* sampla aon* de conas é sin a dhéanamh:

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

Maidir le húsáideoirí OpenSolaris, féadfar cosán leabharlainne an chórais a mhodhnú ag baint úsáide as an bhfóntais crle. Rith crle gan aon roghanna chun an chumraíocht reatha a fheiceáil agus bain úsáid as crle -l chun socrú leis an gcosán leabharlainne nua. Bí * mór* cúramach agus cosán leabharlainne an chórais á mhodhnú agat:

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

Suiteáil binutilsLink to this heading#

\n

Úsáideann GeodJango an fheidhm find_library (ón modúl Python ctypes.util) chun leabharlanna a fháil amach. Úsáideann gnáthamh find_library clár ar a dtugtar objdump (cuid den phacáiste binutils) chun leabharlann roinnte ar chórais GNU/Linux a fhíorú. Dá bhrí sin, mura bhfuil binutils suiteáilte ar do chóras Linux ansin b'fhéidir nach mbeidh ctypes Python in ann do leabharlann a aimsiú fiú má tá do chosán leabharlainne socraithe i gceart agus tógadh leabharlanna geospásúla go foirfe.

\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

Cé go dtagann MacOS le Python suiteáilte, is féidir le húsáideoirí `suiteálaithe creat `__ a sholáthraíonn Fondúireacht Bogearraí Python a úsáid. Buntáiste a bhaineann leis an suiteálaí a úsáid ná go bhfanfaidh Python MacOS “pristine” le húsáid an chórais oibriúcháin inmheánach.

\n\n
\n
\n

Postgres.appLink to this heading#

\n

Is freastalaí neamhspleách PostgreSQL é Postgres.app < https://postgresapp.com/> a chuimsíonn an síneadh PostGIS. Beidh ort freisin gdal agus libgeoip a shuiteáil le:ref: homebrew.

\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$ brew install libgeoip\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

Is féidir MacPorts `__ a úsáid chun réamhriachtanais GeodJango a shuiteáil ar ríomhairí atá ag rith macOS. Toisc go dtógann MacPorts na bogearraí ó fhoinse fós, tá `Xcode ag teastáil.

\n

Achoimre:

\n
Shell
$ 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\n$ sudo port install libgeoip\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

Íoslódáil an suiteálaí `PostgreSQL 15.x `__ is déanaí ó shuíomh Gréasáin `EnterprisedB`__. Tar éis duit a íoslódáil, rith an suiteálaí, lean na treoracha ar an scáileán, agus coinnigh na roghanna réamhshocraithe mura bhfuil a fhios agat na hiarmhairtí

\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

Cuidíonn an suiteálaí OSGeo4W `_ leis na leabharlanna PROJ, GDAL, agus GEOS a theastaíonn ag GeoDjango a shuiteáil. Ar dtús, íoslódáil an `suiteálaí OSGeo4w `_, agus rith é. Roghnaigh: MenusElection: `Express Web-GIS Install agus cliceáil ar aghaidh. Sa liosta 'Roghnaigh Pacáistí', cinntigh go roghnaítear GDAL. Má chumasaítear aon phacáistí eile de réir réamhshocraithe, ní theastaíonn GeodJango iad agus féadfar iad a dhísheiceáil go sábháilte. Tar éis duit cliceáil eile agus glacadh leis na comhaontuithe ceadúnais, déanfar na pacáistí a íoslódáil agus a shuiteáil go huathoibríoch, agus ina dhiaidh

\n
\n
\n

Athraigh timpeallacht WindowsLink to this heading#

\n

D'fhonn GeodJango a úsáid, beidh ort d'eolairí OSGeo4w a chur le do chóras Windows Path, chomh maith le hathróga timpeallachta GDAL_DATA agus PROJ_LIB` a chruthú. Cuirfidh an tacar orduithe seo a leanas, infheidhmithe le cmd.exe`, é seo ar bun. Athosaigh do ghléas nuair a bheidh sé seo críochnaithe chun athróga nua timpeallachta a aithint:

\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/5.2/ref/"},{"docname":"ref/contrib/index","title":"Pacáistí contrib","url":"/ga/5.2/ref/contrib/"},{"docname":"ref/contrib/gis/index","title":"GeodJango","url":"/ga/5.2/ref/contrib/gis/"}],"prev":{"docname":"ref/contrib/gis/tutorial","title":"Ranganna Teagaisc GeodJango","url":"/ga/5.2/ref/contrib/gis/tutorial/"},"next":{"docname":"ref/contrib/gis/install/geolibs","title":"Leabharlanna Geospásúla a","url":"/ga/5.2/ref/contrib/gis/install/geolibs/"},"formats":{"html":"/ga/5.2/ref/contrib/gis/install/","markdown":"/ga/5.2/ref/contrib/gis/install.md","json":"/ga/5.2/ref/contrib/gis/install.json"},"source":"https://github.com/django/django/blob/stable/5.2.x/docs/ref/contrib/gis/install/index.txt","official":"https://docs.djangoproject.com/ga/5.2/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"]}