{"title":"Géolocalisation avec GeoIP2","version":"5.1","locale":"fr","docname":"ref/contrib/gis/geoip2","url":"/fr/5.1/ref/contrib/gis/geoip2/","canonical":"https://djangodocs.dev/fr/5.1/ref/contrib/gis/geoip2/","summary":"L’objet GeoIP2 est une adaptation de la bibliothèque Python geoip2 de MaxMind . [ 1 ] Afin de pouvoir procéder à la géolocalisation basée sur l’adresse IP, l’objet…","html":"

Géolocalisation avec GeoIP2Lien vers cette rubrique#

\n

L’objet GeoIP2 est une adaptation de la bibliothèque Python geoip2 de MaxMind. [1]

\n

Afin de pouvoir procéder à la géolocalisation basée sur l’adresse IP, l’objet GeoIP2 a besoin du paquet Python geoip2 et d’un des jeux de données GeoIP Country ou City en format binaire (les fichiers CSV ne fonctionneront pas !), téléchargé à partir des sites web MaxMind ou DB-IP. Récupérez les fichiers GeoLite2-Country.mmdb.gz et GeoLite2-City.mmdb.gz et décompressez-les dans un répertoire correspondant au réglage GEOIP_PATH.

\n

En outre, il est recommandé d’installer la bibliothèque C libmaxminddb, afin que geoip2 puisse tirer parti de la vitesse plus rapide de la bibliothèque C.

\n
\n

ExempleLien vers cette rubrique#

\n

Voici un exemple de son utilisation :

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

Référence de l’APILien vers cette rubrique#

\n
\n
\nclass GeoIP2(path=None, cache=0, country=None, city=None)Lien vers cette définition#
\n
\n\n

L’objet GeoIP n’a besoin d’aucun paramètre s’il utilise les réglages par défaut. Cependant, il faut au minimum définir le réglage GEOIP_PATH en indiquant le chemin vers l’emplacement des jeux de données GeoIP. Les paramètres nommés suivants peuvent être utilisés pour personnaliser les réglages par défaut lors de l’initialisation.

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

Paramètres nommés

Description

path

Répertoire de base où sont stockées les données GeoIP ou chemin complet de l’emplacement des fichiers de données (.mmdb) de villes et de pays. On suppose que les jeux de données des villes et des pays se trouvent dans ce même répertoire ; ce paramètre surcharge le réglage GEOIP_PATH.

cache

Les réglages de cache lors de l’ouverture des jeux de données GeoIP. Il peut s’agir d’un nombre entier dans (0, 1, 2, 4, 8) correspondant respectivement aux réglages MODE_AUTO, MODE_MMAP_EXT, MODE_MMAP et GEOIP_INDEX_CACHE des réglages MODE_MEMORY de l’API C. La valeur par défaut est 0 (MODE_AUTO).

country

Le nom du fichier de données des pays GeoIP. La valeur par défaut est GeoLite2-Country.mmdb. L’attribution d’une valeur à ce paramètre surcharge la valeur du réglage GEOIP_COUNTRY.

city

Le nom du fichier de données des villes GeoIP. La valeur par défaut est GeoLite2-City.mmdb. L’attribution d’une valeur à ce paramètre surcharge la valeur du réglage GEOIP_CITY.

\n
\n
\n
\n

MéthodesLien vers cette rubrique#

\n
\n

InstanciationLien vers cette rubrique#

\n
\n
\nclassmethod GeoIP2.open(path, cache)Lien vers cette définition#
\n
\n\n

Cette méthode de classe crée une instance d’objet GeoIP à partir du chemin de base de données indiqué et du réglage de cache.

\n\n
\n
\n

InterrogationLien vers cette rubrique#

\n

Toutes les routines d’interrogation suivantes acceptent une instance de IPv4Address ou de IPv6Address, une chaîne d’adresse IP ou un nom de domaine entièrement qualifié (FQDN). Par exemple, IPv4Address("205.186.163.125"), "205.186.163.125" et "djangoproject.com" seraient tous des paramètres d’interrogation valables.

\n
\n
\nGeoIP2.city(query)Lien vers cette définition#
\n
\n\n

Renvoie un dictionnaire d’informations sur une ville correspondant à la requête donnée. Certaines valeurs du dictionnaire peuvent rester indéfinies (None).

\n
\n
\nGeoIP2.country(query)Lien vers cette définition#
\n
\n\n

Renvoie un dictionnaire contenant le pays et son code correspondant à la requête donnée.

\n
\n
\nGeoIP2.country_code(query)Lien vers cette définition#
\n
\n\n

Renvoie le code de pays correspondant à la requête donnée.

\n
\n
\nGeoIP2.country_name(query)Lien vers cette définition#
\n
\n\n

Renvoie le nom de pays correspondant à la requête donnée.

\n
\n
\n

Obtention de coordonnéesLien vers cette rubrique#

\n
\n
\nGeoIP2.coords(query)Lien vers cette définition#
\n
\n\n

Renvoie un tuple de coordonnées (longitude, latitude).

\n\n
\n
\nGeoIP2.lon_lat(query)Lien vers cette définition#
\n
\n\n

Renvoie un tuple de coordonnées (longitude, latitude).

\n
\n
\nGeoIP2.lat_lon(query)Lien vers cette définition#
\n
\n\n

Renvoie un tuple de coordonnées (latitude, longitude).

\n
\n
\nGeoIP2.geos(query)Lien vers cette définition#
\n
\n\n

Renvoie un objet Point correspondant à la requête.

\n
\n
\n
\n

RéglagesLien vers cette rubrique#

\n
\n

GEOIP_PATHLien vers cette rubrique#

\n

Une chaîne ou objet pathlib.Path indiquant le répertoire où se trouvent les fichiers de données GeoIP. Ce réglage est obligatoire sauf dans le cas où vous indiquez manuellement le paramètre path lors de l’initialisation des objets GeoIP2.

\n
\n
\n

GEOIP_COUNTRYLien vers cette rubrique#

\n

Le nom de base à utiliser pour le fichier de données des pays GeoIP. 'GeoLite2-Country.mmdb' par défaut.

\n
\n
\n

GEOIP_CITYLien vers cette rubrique#

\n

Le nom de base à utiliser pour le fichier de données des villes GeoIP. 'GeoLite2-City.mmdb' par défaut.

\n
\n
\n
\n

ExceptionsLien vers cette rubrique#

\n
\n
\nexception GeoIP2ExceptionLien vers cette définition#
\n

L’exception levée quand une erreur survient dans la classe enveloppeuse GeoIP2. Les exceptions provenant de la bibliothèque sous-jacente geoip2 ne sont pas interceptées et sont transmises telles quelles.

\n
\n\n

Notes de bas de page

\n\n
","rootId":"module-django.contrib.gis.geoip2","toc":[{"title":"Exemple","anchor":"example","children":[]},{"title":"Référence de l’API","anchor":"api-reference","children":[]},{"title":"Méthodes","anchor":"methods","children":[{"title":"Instanciation","anchor":"instantiating","children":[]},{"title":"Interrogation","anchor":"querying","children":[]},{"title":"Obtention de coordonnées","anchor":"coordinate-retrieval","children":[]}]},{"title":"Réglages","anchor":"settings","children":[{"title":"GEOIP_PATH","anchor":"geoip-path","children":[]},{"title":"GEOIP_COUNTRY","anchor":"geoip-country","children":[]},{"title":"GEOIP_CITY","anchor":"geoip-city","children":[]}]},{"title":"Exceptions","anchor":"exceptions","children":[]}],"breadcrumbs":[{"docname":"ref/index","title":"Référence de l’API","url":"/fr/5.1/ref/"},{"docname":"ref/contrib/index","title":"Paquets contrib","url":"/fr/5.1/ref/contrib/"},{"docname":"ref/contrib/gis/index","title":"GeoDjango","url":"/fr/5.1/ref/contrib/gis/"}],"prev":{"docname":"ref/contrib/gis/gdal","title":"API de GDAL","url":"/fr/5.1/ref/contrib/gis/gdal/"},"next":{"docname":"ref/contrib/gis/utils","title":"Utilitaires GeoDjango","url":"/fr/5.1/ref/contrib/gis/utils/"},"formats":{"html":"/fr/5.1/ref/contrib/gis/geoip2/","markdown":"/fr/5.1/ref/contrib/gis/geoip2.md","json":"/fr/5.1/ref/contrib/gis/geoip2.json"},"source":"https://github.com/django/django/blob/stable/5.1.x/docs/ref/contrib/gis/geoip2.txt","official":"https://docs.djangoproject.com/fr/5.1/ref/contrib/gis/geoip2/","inVersions":["6.1","6.0","5.2","5.1","5.0","4.2","4.1","4.0","3.2","3.1","3.0","2.2","2.1","2.0","1.11","1.10","1.9"],"inLocales":["en","zh-hans","fr","ja","id","it","pt-br","ko","es","el","pl"]}