--- title: "Leabharlanna Geospásúla a" version: 5.2 locale: ga source: https://docs.djangoproject.com/ga/5.2/ref/contrib/gis/install/geolibs/ canonical: https://djangodocs.dev/ga/5.2/ref/contrib/gis/install/geolibs/ --- # Leabharlanna Geospásúla a Úsáideann GeodJango agus/nó soláthraíonn sé comhéadain do na leabharlanna geospásúla foinse oscailte | Clár | Cur síos | Riachtanach | Leaganacha Tacaithe | | --- | --- | --- | --- | | [GEOS](/ga/5.2/ref/contrib/gis/geos/) | Foinse Oscailte Inneall Ge | Tá | 3.13, 3.12, 3.11, 3.10, 3.9, 3.8 | | [PROJECT](https://proj.org/) | Leabharlann Réamh-mheastach | Sea (PostgreSQL agus SQLite amháin) | 9.x, 8.x, 7.x, 6.x | | [GDAL](/ga/5.2/ref/contrib/gis/gdal/) | Leabharlann Aistí Sonraí Geospásúla | Tá | 3.10, 3.9, 3.8, 3.7, 3.6, 3.5, 3.4, 3.3, 3.2, 3.1 | | [GeoIP](/ga/5.2/ref/contrib/gis/geoip2/) | Leabharlann geolocation bunaithe ar IP | Níl | 2 | | [PostGis](https://postgis.net/) | Síntí spásúla do PostgreSQL | Sea (PostgreSQL amháin) | 3.4, 3.3, 3.2, 3.1 | | [Spatialite](https://www.gaia-gis.it/gaia-sins/) | Síntí spásúla le haghaidh SQLite | Sea (SQLite amháin) | 5.1, 5.0, 4.3 | Tabhair faoi deara go bhféadfadh leaganacha níos sine nó níos déanaí de na leabharlanna seo oibriú go hiomlán breá le GeodJango freisin. Féadfaidh do mhíleáiste a athrú. > **Note** > > Is féidir na comhéadain GeodJango le GEOS, GDAL, agus GeoIP a úsáid go neamhspleách ar Django. Is é sin le rá, níl aon bhunachar sonraí ná comhad socruithe ag teastáil - iad a iompórtáil mar is gnách ó:mod: django.contrib.gis. Ar Debian/Ubuntu, moltar duit na pacáistí seo a leanas a shuiteáil a shuiteálfaidh, go díreach nó trí spleáchas, na leabharlanna geospásúla riachtanacha: ```console $ sudo apt-get install binutils libproj-dev gdal-bin ``` Téigh i gcomhairle le treoracha ardáin a shonraíonn freisin má tá tú ar:ref: macos nó:ref: windows. ## Tógáil ó fhoinse Agus tú ag suiteáil ó fhoinse ar chórais UNIX agus GNU/Linux, lean na treoracha suiteála go cúramach, agus suiteáil na leabharlanna san ord ar leith. Má úsáideann tú MySQL nó Oracle mar an bunachar sonraí spásúil, níl ach GEOS ag teastáil. > **Note** > > Ar ardáin Linux, b'fhéidir go mbeadh sé riachtanach an t-ordú ldconfig a reáchtáil tar éis gach leabharlann a shuiteáil. Mar shampla: > > ```shell > $ sudo make install > $ sudo ldconfig > ``` > **Note** > > Ní mór d'úsáideoirí macOS [Xcode](https://developer.apple.com/xcode/) a shuiteáil d'fhonn bogearraí a thiomsú ón bhfoinse. ### GEOS Is leabharlann C ++ é GEOS chun oibríochtaí geoiméadracha a dhéanamh, agus is é an léiriú geoiméadrachta inmheánach réamhshocraithe a úsáideann GeodJango (tá sé taobh thiar de na geoiméadrachtaí “leisciúla”). Go sonrach, tugtar leabharlann C API (m.sh., libgeos\_c.so ) go díreach ó Python ag baint úsáide as ctypes. Ar dtús, íoslódáil GEOS ó shuíomh Gréasáin GEOS agus déan an cartlann foinse a dhíoslódáil: ```shell $ wget https://download.osgeo.org/geos/geos-X.Y.Z.tar.bz2 $ tar xjf geos-X.Y.Z.tar.bz2 ``` Ansin téigh isteach san eolaire GEOS, cruthaigh fillteán tógáil , agus déan isteach ann: ```shell $ cd geos-X.Y.Z $ mkdir build $ cd build ``` Ansin tógáil agus suiteáil an pacáiste: ```shell $ cmake -DCMAKE_BUILD_TYPE=Release .. $ cmake --build . $ sudo cmake --build . --target install ``` #### Fabhtcheartú ##### Ní féidir leabharlann GEOS a fháil Nuair nach féidir le GeodJango GEOS a fháil, ardaítear an earráid seo: ```text ImportError: Could not find the GEOS library (tried "geos_c"). Try setting GEOS_LIBRARY_PATH in your settings. ``` Is é an réiteach is coitianta ná do: ref: libsettings *nó* set:ref: geoslibrarypath a chumrú i gceart i do shocruithe. Má tá pacáiste dénártha de GEOS á úsáid agat (m.sh., ar Ubuntu), b'fhéidir go mbeidh ort: ref: binutils. ##### `CONAIR_LEABHARLANNA_GEOS` Má tá do leabharlann GEOS in áit neamhchaighdeánach, nó mura dteastaíonn uait cosán leabharlainne an chórais a mhodhnú ansin is féidir an socrú:: GEOS\_LIBRARY\_PATH a chur le do chomhad socruithe Django leis an gcosán iomlán chuig leabharlann GEOS C. Mar shampla: ```shell GEOS_LIBRARY_PATH = '/home/bob/local/lib/libgeos_c.so' ``` > **Note** > > Caithfidh an socrú gurb é an cosán *iomlán* chuig an leabharlann roinnte\*\*C\*\*; i bhfocail eile ba mhaith leat `libgeos_c.so` a úsáid, ní `libgeos.so`. \Féach freis:ref: Líontar mo logaí le earráidí a bhaineann le Geos . ### PROJ Is leabharlann é [PROJ](https://proj.org/) chun sonraí geospásúla a thiontú go córais tagartha comhordaithe éagsúla. Ar dtús, íoslódáil cód foinse PROJ: ```shell $ wget https://download.osgeo.org/proj/proj-X.Y.Z.tar.gz ``` ... agus comhaid athraithe dáta (íoslódáil `proj-datumgrid-x.y.tar.gz` do PROJ \<7.x) \[#\] \_: ```shell $ wget https://download.osgeo.org/proj/proj-data-X.Y.tar.gz ``` Ansin, déan an cartlann cód foinse a bhaint, agus bain na comhaid athraithe dáta san fho-eolaire `sonra`. Caithfear é seo a dhéanamh *roimh* chun cumraíocht: ```shell $ tar xzf proj-X.Y.Z.tar.gz $ cd proj-X.Y.Z/data $ tar xzf ../../proj-data-X.Y.tar.gz $ cd ../.. ``` Maidir le PROJ 9.x agus níos mó, ní scaoiltear ach tógáil tacaíochta ag baint úsáide as `Cmake` (féach [PROJ RFC-7](https://proj.org/community/rfc/rfc-7.html#rfc7)). Chun tógáil le `Cmake` cinntigh go gcomhlíonann do chóras na [riachtanais tógála](https://proj.org/install.html#build-requirements). Ansin cruthaigh fillteán tógáil san eolaire PROJ, agus déan isteach ann: ```shell $ cd proj-X.Y.Z $ mkdir build $ cd build ``` Faoi dheireadh, cumraigh, déan agus suiteáil PROJ: ```shell $ cmake .. $ cmake --build . $ sudo cmake --build . --target install ``` ### GDAL Is leabharlann geospásúil foinse oscailte den scoth é [GDAL](https://gdal.org/) a bhfuil tacaíocht aige chun an chuid is mó de na formáidí sonraí spásúla veicteora agus raster a léamh. Faoi láthair, ní thacaíonn GeodJango ach le: doc: Sonraí veicteora GDAL \<.. /gdal \> \`cumais \[#\] \_. :ref: \`geosbuild agus:ref: proj4 ba chóir a shuiteáil sula ndéantar GDAL a thógáil. Déan an leagan scaoilte GDAL is déanaí a íoslódáil ar dtús agus déan an cartlann ```shell $ wget https://download.osgeo.org/gdal/X.Y.Z/gdal-X.Y.Z.tar.gz $ tar xzf gdal-X.Y.Z.tar.gz ``` Maidir le GDAL 3.6.x agus níos mó, ní scaoiltear ach tógáil tacaíochta ag baint úsáide as `Cmake`. Chun tógáil le Cmake\` cruthaigh fillteán tógáil san eolaire GDAL, agus déan isteach ann: ```shell $ cd gdal-X.Y.Z $ mkdir build $ cd build ``` Faoi dheireadh, cumraigh, déan agus suiteáil GDAL: ```shell $ cmake .. $ cmake --build . $ sudo cmake --build . --target install ``` Má tá aon fhadhbanna agat, féach an chuid fabhtcheartaithe thíos le haghaidh moltaí agus réitigh. #### Fabhtcheartú ##### Ní féidir leabharlann GDAL a fháil Nuair nach féidir le GeodJango leabharlann GDAL a fháil, cumraigh do: ref: libsettings *nó* set:ref: gdallibrarypath i do shocruithe. ##### `BÓTHAIR_LEABHARLANNA_GDAL` Má tá do leabharlann GDAL in áit neamhchaighdeánach, nó mura dteastaíonn uait cosán leabharlainne an chórais a mhodhnú ansin is féidir an socrú:: GDAL\_LIBRARY\_PATH a chur le do chomhad socruithe Django leis an gcosán iomlán chuig leabharlann GDAL. Mar shampla: ```shell GDAL_LIBRARY_PATH = '/home/sue/local/lib/libgdal.so' ``` **Fonótaí** [^1]: Teastaíonn na comhaid athraithe dáta chun sonraí a thiontú go réamh-mheastacháin áirithe agus ó. Mar shampla, ní éil\< \> íonn an teaghrán PROJ don teilgean Google (900913 nó 3857) \`\_ an comhad greille \`\`null\` atá san áireamh ach sna comhaid athraithe dátum breise. Tá sé níos éasca na comhaid athraitheacha a shuiteáil anois, ansin fadhb a dhífhabhtú mar gheall ar a n-easpa níos déanaí. [^2]: Go sonrach, soláthraíonn GeoDjango tacaíocht don leabharlann [OGR](#ogr), comhpháirt de GD\< [https://gdal.org/user/vector\_data\_model.html](https://gdal.org/user/vector_data_model.html)\> AL.