Uso degli indicatori di effetto per evidenziare il testo

Avviso

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

Bing supporta l'evidenziazione di hit, che contrassegna i termini di query (o altri termini che Bing trova pertinenti) nelle stringhe di visualizzazione di alcune risposte. Ad esempio, i campi , e displayUrlsnippet dei risultati della namepagina Web possono contenere termini di query contrassegnati.

Per impostazione predefinita, Bing non include i marcatori di evidenziazione nelle stringhe visualizzate. Per abilitare gli indicatori, includere il textDecorations parametro di query nella richiesta e impostarlo su true.

Esempio di evidenziazione dell'hit

Nell'esempio seguente viene illustrato un risultato Web per Sailing Dinghy. Bing ha contrassegnato l'inizio e la fine del termine di query usando i caratteri Unicode E000 e E001.

Evidenziazione dei risultati

Prima di visualizzare il risultato nell'interfaccia utente, sostituire i caratteri Unicode con quelli appropriati per il formato visualizzato.

Formattazione del marcatore

Bing offre l'opzione di usare i caratteri Unicode o i tag HTML come marcatori. Per specificare quali marcatori usare, includere il parametro di query textFormat :

Valore Marcatore
textFormat=Raw Caratteri Unicode (impostazione predefinita)
textFormat=HTML Caratteri HTML

Decorazioni di testo aggiuntive

Bing può restituire diverse decorazioni di testo. Ad esempio, una Computation risposta può contenere marcatori di sottoscrizioni per il termine log(2) di query nel expression campo.

Marcatori in computation

Se la richiesta non specifica le decorazioni, il expression campo contiene log10(2).

Se textDecorations è true, Bing può includere i marcatori seguenti nelle stringhe di visualizzazione delle risposte. Se non esiste alcun tag HTML equivalente, la cella della tabella è vuota.

Unicode HTML Descrizione
U+E000 <b> Contrassegna l'inizio del termine di query (evidenziazione dei risultati)
U+E001 </B> Contrassegna la fine del termine di query
U+E002 <i> Contrassegna l'inizio di contenuto in corsivo
U+E003 </Ho> Contrassegna la fine di contenuto in corsivo
U+E004 <br/> Contrassegna un'interruzione di riga
U+E005 Contrassegna l'inizio di un numero di telefono
U+E006 Contrassegna la fine di un numero di telefono
U+E007 Contrassegna l'inizio di un indirizzo
U+E008 Contrassegna la fine di un indirizzo
U+E009   Contrassegna uno spazio unificatore
U+E00C <Forte> Contrassegna l'inizio di contenuto in grassetto
U+E00D </Forte> Contrassegna la fine di contenuto in grassetto
U+E00E Contrassegna l'inizio di contenuto con sfondo più chiaro rispetto allo sfondo circostante
U+E00F Contrassegna la fine di contenuto con sfondo più chiaro rispetto allo sfondo circostante
U+E010 Contrassegna l'inizio di contenuto con sfondo più scuro rispetto allo sfondo circostante
U+E011 Contrassegna la fine di contenuto con sfondo più scuro rispetto allo sfondo circostante
U+E012 <del> Contrassegna l'inizio di contenuto barrato
U+E013 </del> Contrassegna la fine di contenuto barrato
U+E016 <sub> Contrassegna l'inizio di contenuto formattato come pedice
U+E017 </Sub> Contrassegna la fine di contenuto formattato come pedice
U+E018 <Sorseggiare> Contrassegna l'inizio di contenuto formattato come apice
U+E019 </Sorseggiare> Contrassegna la fine di contenuto formattato come apice

Passaggi successivi