API de recherche

Recherche plein texte de lieux, commerces et adresses en Afrique de l'Ouest. Alimentée par PostGIS avec classement par proximité, l'API de recherche retourne les résultats les plus pertinents près d'un emplacement donné.

Rechercher des lieux

Recherchez parmi tous les lieux, commerces et adresses indexés. Lorsque la latitude et la longitude sont fournies, les résultats sont classés par une combinaison de pertinence textuelle et de proximité géographique. Sans coordonnées, les résultats sont classés par pertinence textuelle uniquement.

GET/search

Recherche plein texte de lieux, adresses et commerces avec classement optionnel par proximité

Paramètres

Paramètre	Type	Requis	Description
`q`	string	Requis	Requête de recherche pour les lieux, adresses ou commerces(ex. pharmacie Nouakchott)
`latitude`	number	Facultatif	Latitude pour le classement par proximité. Les résultats plus proches de ce point sont mieux classés.(ex. 18.0858)
`longitude`	number	Facultatif	Longitude pour le classement par proximité. Doit être fournie avec la latitude.(ex. -15.9785)
`limit`	number	Facultatif	Nombre maximum de résultats (1-50, par défaut : 10)(ex. 10)
`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/search?q=pharmacie&latitude=18.0858&longitude=-15.9785&limit=5&language=fr" \
  -H "Authorization: Bearer YOUR_API_KEY"

Exemple de réponse

{
  "results": [
    {
      "id": "addr_a1b2c3d4",
      "name": "Pharmacie Centrale",
      "formatted": "Pharmacie Centrale, Ave Gamal Abdel Nasser, Tevragh Zeina, Nouakchott",
      "latitude": 18.0862,
      "longitude": -15.9781,
      "distance": 52.3,
      "type": "business",
      "category": "pharmacy",
      "components": {
        "street": "Avenue Gamal Abdel Nasser",
        "neighbourhood": "Tevragh Zeina",
        "city": "Nouakchott",
        "country": "Mauritania"
      }
    },
    {
      "id": "addr_e5f6g7h8",
      "name": "Pharmacie Ibn Sina",
      "formatted": "Pharmacie Ibn Sina, Ksar, Nouakchott",
      "latitude": 18.0891,
      "longitude": -15.9723,
      "distance": 734.1,
      "type": "business",
      "category": "pharmacy",
      "components": {
        "neighbourhood": "Ksar",
        "city": "Nouakchott",
        "country": "Mauritania"
      }
    },
    {
      "id": "addr_i9j0k1l2",
      "name": "Grande Pharmacie du Sahel",
      "formatted": "Grande Pharmacie du Sahel, Ilot K, Nouakchott",
      "latitude": 18.0795,
      "longitude": -15.9692,
      "distance": 1203.8,
      "type": "business",
      "category": "pharmacy",
      "components": {
        "neighbourhood": "Ilot K",
        "city": "Nouakchott",
        "country": "Mauritania"
      }
    }
  ],
  "query": "pharmacie",
  "totalResults": 3,
  "limit": 5
}

Conseils de recherche

Classement par proximité

Fournissez toujours la latitude et la longitude lorsque la position de l'utilisateur est connue. Cela améliore considérablement la pertinence des résultats en privilégiant les résultats géographiquement plus proches de l'utilisateur.

Requêtes multilingues

L'index de recherche inclut les noms en français, arabe et anglais. Vous pouvez rechercher dans n'importe quelle langue indépendamment du paramètre language. Le paramètre de langue n'affecte que le format de la réponse.

Types de résultats

Les résultats incluent un champ type qui peut être "address", "business", "poi" (point d'intérêt) ou "admin" (limite administrative). Utilisez-le pour filtrer ou regrouper les résultats dans votre interface.