Geocoding API

Convert addresses and place names to geographic coordinates (forward geocoding) or convert coordinates back to human-readable addresses (reverse geocoding). Supports multilingual queries in French, Arabic, and English.

Forward Geocoding

Convert an address or place name into geographic coordinates. The API performs fuzzy matching and returns results ranked by confidence score.

GET/geocoding/forward

Geocode an address or place name to latitude/longitude coordinates

Parameters

Parameter	Type	Required	Description
`q`	string	Required	The address or place name to geocode(e.g. Marche Capitale Nouakchott)
`language`	string	Optional	Response language: fr, ar, or en(e.g. fr)
`limit`	number	Optional	Maximum number of results to return (1-10, default: 5)(e.g. 3)

Example Request

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

Example Response

{
  "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
}

Reverse Geocoding

Convert geographic coordinates into a human-readable address. Returns the nearest known address or place to the given point, along with the distance in meters.

GET/geocoding/reverse

Reverse geocode coordinates to the nearest address or place

Parameters

Parameter	Type	Required	Description
`latitude`	number	Required	Latitude of the point to reverse geocode(e.g. 18.0858)
`longitude`	number	Required	Longitude of the point to reverse geocode(e.g. -15.9785)
`language`	string	Optional	Response language: fr, ar, or en(e.g. fr)

Example Request

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

Example Response

{
  "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
  }
}