Utilisation du classement pour afficher les résultats de la recherche d’entités
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.
Chaque réponse de recherche d’entité inclut une réponse RankingResponse qui spécifie comment vous devez afficher les résultats de recherche renvoyés par l’API Recherche d’entités Bing. La réponse de classement regroupe les résultats par pôle, principal et encadré. Le résultat en pôle est le plus important ou connu et doit être affiché en premier. Si vous n’affichez pas les résultats restants dans un format principal ou en encadré, vous devez fournir au contenu principal une visibilité supérieure à celui en encadré.
Au sein de chaque groupe, le tableau Éléments identifie l’ordre dans lequel doit apparaître le contenu. Chaque élément fournit deux façons d’identifier le résultat au sein d’une réponse.
| Champ | Description |
|---|---|
answerType et resultIndex |
answerType identifie la réponse (Entité ou Lieu) et resultIndex identifie un résultat au sein de la réponse (par exemple, une entité). L’index commence à 0. |
value |
value contient un identifiant qui correspond à l’identifiant de la réponse ou d’un résultat au sein de la réponse. La réponse ou les résultats contiennent l’identifiant, mais pas les deux. |
L’utilisation de answerType et resultIndex est un processus en deux étapes. Tout d’abord, utilisez answerType pour identifier la réponse qui contient les résultats à afficher. Ensuite, utilisez resultIndex pour indexer dans les résultats de cette réponse afin d’en afficher le résultat. (La valeur answerType correspond au nom du champ dans l’objet SearchResponse.) Si vous êtes censé afficher tous les résultats de la réponse ensemble, l’élément de réponse de classement n’inclut pas le champ resultIndex.
Vous devez faire correspondre l’ID du classement et l’ID d’une réponse (ou un de ses résultats) pour pouvoir utiliser cet ID. Si un objet de réponse inclut un champ id, affichez tous les résultats de la réponse ensemble. Par exemple, si l’objet Entities inclut le champ id, affichez tous les articles d’entités ensemble. Si l’objet Entities n’inclut pas le champ id, alors chaque entité comprend un champ id et la réponse de classement mélange les résultats d’entités avec les résultats de lieux.
Exemple de réponse de classement
Le code suivant vous fournit un exemple RankingResponse.
{
"_type": "SearchResponse",
"queryContext": {
"originalQuery": "Jimi Hendrix"
},
"entities": { ... },
"rankingResponse": {
"sidebar": {
"items": [
{
"answerType": "Entities",
"resultIndex": 0,
"value": {
"id": "https://www.bingapis.com/api/v7/#Entities.0"
}
},
{
"answerType": "Entities",
"resultIndex": 1,
"value": {
"id": "https://www.bingapis.com/api/v7/#Entities.1"
}
}
]
}
}
}
Selon cette réponse de classement, l’encadré devrait afficher les deux résultats d’entité associés à Jimi Hendrix.