GeonymAPI (expérimentation !)

Implémentation minimaliste d'une API de conversion geonym <-> lat/lon disponible sur http://api.geonym.fr/

L'API repose sur le module python Falcon, et un module geonym.py (utilisable hors API par tout script python).

ATTENTION : les geonym actuellement calculés peuvent évoluer. Cette implémentation a pour but de tester le concept et les paramètres de grille seront fixés officiellement et définitivement à l'issu de celle-ci. Ils pourront donc changer !

À propos des Géonym

Communiquer la position d'un lieu se fait en général par une adresse, mais en l'absence d'adresse on ne peut que recourir aux coordonnées GPS peut faciles à mémoriser et trop variables dans leurs formats (dégrés, dégrés+minutes, dégrés+minutes+secondes, etc).

Afin de combler ces deux manques, une position géographique peut être traduite en une série de caractères, mémorisable et facile à communiquer.

Contrairement à d'autres solutions, Géonym est LIBRE, basé sur un algorithme sous licence LGPL (openpostcode) et ne dépendant pas d'une API. Le calcul est simple et peut se faire directement côté client.

Comment ça marche ?

Une grille fixe est choisie pour une région donnée. Dans notre cas cette grille correspond à la France métropolitaine et englobe la majeure partie des eaux territoriales.

Elle est découpée en 25 zones de (5 x 5), elles mêmes découpées en 25 et ainsi de suite. Voir: http://www.geonym.fr/visu pour visualiser les zones et le fonctionnement (n'hésitez pas à zoomer).

Le territoire couvert est ainsi découpé au final en milliards de carrés de 3m x 3m (plus de 60 milliards sur le territoire métropolitain). Pour les DOM, ceux-ci sont remis dans les zones 0,1,4 de la grille qui ne recouvrent pas de territoire métropolitain.

A chaque zone on fait correspondre un chiffre ou une consonne qui forme ainsi une série de caractères. Plus cette série est longue, plus le geonym correspond donc à une petite zone géographique (25 fois plus petite en surface, donc des côtés 5 fois plus petits).

P = zone de 234km x 234km
PP = zone de 47km x 47km inclue dans celle de 'P'
PP7 = zone de 9 x 9km inclue dans celle de 'PP'
...
PP7K-RF4V = zone de 3m x 3m correspondant à l'entrée de la Tour Mirabeau à Paris

Voir: http://www.geonym.fr/visu/#19/48.84687/2.27924

L'algorithme utilisé est identique à OpenPostcode (licence LGPL), avec un alphabet différent limités aux chiffres de 0 à 9 et aux consonnes non ambigües (0/D/O, 1/I, 2/Z, 4/A, 5/S, 6/G, 8/B). Un caractère de contrôle peut s'ajouter en option pour vérifier que le geonym est sans erreur.

Installation

git clone https://github.com/geonym/geonymapi.git

pour installer les modules pythons nécessaires:

pip install -r requirements.txt

L'idéal est de fonctionner dans un virtualenv python3.

Test / serveur

gunicorn geonymapi:app -b 0.0.0.0:1405 -w 4

ou pour fonctionner en daemon avec rechargement automatique lorsque le code est modifié:

gunicorn geonymapi:app -b 0.0.0.0:1405 -w 4 --reload -D

Utilisation de l'API

Conversion geonym > lat/lon:

Conversion lat/lon > geonym:

http://api.geonym.fr/?lat=48.8&lon=2.35

Conversion X/Y lambert > geonym:

http://api.geonym.fr/?x=647095&y=6860995

Conversion adresse > geonym via géocodage intermédiaire:

http://api.geonym.fr/?adresse=39+quai+andré+citroen+paris

Réponse au format geojson:

geometry polygone correspondant à la zone couverte par le geonym
north/west/south/east sont les limites du geonym
lat/lon correspond au centre de la bbox du geonym
X/Y correspond au coordonnées Lambert 93 du centre de la bbox du geonym
link lien pour visualiser la zone couverte par le geonym sur un fond de carte
params contient les paramètres de la grille (alphabet et limites géographiques)
geocode contient la réponse du géocodeur
reverse si reverse=yes passé en paramètre de la requête contient l'adresse la plus proche trouvée par géocodage inversé.

{
    "link": "http://www.geonym.fr/visu/?g=PP7KRF4R",
    "params": {
        "alpha": "456783NPR92MXTC1LWVD0KJHF",
        "max_lat": 51.45,
        "min_lat": 40.91,
        "max_lon": 9.8,
        "min_lon": -5.45
    },
    "properties": {
        "north": 48.85509719552,
        "south": 48.855091799040004,
        "east": 2.283660032,
        "west": 2.283652224,
        "lat": 48.85509449728001,
        "lon": 2.2836561279999996,
        "geonym": "PP7K-RF4R",
        "checksum": "N"
    },
    "reverse": {
        "attribution": "BAN",
        "features": [
            {
                "geometry": {
                    "coordinates": [
                        2.283656,
                        48.85484
                    ],
                    "type": "Point"
                },
                "properties": {
                    "city": "Paris",
                    "citycode": "75116",
                    "context": "75, Île-de-France",
                    "distance": 28,
                    "id": "75116_7801_83b2f0",
                    "label": "Avenue du Président Kennedy 75016 Paris",
                    "name": "Avenue du Président Kennedy",
                    "postcode": "75016",
                    "score": 0.9999996800731467,
                    "type": "street"
                },
                "type": "Feature"
            }
        ],
        "licence": "ODbL 1.0",
        "limit": 1,
        "source": "http://api-adresse.data.gouv.fr",
        "type": "FeatureCollection",
        "version": "draft"
    },
    "geometry": {
        "coordinates": [
            [
                [
                    2.283652224,
                    48.855091799040004
                ],
                [
                    2.283660032,
                    48.855091799040004
                ],
                [
                    2.283660032,
                    48.85509719552
                ],
                [
                    2.283652224,
                    48.85509719552
                ],
                [
                    2.283652224,
                    48.855091799040004
                ]
            ]
        ],
        "type": "Polygon"
    },
    "type": "Feature"
}

geonym / geonymapi