Exemples

Des exemples de code prêts à l'emploi pour intégrer l'API geocodeme.net dans le langage de votre choix.

Avant de commencer

Tous les exemples supposent que vous disposez :

1. D'une clé API valide (obtenez-en une ici)
2. De la clé définie dans une variable d'environnement :

export GEOCODEME_API_KEY="gm_YOUR_KEY"

Géocodage direct

Convertir une adresse en coordonnées.

cURL

curl -H "X-Api-Key: $GEOCODEME_API_KEY" \
  "https://api.geocodeme.net/v1/geocode?q=1+rue+de+Rivoli+Paris&limit=1"

Python

import os
import requests

API_KEY = os.environ["GEOCODEME_API_KEY"]
BASE_URL = "https://api.geocodeme.net/v1"

response = requests.get(
    f"{BASE_URL}/geocode",
    params={"q": "1 rue de Rivoli, Paris", "limit": 1},
    headers={"X-Api-Key": API_KEY},
)
response.raise_for_status()

data = response.json()
location = data["results"][0]
print(f"{location['display_name']}: {location['lat']}, {location['lon']}")
print(data["attribution"])

JavaScript

const API_KEY = process.env.GEOCODEME_API_KEY;
const BASE_URL = "https://api.geocodeme.net/v1";

const response = await fetch(
  `${BASE_URL}/geocode?q=1+rue+de+Rivoli+Paris&limit=1`,
  { headers: { "X-Api-Key": API_KEY } }
);

if (!response.ok) {
  const error = await response.json();
  console.error(error.error.message);
  process.exit(1);
}

const data = await response.json();
const location = data.results[0];
console.log(`${location.display_name}: ${location.lat}, ${location.lon}`);
console.log(data.attribution);

Géocodage inverse

Convertir des coordonnées en adresse.

cURL

curl -H "X-Api-Key: $GEOCODEME_API_KEY" \
  "https://api.geocodeme.net/v1/reverse?lat=48.8566&lon=2.3522"

Python

response = requests.get(
    f"{BASE_URL}/reverse",
    params={"lat": 48.8566, "lon": 2.3522},
    headers={"X-Api-Key": API_KEY},
)
response.raise_for_status()

data = response.json()
if data["result"] is not None:
    print(data["result"]["display_name"])
print(data["attribution"])

JavaScript

const reverseResponse = await fetch(
  `${BASE_URL}/reverse?lat=48.8566&lon=2.3522`,
  { headers: { "X-Api-Key": API_KEY } }
);

if (!reverseResponse.ok) {
  const error = await reverseResponse.json();
  console.error(error.error.message);
  process.exit(1);
}

const reverseData = await reverseResponse.json();
if (reverseData.result !== null) {
  console.log(reverseData.result.display_name);
}
console.log(reverseData.attribution);

Champs optionnels

Le champ address est optionnel et peut être absent selon le résultat. Vérifiez toujours sa présence avant d'y accéder, par exemple location.get("address") en Python ou location.address?.city en JavaScript. Notez que /v1/reverse renvoie un objet result unique (ou null), tandis que /v1/geocode renvoie un tableau results.

Pages par langage

• JavaScript : avec fetch dans Node.js ou le navigateur
• Python : avec la bibliothèque requests
• PHP : avec curl_init() en PHP 7.4+
• cURL : exemples en ligne de commande pour tous les endpoints