Uso della classificazione per visualizzare i risultati della ricerca di entità

Avvertimento

Il 30 ottobre 2020, le API di ricerca Bing sono state spostate dai servizi di intelligenza artificiale di Azure ai servizi di ricerca Bing. Questa documentazione è disponibile solo per riferimento. Per la documentazione aggiornata, vedere la Documentazione dell'API di Ricerca Bing. Per istruzioni sulla creazione di nuove risorse di Azure per Ricerca Bing, vedere Creare una risorsa di Ricerca Bing tramite Azure Marketplace.

Ogni risposta di ricerca di entità include una risposta RankingResponse che specifica come visualizzare i risultati della ricerca restituiti dall'API Ricerca entità Bing. I gruppi di risposte della classificazione organizzano i risultati in contenuti principali, di linea principale e della barra laterale. Il risultato del pole è il risultato più importante o predominante e deve essere visualizzato per primo. Se non vengono visualizzati i risultati rimanenti in un formato mainline e barra laterale tradizionale, è necessario fornire maggiore visibilità del contenuto della riga principale rispetto al contenuto della barra laterale.

All'interno di ogni gruppo, la matrice elementi identifica l'ordine in cui deve essere visualizzato il contenuto. Ogni elemento offre due modi per identificare il risultato all'interno di una risposta.

Campo	Descrizione
answerType e resultIndex	answerType identifica la risposta (entità o luogo) e resultIndex identifica un risultato all'interno di tale risposta (ad esempio, un'entità). L'indice inizia da 0.
value	value Contiene un ID che corrisponde all'ID di una risposta o di un risultato all'interno della risposta. La risposta o i risultati contengono l'ID, ma non entrambi.

L'uso del answerType e resultIndex è un processo in due passaggi. Usare prima di tutto answerType per identificare la risposta contenente i risultati da visualizzare. Usare quindi resultIndex per indicizzare i risultati di tale risposta per ottenere il risultato da visualizzare. Il valore answerType è il nome del campo nell'oggetto SearchResponse. Se si prevede di visualizzare tutti i risultati della risposta insieme, l'elemento della risposta di classificazione non include il campo resultIndex.

L'uso dell'ID richiede la corrispondenza dell'ID di classificazione con l'ID di una risposta o uno dei relativi risultati. Se un oggetto risposta include un campo id, visualizzare tutti i risultati della risposta insieme. Ad esempio, se l'oggetto Entities include il campo id, visualizzare tutti gli articoli delle entità insieme. Se l'oggetto Entities non include il campo id, ogni entità contiene un campo id e la risposta di classificazione combina le entità con i risultati dei Luoghi.

Esempio di risposta di classificazione

Di seguito viene illustrato un esempio 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"
          }
        }
      ]
    }
  }
}

In base alla risposta di classificazione, la barra laterale visualizzerebbe i due risultati delle entità correlati a Jimi Hendrix.

Passaggi successivi

Creare un'app Web a pagina singola