Aller au contenu principal

Bien démarrer

geocodeme.net est une API de géocodage et d'itinéraires sur données OpenStreetMap : adresses → coordonnées, coordonnées → adresses, itinéraires, isochrones, matrices et tuiles. Aucun SDK requis : une clé API et un client HTTP suffisent.

Fonctionnalités clés​

  • Géocodage direct, inverse et autocomplete : Europe + outre-mer français. Voir Couverture géographique.
  • Itinéraires, isochrones, matrices, map matching, snap-to-road et altimétrie : moteur Valhalla, profils car, bike, foot, truck et moto.
  • Réponses sous ~200 ms (p50) : un cache Redis de 24 h devant les moteurs, et des quotas exprimés en crédits pondérés plutôt qu'en nombre brut de requêtes.
  • Données OpenStreetMap répliquées en continu, région par région, et servies depuis une infrastructure hébergée en France.

Trois étapes vers votre première requête​

  1. Créez une clé API : créez un compte, puis générez une clé depuis votre tableau de bord. Détails dans Authentification.
  2. Faites votre première requête : un seul appel curl suffit (ci-dessous).
  3. Explorez la référence API : tous les endpoints, paramètres et formats de réponse sont dans la Référence API.

Première requête​

Passez votre clé dans l'en-tête X-Api-Key :

curl -H "X-Api-Key: gm_YOUR_API_KEY" \
  "https://api.geocodeme.net/v1/geocode?q=Alexanderplatz%2C%20Berlin&limit=1"

Lire la réponse​

L'API renvoie du JSON : coordonnées, nom affiché, score de pertinence et un bloc meta (durée, cache).

{
  "results": [
    {
      "lat": 52.5219,
      "lon": 13.4132,
      "name": "Alexanderplatz",
      "display_name": "Alexanderplatz, Mitte, Berlin, 10178, Deutschland",
      "type": "square",
      "importance": 0.61,
      "address": {
        "city": "Berlin",
        "state": "Berlin",
        "postcode": "10178",
        "country": "Deutschland",
        "country_code": "de"
      }
    }
  ],
  "attribution": "© OpenStreetMap contributors",
  "meta": {
    "took_ms": 142,
    "cache_hit": true
  }
}

Tous les endpoints suivent la même enveloppe : une clé de contenu (results, result, routes…), une chaîne attribution et un bloc meta. Les schémas champ par champ sont documentés endpoint par endpoint ; commencez par GET /v1/geocode.

Quotas en crédits

1 crédit = un géocodage, un inverse, un autocomplete ou un snap. Un itinéraire ou une altimétrie en vaut 2, une isochrone 10 ; les matrices et le map matching comptent par blocs de 25 entamés. Les tuiles ont leur propre compteur et n'entament jamais vos crédits. Plan Free : 3 000 crédits par jour. Tableau complet dans Crédits et quotas.

Attribution OpenStreetMap

Toute carte ou tout résultat que vous affichez doit créditer © OpenStreetMap contributors, et © OpenMapTiles si vous servez aussi nos tuiles. C'est l'unique obligation que la licence ODbL vous impose. Voir Licence et attribution.