Uso della classificazione per visualizzare i risultati della ricerca di entità
Avviso
Il 30 ottobre 2020 le API Ricerca Bing sono state spostate dai servizi di intelligenza artificiale di Azure ai servizi di Ricerca Bing. Questa documentazione viene fornita solo per riferimento. Per la documentazione aggiornata, vedere la documentazione dell'API ricerca Bing. Per istruzioni sulla creazione di nuove risorse di Azure per la ricerca Bing, vedere Creare una risorsa Ricerca Bing tramite il Azure Marketplace.
La risposta di ogni ricerca di entità include una risposta RankingResponse che specifica come devono essere visualizzati i risultati della ricerca restituiti dall'API Ricerca entità Bing. La risposta di classificazione raggruppa i risultati in contenuto prominente, principale e della barra laterale. Il risultato prominente è il risultato più importante o significativo e deve essere visualizzato per primo. Se i risultati rimanenti non vengono visualizzati in un formato di contenuto principale e della barra laterale tradizionale, è necessario dare al contenuto principale una maggiore visibilità rispetto al contenuto della barra laterale.
All'interno di ogni gruppo, la matrice Items 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 (Entity o Place) e resultIndex identifica un risultato all'interno di tale risposta (ad esempio, un'entità). L'indice è in base 0. |
value |
value Contiene un ID che corrisponde all'ID di una risposta o di un risultato all'interno della risposta. L'ID è incluso nel riscontro o nei risultati, ma non in entrambi. |
L'uso di answerType e resultIndex è un processo in due passaggi. Innanzitutto, usare answerType per identificare la risposta contenente i risultati da visualizzare. Usare quindi resultIndex per indicizzare i risultati della risposta e ottenere il risultato da visualizzare. Il answerType valore è 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 resultIndex campo.
Per usare l'ID è necessario che l'ID di classificazione corrisponda all'ID di una risposta o a uno dei risultati. Se un oggetto riscontro include un campo id, tutti i risultati del riscontro vengono visualizzati insieme. Ad esempio, se l'oggetto Entities include il campo id, gli articoli di tutte le entità vengono visualizzati insieme. Se l'oggetto Entities non include il campo id, ogni entità conterrà un campo id e la risposta di classificazione combinerà le entità con i risultati di Places.
Esempio di risposta di classificazione
Di seguito viene illustrato un esempio di 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 visualizza i due risultati di entità correlati a Jimi Hendrix.