API de géocodage

Convertissez des adresses et noms de lieux en coordonnées géographiques (géocodage direct) ou convertissez des coordonnées en adresses lisibles (géocodage inverse). Prend en charge les requêtes multilingues en français, arabe et anglais.

Géocodage direct

Convertissez une adresse ou un nom de lieu en coordonnées géographiques. L'API effectue une correspondance approximative et retourne les résultats classés par score de confiance.

GET/geocoding/forward

Géocodez une adresse ou un nom de lieu en coordonnées latitude/longitude

Paramètres

Paramètre	Type	Requis	Description
`q`	string	Requis	L'adresse ou le nom de lieu à géocoder(ex. Marche Capitale Nouakchott)
`language`	string	Facultatif	Langue de la réponse : fr, ar ou en(ex. fr)
`limit`	number	Facultatif	Nombre maximum de résultats à retourner (1-10, par défaut : 5)(ex. 3)

Exemple de requête

curl -X GET "https://api.oolel.com/geocoding/forward?q=Marche+Capitale+Nouakchott&language=fr&limit=3" \
  -H "Authorization: Bearer YOUR_API_KEY"

Exemple de réponse

{
  "results": [
    {
      "formatted": "Marche Capitale, Tevragh Zeina, Nouakchott, Mauritania",
      "latitude": 18.0858,
      "longitude": -15.9785,
      "confidence": 0.92,
      "type": "poi",
      "components": {
        "name": "Marche Capitale",
        "neighbourhood": "Tevragh Zeina",
        "city": "Nouakchott",
        "adminLevel1": "Nouakchott-Ouest",
        "country": "Mauritania",
        "countryCode": "MR"
      }
    },
    {
      "formatted": "Marche Capitale Annexe, Ksar, Nouakchott, Mauritania",
      "latitude": 18.0912,
      "longitude": -15.9734,
      "confidence": 0.74,
      "type": "poi",
      "components": {
        "name": "Marche Capitale Annexe",
        "neighbourhood": "Ksar",
        "city": "Nouakchott",
        "adminLevel1": "Nouakchott-Nord",
        "country": "Mauritania",
        "countryCode": "MR"
      }
    }
  ],
  "query": "Marche Capitale Nouakchott",
  "totalResults": 2
}

Géocodage inverse

Convertissez des coordonnées géographiques en adresse lisible. Retourne l'adresse ou le lieu connu le plus proche du point donné, ainsi que la distance en mètres.

GET/geocoding/reverse

Géocodage inverse des coordonnées vers l'adresse ou le lieu le plus proche

Paramètres

Paramètre	Type	Requis	Description
`latitude`	number	Requis	Latitude du point à géocoder inversement(ex. 18.0858)
`longitude`	number	Requis	Longitude du point à géocoder inversement(ex. -15.9785)
`language`	string	Facultatif	Langue de la réponse : fr, ar ou en(ex. fr)

Exemple de requête

curl -X GET "https://api.oolel.com/geocoding/reverse?latitude=18.0858&longitude=-15.9785&language=fr" \
  -H "Authorization: Bearer YOUR_API_KEY"

Exemple de réponse

{
  "result": {
    "formatted": "Marche Capitale, Tevragh Zeina, Nouakchott, Mauritania",
    "latitude": 18.0858,
    "longitude": -15.9785,
    "distance": 12.4,
    "components": {
      "name": "Marche Capitale",
      "neighbourhood": "Tevragh Zeina",
      "city": "Nouakchott",
      "adminLevel1": "Nouakchott-Ouest",
      "country": "Mauritania",
      "countryCode": "MR"
    }
  },
  "query": {
    "latitude": 18.0858,
    "longitude": -15.9785
  }
}