--- title: "Suiteáil GeodJango" version: 5.2 locale: ga source: https://docs.djangoproject.com/ga/5.2/ref/contrib/gis/install/ canonical: https://djangodocs.dev/ga/5.2/ref/contrib/gis/install/ --- # Suiteáil GeodJango ## Forbhreathnú Go ginearálta, éilíonn suiteáil GeodJango: 1. \:ref: Python agus Django \` 2. [Bunachar sonraí spásúil](#spatial-database) 3. [Leabharlanna Geospásúla a](/ga/5.2/ref/contrib/gis/install/geolibs/) 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: - [macOS](#macos) - [Fuinneoga](#windows) > **Úsáid an Foinse** > > Toisc go mbaineann GeodJango leas as an teicneolaíocht bogearraí geospásúla foinse oscailte is déanaí, tá leaganacha le déanaí de na leabharlanna riachtanach. Mura bhfuil pacáistí dénártha ar fáil do d'ardán, d'fhéadfadh go mbeadh gá le suiteáil ón bhfoinse. Agus na leabharlanna á thiomsú agat ó fhoinse, lean na treoracha go dlúth, go háirithe más tosaitheoir tú. ## Riachtanais ### Python agus Django \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. ### Bunachar sonraí spásúil Is iad PostgreSQL (le PostGIS), MySQL, Oracle, agus SQLite (le SpatiaLite) na bunachair sonraí spásúla a dtacaítear leo faoi láthair. > **Note** > > Moltar PostGIS, toisc gurb é an bunachar sonraí spásúil foinse oscailte is aibí agus is saibhir i ngnéithe é. 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: | Bunachar Sonraí | Ceanglais Leabharlan | Leaganacha Tacaithe | Nótaí | | --- | --- | --- | --- | | PostgreSQL | GEOS, GDAL, PROJ, PostGIS | 14+ | Éilíonn PostGIS. | | MySQL | GEOS, GDAL | 8.0.11+ | \: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+ | Féach freisin an maitrís chomparáide seo \_\_ ar an OSGeo Wiki le haghaidh teaglaim féideartha PostgreSQL/PostGIS/Geos/GDal. ## Suiteáil ### Leabharlanna geospásúla - [Leabharlanna Geospásúla a](/ga/5.2/ref/contrib/gis/install/geolibs/) ### Suiteáil bunachar sonraí - [PostGIS a shuiteáil](/ga/5.2/ref/contrib/gis/install/postgis/) - [Suiteáil SpatiaLite](/ga/5.2/ref/contrib/gis/install/spatialite/) ### [`DATABASES`](/ga/5.2/ref/settings/#std-setting-DATABASES) configuration \Socraigh an socrú: socrú: INNEALL \\`go ceann de na: ref: \`cúltaca spásúla. ### Cuir `django.contrib.gis` chuig: socrú: INSTALLED\_APPS 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. ## Fabhtcheartú Mura féidir leat an réiteach ar do fhadhb a fháil anseo ansin páirt sa phobal! Is féidir leat: - Cuir do cheist ar an bhfóram . - Comhdaigh ticéad ar an rian Django \_\_ má cheapann tú go bhfuil fabht ann. Déan cinnte cur síos iomlán a sholáthar ar an bhfadhb, leaganacha a úsáidtear, agus sonraigh an chomhpháirt mar “GIS”. ### Socruithe timpeallachta leabhar 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. 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. #### Athróg comhshaoil `LD_LIBRARY_PATH` 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: ```shell export LD_LIBRARY_PATH=/usr/local/lib ``` #### Cosán leabharlainne córais a shocrú 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: ```shell $ sudo echo /usr/local/lib >> /etc/ld.so.conf $ sudo ldconfig ``` 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: ```shell # crle -l $OLD_PATH:/usr/local/lib ``` #### Suiteáil `binutils` Ú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. 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: ```shell $ sudo apt-get install binutils ``` Ar an gcaoi chéanna, ar chórais Red Hat agus CentOS: ```shell $ sudo yum install binutils ``` ## Treoracha sonracha don ardán ### macOS 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: - [Postgres.app](#postgresapp) (easiest and recommended) - [Bailebrew](#homebrew) - [Fink](#fink) - [MacPorts](#macports) - [Tógáil ó fhoinse](/ga/5.2/ref/contrib/gis/install/geolibs/#build-from-source) 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. #### Python 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. > **Note** > > Beidh ort an t-athróg timpeallachta `PATH` a mhodhnú i do chomhad `.profile` ionas go n-úsáidfear an leagan nua de Python nuair a iontráiltear `python` ag an líne ordaithe: > > ```shell > export PATH=/Library/Frameworks/Python.framework/Versions/Current/bin:$PATH > ``` #### Postgres.app Is freastalaí neamhspleách PostgreSQL é [Postgres.app](#id8) \< \> a chuimsíonn an síneadh PostGIS. Beidh ort freisin `gdal` agus `libgeoip` a shuiteáil le:ref: homebrew. 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ú: ```bash export PATH=$PATH:/Applications/Postgres.app/Contents/Versions/X.Y/bin ``` 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. #### Bailebrew Soláthraíonn “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](https://developer.apple.com/xcode/) ag teastáil. Achoimre: ```shell $ brew install postgresql $ brew install postgis $ brew install gdal $ brew install libgeoip ``` ##### Fink Bhí grásta go leor chun pacáistí GeodJango a chruthú d'úsáideoirí an chórais pacáiste . 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. #### MacPorts 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](https://developer.apple.com/xcode/) ag teastáil. Achoimre: ```shell $ sudo port install postgresql14-server $ sudo port install geos $ sudo port install proj6 $ sudo port install postgis3 $ sudo port install gdal $ sudo port install libgeoip ``` > **Note** > > Beidh ort freisin an PATH\` a mhodhnú i do .profile\` ionas go mbeidh na cláir MacPorts inrochtana ón líne ordaithe: > > ```shell > export PATH=/opt/local/bin:/opt/local/lib/postgresql14/bin > ``` > > Ina theannta sin, cuir an socrú `DYLD_FALLBACK_LIBRARY_PATH` ionas gur féidir Python na leabharlanna a fháil: > > ```shell > export DYLD_FALLBACK_LIBRARY_PATH=/opt/local/lib:/opt/local/lib/postgresql14 > ``` ### Fuinneoga 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. #### Python Suiteáil leagan 64 giotán de Python. Féach: Doc: Suiteáil Python le haghaidh tuilleadh faisnéise \. #### PostgreSQL Íoslódáil an suiteálaí . 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í > **Note** > > Cruthaíonn suiteálaí PostgreSQL sárúsáideoir bunachar sonraí nua `postgres` spreagfar ort uair amháin an pasfhocal a shocrú - déan cinnte cuimhneamh air! 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. > **Note** > > Má tá sé suiteáilte go rathúil, rithfidh an freastalaí PostgreSQL sa chúlra gach uair a thosaigh an córas mar sheirbhís Windows. A: MenusElection: Cruthóidh grúpa roghchlár tosaigh PostgreSQL 15 agus beidh aicearraí ann don Tógálaí Staca Feidhmchláir (ASB) chomh maith leis an 'SQL Shell', a sheolfaidh fuinneog ordaithe psql . #### PostGIS Ó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. 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. #### OSGeo4w 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 #### Athraigh timpeallacht Windows 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: ```bat set OSGEO4W_ROOT=C:\OSGeo4W set GDAL_DATA=%OSGEO4W_ROOT%\apps\gdal\share\gdal set PROJ_LIB=%OSGEO4W_ROOT%\share\proj set PATH=%PATH%;%OSGEO4W_ROOT%\bin reg ADD "HKLM\SYSTEM\CurrentControlSet\Control\Session Manager\Environment" /v Path /t REG_EXPAND_SZ /f /d "%PATH%" reg ADD "HKLM\SYSTEM\CurrentControlSet\Control\Session Manager\Environment" /v GDAL_DATA /t REG_EXPAND_SZ /f /d "%GDAL_DATA%" reg ADD "HKLM\SYSTEM\CurrentControlSet\Control\Session Manager\Environment" /v PROJ_LIB /t REG_EXPAND_SZ /f /d "%PROJ_LIB%" ``` > **Note** > > Teastaíonn pribhléidí riarthóra chun na horduithe seo a chur i Chun seo a dhéanamh, reáchtáil pras ordaithe mar riarthóir agus cuir isteach na horduithe thuas. Ní mór duit logáil amach agus logáil isteach arís chun go dtiocfaidh na socruithe i bhfeidhm. > **Note** > > Má shaincheapann tú eolairí suiteála OSGeo4w, ansin beidh ort na hathróga OSGEO4W\_ROOT\` a mhodhnú dá réir. #### Suiteáil Django agus bunachar sonraí a bhunú [Install Django](/ga/5.2/topics/install/#installing-official-release) on your system. It is recommended that you create a [virtual environment](https://docs.python.org/3/tutorial/venv.html) for each project you create. #### Psychopg 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: ```doscon ...\> py -m pip install psycopg ``` **Fonótaí** [^1]: Úsáideann GeodJango gnáthamh: func: ~ctypes.util.find\_library ó `ctypes.util` chun leabharlanna roinnte a aimsiú.