GeoService

Trois moteurs, une seule API

Chaque service est exposé sous /v2 et renvoie la réponse du moteur dans son format d'origine. Vous pouvez donc vous appuyer sur les bibliothèques et la documentation existantes de chaque moteur.

Expérimental : les cellules H3 (moteur hexodos) donnent itinéraires et isochrones sous forme de cellules H3, à croiser avec vos propres indicateurs. Île-de-France seulement, et pas encore ouvert sur tous les serveurs.

Votre première requête en trois étapes

1. Obtenez votre clé d'API

   Galigeo vous fournit une clé personnelle. Elle accompagne chaque appel.

2. Envoyez une requête

   Passez la clé dans l'en-tête X-API-Key et appelez le service voulu.

3. Exploitez la réponse

   Du JSON ou du GeoJSON standard, prêt pour votre carte ou vos traitements.

curl -G "https://geoservice.example.com/v2/geocoding/ban/search" \
  -H "X-API-Key: $GEOSERVICE_KEY" \
  --data-urlencode "q=87 avenue d'Italie, Paris" \
  -d limit=1

const url = new URL("https://geoservice.example.com/v2/geocoding/ban/search");
url.search = new URLSearchParams({ q: "87 avenue d'Italie, Paris", limit: 1 });

const res = await fetch(url, { headers: { "X-API-Key": GEOSERVICE_KEY } });
const { features } = await res.json();
console.log(features[0].properties.label, features[0].geometry.coordinates);

import httpx

r = httpx.get(
    "https://geoservice.example.com/v2/geocoding/ban/search",
    params={"q": "87 avenue d'Italie, Paris", "limit": 1},
    headers={"X-API-Key": GEOSERVICE_KEY},
)
feature = r.json()["features"][0]
print(feature["properties"]["label"], feature["geometry"]["coordinates"])

La suite dans la prise en main : authentification, lecture des réponses et conventions de coordonnées.

Couverture géographique

Les itinéraires et le géocodage OSM couvrent la France métropolitaine, Corse comprise. Cette couverture peut être étendue sur demande, à l'outre-mer ou à d'autres pays, dans le cadre d'un hébergement sur serveur dédié. La Base Adresse Nationale reste, par nature, limitée aux adresses françaises.

Les données sont mises à jour régulièrement, sans interruption de service : les nouvelles données sont mises en service de façon transparente pour vos appels.

BAN ou OSM : quel géocodeur choisir ?

Les deux géocodeurs se complètent. En règle générale : une adresse postale française, c'est la BAN ; tout le reste, c'est OSM.