---
title: "Geolocation le GeoIP2"
version: 5.2
locale: ga
source: https://docs.djangoproject.com/ga/5.2/ref/contrib/gis/geoip2/
canonical: https://djangodocs.dev/ga/5.2/ref/contrib/gis/geoip2/
---
# Geolocation le GeoIP2

\<geoip2\>Is fillteán é an réad: Class: GeoIP2 don leabharlann: pypi: MaxMind geoip2 Python. \[#\] \_

D'fhonn geolocation bunaithe ar IP a dhéanamh, teastaíonn an réad:class: GeoIP2 an pacáiste Python:pypi: geoip2 agus tacair sonraí GeoIP ```Country ``agus/nó ``Cathra` i bhformáid dénártha (ní oibreoidh na comhaid CSV!) , íoslódáilte ó shuíomhanna gréasáin `MaxMind`__ nó `DB-IP`__. Faigh na comhaid ``Geolite2-Country.mmdb.gz``` agus `Geolite2-City.MMDB.GZ` agus dí-zip iad i eolaire a fhreagraíonn don socrú: GEOIP\_PATH.

Ina theannta sin, moltar leabharlann libmaxminddb C \`\_\_ a shuiteáil, ionas gur féidir le \`\`geoip2 luas níos tapúla leabharlann C a ghiaráil.

## Sampla

Seo sampla dá úsáid:

```pycon
>>> from django.contrib.gis.geoip2 import GeoIP2
>>> g = GeoIP2()
>>> g.country("google.com")
{'continent_code': 'NA',
 'continent_name': 'North America',
 'country_code': 'US',
 'country_name': 'United States',
 'is_in_european_union': False}
>>> g.city("72.14.207.99")
{'accuracy_radius': 1000,
 'city': 'Mountain View',
 'continent_code': 'NA',
 'continent_name': 'North America',
 'country_code': 'US',
 'country_name': 'United States',
 'is_in_european_union': False,
 'latitude': 37.419200897216797,
 'longitude': -122.05740356445312,
 'metro_code': 807,
 'postal_code': '94043',
 'region_code': 'CA',
 'region_name': 'California',
 'time_zone': 'America/Los_Angeles',
 'dma_code': 807,
 'region': 'CA'}
>>> g.lat_lon("salon.com")
(39.0437, -77.4875)
>>> g.lon_lat("uh.edu")
(-95.4342, 29.834)
>>> g.geos("24.124.1.80").wkt
'POINT (-97 38)'
```

## Tagairt API

#### `class GeoIP2(path=None, cache=0, country=None, city=None)`

Ní éilíonn aon pharaiméadair ar an réad `Geoip` chun na socruithe réamhshocraithe a úsáid. Mar sin féin, ar a laghad ba cheart an socrú: setting: GEOIP\_PATH a shocrú le cosán suíomh do thacair sonraí GeoIP. Is féidir na heochairfhocail tionscnaíochta seo a leanas a úsáid chun aon cheann de na réamhshocruithe a shaincheapadh.

| Argóintí Eochair | Cur síos |
| --- | --- |
| `Conair` | Buneolaire chuig an áit a bhfuil sonraí GeoIP suite nó an cosán iomlán chuig an áit a bhfuil comhaid sonraí na cathrach nó na tíre (.mmdb\`) suite. Glacann sé leis go bhfuil tacair shonraí na cathrach agus na tíre araon suite san eolaire seo; sáraíonn sé an socrú:setting: GEOIP\_PATH. |
| Cache \`\` | Na socruithe taisce agus na tacair sonraí GeoIP á oscailt suas. D'fhéadfadh sé a bheith ina shláimhir i (0, 1, 2, 4, 8) a fhreagraíonn do na socruithe API `MODE_AUTO`, MODE\_MMAP\_EXT\`, MODE\_MMAP\`, agus ````GEOIP_INDEX_CACHE ```MODE_MEMORY```` C API, faoi seach. Réamhshocraithe go 0 (`MODE_AUTO`). |
| `` `tír `` | Ainm an chomhad sonraí tíre GeoIP. Réamhshocraithe go `Geolite2-Country.mmdb`. Cuireann an eochairfhocal seo a shocrú ar an socrú:setting: GEOIP\_COUNTRY. |
| `Cathair` | Ainm an chomhad sonraí cathrach GeoIP. Réamhshocraithe go `Geolite2-City.mmdb`. Cuireann an eochairfhocal seo a shocrú ar an socrú: socrú: GEOIP\_CITY. |

## Modhanna

### Ag teacht ar aghaidh

#### `classmethod GeoIP2.open(path, cache)`

Cuireann an modh ranga seo an réad GeoIP ón gcosán bunachar sonraí tugtha agus socrú taisce tugtha.

> **Deprecated since Django 5.1**
>
> Deprecated since version 5.1: Úsáid an tógálaí: class: GeoIP2 () ina ionad.

### Ag fiosrú

Féadfaidh na gnáthaimh fiosrúcháin seo a leanas a bheith mar shampla de:class: ~iPaddress.ipv4Address nó:class: ~iPaddress.ipv6Address, seoladh IP teaghrán, nó ainm fearainn láncháilithe (FQDN). Mar shampla, “IPV4Address (“205.186.163.125") ```, ``"205.186.163.125"```, agus `"djangoproject.com"` a bheadh paraiméadair bhailí fiosrúcháin.

#### `GeoIP2.city(query)`

Tugann foclóir faisnéise cathrach ar ais don cheist a thugtar. D'fhéadfadh go mbeadh cuid de na luachanna sa fhoclóir neamhshainithe (None ).

#### `GeoIP2.country(query)`

Tugann foclóir ar ais leis an gcód tíre agus an tír don cheist a thugtar.

#### `GeoIP2.country_code(query)`

Tugann an cód tíre a fhreagraíonn don cheist ar ais.

#### `GeoIP2.country_name(query)`

Tugann ainm na tíre a fhreagraíonn don cheist ar ais.

### Comhordú Aisghabháil

#### `GeoIP2.coords(query)`

Tuipéar comhordaithe de (domhanfhad, domhanleithead) ar ais.

> **Deprecated since Django 5.1**
>
> Deprecated since version 5.1: Úsáid: Meth: .geoip2.lon\_lat ina ionad.

#### `GeoIP2.lon_lat(query)`

Tuipéar comhordaithe de (domhanfhad, domhanleithead) ar ais.

#### `GeoIP2.lat_lon(query)`

Tuipéar comhordaithe de (domhanleithead, domhanfhad) ar ais,

#### `GeoIP2.geos(query)`

Tuairisceáin a:class: ~django.contrib.gis.geos.point réad a fhreagraíonn don cheist.

## Socruithe

### `GEOIP_PATH`

Teagán nó:class: PathLib.path a shonraíonn an eolaire ina bhfuil na comhaid sonraí GeoIP suite. Tá an socrú seo *riachtanáil* mura sonraítear de láimh le heochairfhocal `path` nuair a thosaíonn an réad: class: GeoIP2.

### `TÍR_GEOIP`

An bunainm le húsáid don chomhad sonraí tíre GeoIP. Réamhshocraithe go `` `'Geolite2-Country.mmdb' ``.

### `GEOIP_CATH`

An bunainm le húsáid le haghaidh comhad sonraí cathrach GeoIP. Réamhshocraithe go `` `'Geolite2-City.mmdb' ``.

## Eisceachtaí

#### `exception GeoIP2Exception`

Ardaíodh an eisceacht nuair a tharlaíonn earráid sa bhfillteán: aicme: GeoIP2. Cuirtear eisceachtaí ón leabharlann bunúsach geoip2 tríd gan athrú.

**Fonótaí**

[^1]: Is trádmharc cláraithe de MaxMind, Inc. é GeoIP (R).