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 uniquement pour référence. 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 afficher les résultats de recherche retournés par l’API Recherche d’entités Bing. Les groupes de réponses de classement se répartissent en contenu principal, contenu central et contenu de barre latérale. Le résultat principal est le résultat le plus important ou le plus en vue et doit être affiché en premier. Si vous n’affichez pas les résultats restants dans un format de ligne principale et de barre latérale traditionnelle, vous devez fournir la visibilité du contenu de ligne principale plus élevée que le contenu de la barre latérale.

Dans chaque groupe, l'Éléments tableau identifie l’ordre dans lequel le contenu doit apparaître. Chaque élément fournit deux façons d’identifier le résultat dans une réponse.

Champ	Description
answerType et resultIndex	answerType identifie la réponse (entité ou emplacement) et resultIndex identifie un résultat dans cette réponse (par exemple, une entité). L’index commence à 0.
value	value Contient un ID qui correspond à l’ID d’une réponse ou d’un résultat dans la réponse. La réponse ou les résultats contiennent l’ID, mais pas les deux.

L’utilisation des 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. Utilisez ensuite resultIndex pour indexer les résultats de cette réponse pour obtenir le résultat à afficher. (La valeur answerType est le 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.

L’utilisation de l’ID vous oblige à faire correspondre l’ID de classement avec l’ID d’une réponse ou l’un de ses résultats. Si un objet 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, chaque entité contient un champ id et la réponse de classement combine les entités avec les résultats Places.

Exemple de réponse de classement

L’exemple suivant montre 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"
          }
        }
      ]
    }
  }
}

En fonction de cette réponse de classement, la barre latérale afficherait les deux résultats relatifs aux entités liées à Jimi Hendrix.

Étapes suivantes

Créer une application web à page unique