{"title":"Géolocalisation avec GeoIP","version":"1.10","locale":"fr","docname":"ref/contrib/gis/geoip","url":"/fr/1.10/ref/contrib/gis/geoip/","canonical":"https://djangodocs.dev/fr/1.10/ref/contrib/gis/geoip/","summary":"Deprecated since Django 1.9 Obsolète depuis la version 1.9: Ce module est obsolète et devrait être remplacé par django.contrib.gis.geoip2 qui prend en charge IPv6…","html":"

Géolocalisation avec GeoIPLien vers cette rubrique#

\n\n

L’objet GeoIP est une adaptation ctypes de l”API C GeoIP de MaxMind. [1]

\n

Afin de pouvoir procéder à la géolocalisation basée sur l’adresse IP, l’objet GeoIP a besoin de la bibliothèque C GeoIP et d’au moins un des jeux de données GeoIP Country ou City en format binaire (les fichiers CSV ne fonctionneront pas !). Ces données peuvent être téléchargées sur le site MaxMind. Récupérez les fichiers GeoLiteCountry/GeoIP.dat.gz et GeoLiteCity.dat.gz et décompressez-les dans un répertoire correspondant au contenu du réglage GEOIP_PATH que vous devez définir dans vos réglages. Consultez l’exemple et la référence ci-dessous pour plus de détails.

\n
\n

ExempleLien vers cette rubrique#

\n

En supposant que la bibliothèque C GeoIP est installée, voici un exemple de son utilisation :

\n
Code
>>> from django.contrib.gis.geoip import GeoIP\n>>> g = GeoIP()\n>>> g.country('google.com')\n{'country_code': 'US', 'country_name': 'United States'}\n>>> g.city('72.14.207.99')\n{'area_code': 650,\n'city': 'Mountain View',\n'country_code': 'US',\n'country_code3': 'USA',\n'country_name': 'United States',\n'dma_code': 807,\n'latitude': 37.419200897216797,\n'longitude': -122.05740356445312,\n'postal_code': '94043',\n'region': 'CA'}\n>>> g.lat_lon('salon.com')\n(37.789798736572266, -122.39420318603516)\n>>> g.lon_lat('uh.edu')\n(-95.415199279785156, 29.77549934387207)\n>>> g.geos('24.124.1.80').wkt\n'POINT (-95.2087020874023438 39.0392990112304688)'\n
\n
\n
\n

Les réglages GeoIPLien vers cette rubrique#

\n
\n

GEOIP_PATHLien vers cette rubrique#

\n

Une chaîne 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 GeoIP.

\n
\n
\n

GEOIP_LIBRARY_PATHLien vers cette rubrique#

\n

Une chaîne indiquant l’emplacement de la bibliothèque C GeoIP. Typiquement, ce réglage n’est utilisé que si la bibliothèque C GeoIP ne se trouve pas à un emplacement standard (par ex. /home/sue/lib/libGeoIP.so).

\n
\n
\n

GEOIP_COUNTRYLien vers cette rubrique#

\n

Le nom de base à utiliser pour le fichier de données des pays GeoIP. 'GeoIP.dat' 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. 'GeoLiteCity.dat' par défaut.

\n
\n
\n
\n

L’API GeoIPLien vers cette rubrique#

\n
\n
\nclass GeoIP(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 (.dat) 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, acceptant les valeurs nombre entier 0, 1, 2, 4 correspondant respectivement aux réglages GeoIPOptions de l’API C : GEOIP_STANDARD, GEOIP_MEMORY_CACHE, GEOIP_CHECK_CACHE et GEOIP_INDEX_CACHE. La valeur par défaut est 0 (GEOIP_STANDARD).

country

Le nom du fichier de données des pays GeoIP. La valeur par défaut est GeoIP.dat. 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 GeoLiteCity.dat. L’attribution d’une valeur à ce paramètre surcharge la valeur du réglage GEOIP_CITY.

\n
\n
\n
\n

Méthodes GeoIPLien vers cette rubrique#

\n
\n

InterrogationLien vers cette rubrique#

\n

Toutes les routines d’interrogation suivantes acceptent soit une chaîne d’adresse IP ou un nom de domaine entièrement qualifié (FQDN). Par exemple, '205.186.163.125' et 'djangoproject.com' sont tous deux des paramètres d’interrogation valides.

\n
\n
\nGeoIP.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
\nGeoIP.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
\nGeoIP.country_code(query)Lien vers cette définition#
\n
\n\n

Ne renvoie que le code de pays correspondant à la requête donnée.

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

Ne renvoie que le nom de pays correspondant à la requête donnée.

\n
\n
\n

Obtention de coordonnéesLien vers cette rubrique#

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

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

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

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

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

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

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

Renvoie un objet django.contrib.gis.geos.Point correspondant à la requête.

\n
\n
\n

Informations de base de donnéesLien vers cette rubrique#

\n
\n
\nGeoIP.country_infoLien vers cette définition#
\n
\n\n

Cette propriété renvoie des informations sur la base de données des pays GeoIP.

\n
\n
\nGeoIP.city_infoLien vers cette définition#
\n
\n\n

Cette propriété renvoie des informations sur la base de données des villes GeoIP.

\n
\n
\nGeoIP.infoLien vers cette définition#
\n
\n\n

Cette propriété renvoie des informations sur toutes les bases de données GeoIP (villes et pays), ainsi que sur la version de la bibliothèque C GeoIP (si pris en charge).

\n
\n
\n

Méthodes de compatibilité d’API GeoIP-PythonLien vers cette rubrique#

\n

Ces méthodes existent pour simplifier la compatibilité avec du code utilisant l’API Python existante de MaxMind.

\n
\n
\nclassmethod GeoIP.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
\nGeoIP.region_by_addr(query)Lien vers cette définition#
\n
\n\n
\n
\nGeoIP.region_by_name(query)Lien vers cette définition#
\n
\n\n
\n
\nGeoIP.record_by_addr(query)Lien vers cette définition#
\n
\n\n
\n
\nGeoIP.record_by_name(query)Lien vers cette définition#
\n
\n\n
\n
\nGeoIP.country_code_by_addr(query)Lien vers cette définition#
\n
\n\n
\n
\nGeoIP.country_code_by_name(query)Lien vers cette définition#
\n
\n\n
\n
\nGeoIP.country_name_by_addr(query)Lien vers cette définition#
\n
\n\n
\n
\nGeoIP.country_name_by_name(query)Lien vers cette définition#
\n
\n\n

Notes de bas de page

\n\n
\n
","rootId":"module-django.contrib.gis.geoip","toc":[{"title":"Exemple","anchor":"example","children":[]},{"title":"Les réglages GeoIP","anchor":"geoip-settings","children":[{"title":"GEOIP_PATH","anchor":"geoip-path","children":[]},{"title":"GEOIP_LIBRARY_PATH","anchor":"geoip-library-path","children":[]},{"title":"GEOIP_COUNTRY","anchor":"geoip-country","children":[]},{"title":"GEOIP_CITY","anchor":"geoip-city","children":[]}]},{"title":"L’API GeoIP","anchor":"geoip-api","children":[]},{"title":"Méthodes GeoIP","anchor":"geoip-methods","children":[{"title":"Interrogation","anchor":"querying","children":[]},{"title":"Obtention de coordonnées","anchor":"coordinate-retrieval","children":[]},{"title":"Informations de base de données","anchor":"database-information","children":[]},{"title":"Méthodes de compatibilité d’API GeoIP-Python","anchor":"geoip-python-api-compatibility-methods","children":[]}]}],"breadcrumbs":[{"docname":"ref/index","title":"Référence de l’API","url":"/fr/1.10/ref/"},{"docname":"ref/contrib/index","title":"Paquets contrib","url":"/fr/1.10/ref/contrib/"},{"docname":"ref/contrib/gis/index","title":"GeoDjango","url":"/fr/1.10/ref/contrib/gis/"}],"prev":{"docname":"ref/contrib/gis/gdal","title":"API de GDAL","url":"/fr/1.10/ref/contrib/gis/gdal/"},"next":{"docname":"ref/contrib/gis/geoip2","title":"Géolocalisation avec GeoIP2","url":"/fr/1.10/ref/contrib/gis/geoip2/"},"formats":{"html":"/fr/1.10/ref/contrib/gis/geoip/","markdown":"/fr/1.10/ref/contrib/gis/geoip.md","json":"/fr/1.10/ref/contrib/gis/geoip.json"},"source":"https://github.com/django/django/blob/stable/1.10.x/docs/ref/contrib/gis/geoip.txt","official":"https://docs.djangoproject.com/fr/1.10/ref/contrib/gis/geoip/","inVersions":["1.11","1.10","1.9"],"inLocales":["en","fr","ja","id","pt-br","es","el","pl"]}