Termini della query suggeriti

  • Articolo

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.

L'API Suggerimenti automatici Bing viene generalmente chiamata ogni volta che un utente digita un nuovo carattere nella casella di ricerca dell'applicazione. La completezza della stringa di query influisce sulla pertinenza dei termini di query suggeriti che vengono restituiti dall'API. Più completa è la stringa di query, più rilevante è l'elenco dei termini di query suggeriti. Ad esempio, i suggerimenti che l'API può restituire per s sono probabilmente meno pertinenti di quelli restituiti dalla query per sailing dinghies.

Richiesta di esempio

L'esempio seguente illustra una richiesta che restituisce le stringhe di query suggerite per sail. Ricordarsi di codificare nell'URL il termine della query parziale dell'utente quando si imposta il parametro della query q. Se ad esempio l'utente ha immesso sailing les, impostare q su sailing+les o sailing%20les.

GET https://api.cognitive.microsoft.com/bing/v7.0/suggestions?q=sail&mkt=en-us HTTP/1.1
Ocp-Apim-Subscription-Key: 123456789ABCDE
X-MSEdge-ClientIP: 999.999.999.999
X-Search-Location: lat:47.60357;long:-122.3295;re:100
X-MSEdge-ClientID: <blobFromPriorResponseGoesHere>
Host: api.cognitive.microsoft.com

La risposta seguente contiene un elenco di oggetti SearchAction contenenti i termini della query suggerita.

{
    "url" : "https:\/\/www.bing.com\/search?q=sailing+lessons+seattle&FORM=USBAPI",
    "displayText" : "sailing lessons seattle",
    "query" : "sailing lessons seattle",
    "searchKind" : "WebSearch"
}, ...

Uso di termini di query suggeriti

Ogni suggerimento include i campi displayText, query e url. Il campo displayText contiene la query suggerita che si usa per popolare l'elenco a discesa della casella di ricerca. È necessario visualizzare tutti i suggerimenti inclusi nella risposta, nell'ordine indicato.

L'esempio seguente mostra una casella di ricerca a discesa con i termini di query suggeriti dall'API Suggerimenti automatici Bing.

Elenco di casella di ricerca con elenco a discesa di suggerimenti automatici

Se l'utente seleziona una query suggerita dall'elenco a discesa, è possibile usare il termine di query nel campo query per chiamare l'API Ricerca Web Bing e visualizzare i risultati. Oppure è possibile usare l'URL nel campo url per inviare l'utente alla pagina dei risultati della ricerca di Bing.

Passaggi successivi