Utilisation de marqueurs d’ornement pour mettre en surbrillance un texte
Avertissement
Le 30 octobre 2020, les API de recherche Bing sont passées des services Azure AI aux services de recherche Bing. Cette documentation est fournie à des fins de référence uniquement. Pour accéder à la documentation mise à jour, consultez la documentation de l’API Recherche Bing. Pour obtenir des instructions sur la création de nouvelles ressources Azure pour Recherche Bing, consultez Créer une ressource Recherche Bing à l’aide de Place de marché Azure.
Bing prend en charge la mise en surbrillance des correspondances qui marque les termes de requête (ou d’autres termes que Bing estime pertinents) dans les chaînes d’affichage de certaines réponses. Par exemple, les champs name, displayUrl et snippet des résultats d’une page web peuvent contenir des termes de requête marqués.
Par défaut, Bing n’inclut pas les marqueurs de mise en surbrillance dans les chaînes d’affichage. Pour activer les marqueurs, ajoutez le paramètre de requête textDecorations à votre requête et définissez-le sur true.
Exemple de mise en surbrillance des correspondances
L’exemple suivant montre les résultats web de Sailing Dinghy. Bing marque le début et la fin du terme de requête à l’aide des caractères Unicode E000 et E001.
Avant d’afficher le résultat dans votre interface utilisateur, remplacez les caractères Unicode par des caractères adaptés à votre format d’affichage.
Mise en forme des marqueurs
Bing vous offre la possibilité d’utiliser des caractères Unicode ou des balises HTML en tant que marqueurs. Pour spécifier les marqueurs à utiliser, ajoutez le paramètre de requête textFormat :
| Valeur | Marqueur |
|---|---|
textFormat=Raw |
Caractères Unicode (par défaut) |
textFormat=HTML |
Caractères HTML |
Autres ornements de texte
Bing peut retourner plusieurs ornements de texte différents. Par exemple, le champ expression d’une réponse Computation peut contenir des marqueurs d’indice pour le terme de requête log(2).
Si la requête n’a pas spécifié d’ornements, le champ expression contient log10(2).
Si textDecorations est true, Bing peut inclure les marqueurs suivants dans les chaînes d’affichage des réponses. S’il n’existe pas de balise HTML équivalente, la cellule du tableau sera vide.
| Unicode | HTML | Description |
|---|---|---|
| U+E000 | <b> | Marque le début du terme de requête (mise en surbrillance des correspondances) |
| U+E001 | </b> | Marque la fin du terme de requête |
| U+E002 | <i> | Marque le début du contenu en italique |
| U+E003 | </i> | Marque la fin du contenu en italique |
| U+E004 | <br/> | Marque un saut de ligne |
| U+E005 | Marque le début d’un numéro de téléphone | |
| U+E006 | Marque la fin d’un numéro de téléphone | |
| U+E007 | Marque le début d’une adresse | |
| U+E008 | Marque la fin d’une adresse | |
| U+E009 | Marque une espace insécable | |
| U+E00C | <strong> | Marque le début du contenu en gras |
| U+E00D | </strong> | Marque la fin du contenu en gras |
| U+E00E | Marque le début du contenu dont l’arrière-plan doit être plus clair que son arrière-plan qui l’entoure | |
| U+E00F | Marque la fin du contenu dont l’arrière-plan doit être plus clair que son arrière-plan qui l’entoure | |
| U+E010 | Marque le début du contenu dont l’arrière-plan doit être plus foncé que son arrière-plan qui l’entoure | |
| U+E011 | Marque la fin du contenu dont l’arrière-plan doit être plus foncé que son arrière-plan qui l’entoure | |
| U+E012 | <del> | Marque le début du contenu qui doit être barré |
| U+E013 | </del> | Marque la fin du contenu qui doit être barré |
| U+E016 | <sub> | Marque le début du contenu en indice |
| U+E017 | </sub> | Marque la fin du contenu en indice |
| U+E018 | <sup> | Marque le début du contenu en exposant |
| U+E019 | </sup> | Marque la fin du contenu en exposant |