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 trois pays. La Base Adresse Nationale est, par nature, limitée à la France.

Les données sont mises à jour régulièrement, sans interruption de service : la bascule vers les nouvelles données se fait 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.