Django_jdf is a Django application to help people who wants to performs smart search in the "Nominatim" database. Django_jdf is developped to be used by the "Geo-velo"'s website. Géovélo.
The goal of Django_jdf is to serve a geocoding service based on "Nominatim" upon a small area (e.g : City, Region, District, County, ... )
Currently, the only supported language (in search) is french language.
The name "Jour de Fête" ( aka JDF in this module) comes from a french film of Jacques Tati : in a small village, a postman wants to optimize his circuit.
Django_jdf est une application Django destinée à améliorer l'expérience utiliseur, en ce qui concerne les recherches effectuées en utilisant le base "Nominatim". Ce projet a été développé initialement pour le site Géovélo .
Le projet, volontairement, ne prend en charge que le français et la formalisation française des adresses. Pour des moteurs de recherche d'adresses sur des territoires plus vastes, il vaut mieux regarder vers des solutions telles que Photon. (bien que ce dernier soit en Java et non en Python)
Bien que développé pour pouvoir couvrir un petit territoire désirant utiliser un géocodeur, ou une recherche d'adresse avec auto-complétion, (ex: Département, communauté de communes, commune, ... ), Django_jdf peut sans problème servir de moteur de recherche d'adresse sur la France entière.
La base Nominatim n'est pas altérée. On lui adjoint seulement une table phonetique. Celle-ci sert à stocker une chaine phonétique (calculé par un SoundEx personnalisé : https://github.com/lluc/python_soundex_fr ) et un "poids" qui permet de hiérarchiser l'affichage des réponses.
Lors d'une recherche, Django_jdf renvoie une réponse au format JSON. C'est cette réponse qui pourra être utilisée dans une saisie avec auto-complétion.
Récupérer les sources sur Github :
git clone --recursive https://github.com/lluc/django_jdf.git
Pour installer les modules Django utilisés dans ce projet, consulter le fichier *requirements.txt". Il est possible d'installer automatiquement ces modules, en utilisant une commande du type :
pip install -r requirements.txt
Il n'y a pas de fichier settings.py ( dans le répertoire django_jdf ). A la place, on utilise le fichier local_settings.py. On appelle ce fichier en modifiant le source de manage.py, avec cette ligne :
os.environ.setdefault("DJANGO_SETTINGS_MODULE", "django_jdf.local_settings")
Suivant la situation (développement ou production) on fait appel à l'un de ces deux fichiers : devel_settings.py ou prod_settings.py. L'appel se fait au sein de local_settings.py au travers de ce type de commande :
-
pour les paramètres de développement :
from devel_settings import * -
pour les paramètres de production :
from prod_settings import *
Le fichier prod_settings.py pourrait être de la forme suivante :
DEBUG = False
ADMINS = (
# ('Your Name', 'your_email@example.com'),
)
DATABASES = {
'default': {
'ENGINE': 'django.db.backends.postgresql_psycopg2', # Add 'postgresql_psycopg2', 'mysql', 'sqlite3' or 'oracle'.
'NAME': 'nominatim', # Or path to database file if using sqlite3.
# The following settings are not used with sqlite3:
'USER': '******',
'PASSWORD': '******',
'HOST': '***.***.***.***', # Empty for localhost through domain sockets or '127.0.0.1' for localhost through TCP.
'PORT': '5432', # Set to empty string for default.
}
}
La génération concerne la production de données, au sein de la base Nominatim, pour pouvoir, ensuite, effectuer des requêtes phonétiques et sémantiques.
Cette génération d'effectue dans une console, sur le serveur.
On récupére dans OpenStreetMap le numéro de la relation de la limite administraive de la commune. Par exemple, pour la ville de Tours, ce sera l'identifiant 76306. Donc, pour effectuer la génération, on exécute la commande suivante ( en remplaçant les variables et ) :
python manage.py generation <user> <password> 62.210.146.189 76306
On peut utiliser ce type de commande pour tout type d'entité administrative qui est identifiée dans OpenStreetMap par une relation (département, région, arrondissement, ... )
Pour effacer la totalité des données contenues dans la table phonetique, exécuter la commande suivante :
python manage.py generation --reset <user> <password> 62.210.146.189
La génération globale concerne l'ensemble des entités administratives de niveau 8 (admin_level=8), contenues dans la base Nominatim. Elle s'effectue en utilisant l'identifiant all :
python manage.py generation <user> <password> 62.210.146.189 all
On utilise la biliothèque Django Rest Framework ( site ). Les sources de requêtages se trouvent dans le répertoire qui gère l'API : jdf_api
C'est le fichier views.py qui contient les requêtes à la base de données.
Cet appel peut-être effectué par tout logiciel client sous la forme suivante :
http://jdf.geovelo.fr/api/places/search/%QUERY/?format=json
%QUERY : requête de localisation. Par exemple :"rue de la vallée"
options :
- format=json : retourne le résultat au format JSON.
Fonction utilisée dans le source :
def search_place_name(request, place_name,option_strict=0):
place_name : nom de la localisation à rechercher. Cela peut être une adresse, un arrêt de bus, un point d'intérêt, ... Elle peut être de la forme "rue de la vallée", "Le Mans" ou bien "Gare Montparnasse"
option_strict : lorsqu'il est à 1, on ne prend en compte que les poids strictement inférieurs à 100. C'est-à-dire qu'on ne prend en compte que les éléments dont il est fait mention dans le fichier weight.csv.