En bref. Brave détecte automatiquement la recherche locale à partir des données de localisation documentées, sauf si enable_local définit explicitement le réglage.

Définition : Brave LLM Context utilise la recherche locale (local recall) pour les requêtes liées à une localisation lorsque enable_local reste à null et que la requête fournit un contexte de localisation. Il est aussi possible de définir enable_local=true pour demander explicitement une recherche locale, ou de lui attribuer la valeur false pour conserver le classement web standard.

Points clés

Brave présente LLM Context comme une API qui renvoie du contenu préextrait pour les agents IA, l’ancrage des LLM et les chaînes RAG dans sa documentation LLM Context.
Le paramètre enable_local accepte true, false ou null ; en l’absence de valeur, l’API détermine automatiquement si la recherche doit être locale à partir des en-têtes de localisation, selon la référence de l’API GET.
La référence GET désigne X-Loc-Lat associé à X-Loc-Long, ou X-Loc-City, comme les données de localisation utilisées pour cette détection automatique.
Lorsque la recherche locale est active, la réponse peut inclure des données de points d’intérêt et des données cartographiques en plus du tableau de résultats generic.

Comment s’effectue le basculement ?

Le paramètre de requête est enable_local. Sa valeur par défaut est null, ce qui signifie que Brave décide à partir du contexte de la requête. En présence d’un contexte de localisation, le mécanisme de détection automatique décrit dans la documentation utilise la recherche locale. Avec enable_local=true, la requête demande explicitement une recherche locale. Avec enable_local=false, elle sélectionne explicitement le classement web standard, même en présence d’en-têtes de localisation.

La référence de l’API décrit deux déclencheurs possibles pour la détection automatique : une paire de coordonnées, X-Loc-Lat associé à X-Loc-Long, ou l’en-tête de ville, X-Loc-City. La documentation du service énonce une règle plus large : la recherche locale s’active automatiquement en présence d’en-têtes de localisation. La formulation plus précise de la référence de l’API fournit le critère utile pour tester l’implémentation d’un client.

Quels en-têtes fournissent le contexte de localisation ?

Brave documente sept en-têtes de localisation pour LLM Context : latitude, longitude, ville, code de l’État, nom de l’État, pays et code postal. Les en-têtes de coordonnées utilisent des coordonnées géographiques décimales. La référence de l’API indique une plage de latitude de -90.0 à 90.0 degrés et une plage de longitude de -180.0 à 180.0 degrés. Les en-têtes de noms de lieux transmettent des informations sur la ville, la région, le pays ou le code postal.

La documentation du service indique que les coordonnées seules suffisent généralement. Lorsqu’elles ne sont pas disponibles, elle recommande de fournir les en-têtes de noms de lieux dont dispose le client. Voici son exemple de localisation :

curl -X GET "https://api.search.brave.com/res/v1/llm/context" \
  -H "X-Subscription-Token: <YOUR_API_KEY>" \
  -H "X-Loc-Lat: 37.7749" \
  -H "X-Loc-Long: -122.4194" \
  -G \
  --data-urlencode "q=best coffee shops near me"

Que contient une réponse locale ?

LLM Context organise habituellement le contenu web extrait dans grounding.generic. Lorsque la recherche locale est activée, Brave documente un objet facultatif grounding.poi et un tableau grounding.map. Un élément de point d’intérêt peut contenir un nom, une URL, un titre et des extraits. Un élément cartographique comporte les mêmes champs documentés pour un lieu. Le tableau standard generic reste présent dans le modèle de réponse : la recherche locale ajoute donc au contexte web des champs relatifs aux lieux, tout en conservant la structure habituelle du contexte.

La référence de l’API présente les champs POI et cartographiques comme des données susceptibles d’être renvoyées lorsque enable_local est activé. La documentation décrit donc leur présence comme conditionnelle, sans en faire un résultat systématique pour chaque requête locale.

Comment un client doit-il choisir le réglage ?

Le paramètre enable_local reste sans valeur lorsque le client souhaite laisser Brave déduire l’intention locale du contexte de localisation fourni. La valeur true demande une recherche locale sans dépendre de la détection automatique. La valeur false convient lorsque le client a besoin du classement web standard malgré la présence d’en-têtes de localisation. Le point de terminaison accepte les requêtes GET et POST, et la documentation du service montre ce paramètre dans la chaîne de requête d’une requête GET.

Termes associés

Questions fréquentes

Un en-tête de ville active-t-il la recherche locale ?

La référence GET de Brave indique que X-Loc-City suffit comme donnée de localisation pour activer automatiquement la recherche locale. La documentation du service répertorie également la ville parmi les en-têtes de localisation pris en charge.

La latitude et la longitude sont-elles toutes deux nécessaires ?

Pour la détection automatique, la référence GET associe X-Loc-Lat et X-Loc-Long en une paire. La documentation du service indique que ces coordonnées seules suffisent généralement.

Peut-on forcer la recherche locale sans en-têtes de localisation ?

Oui. La documentation du service de Brave montre enable_local=true dans la chaîne de requête, sans en-têtes de localisation. La même page présente ce réglage comme une activation explicite de la recherche locale.

La recherche locale renvoie-t-elle toujours un résultat de lieu ?

Non. La référence de l’API indique que des données POI et cartographiques peuvent être renvoyées lorsque la recherche locale est activée. La réponse peut toujours contenir le tableau standard grounding.generic.

Sources

Vérifiez comment une page se lit pour les moteurs de réponse. Ouvrir l’analyseur de score GEO

Quand Brave LLM Context passe-t-il aux résultats de recherche locale ?