Utilizar marcadores de decoração para realçar texto

Aviso

A 30 de outubro de 2020, as APIs de Pesquisa do Bing passaram dos serviços de IA do Azure para os Serviços Pesquisa do Bing. Esta documentação é fornecida apenas para referência. Para obter documentação atualizada, veja a documentação da API de pesquisa do Bing. Para obter instruções sobre como criar novos recursos do Azure para a pesquisa do Bing, veja Criar um recurso de Pesquisa do Bing através do Azure Marketplace.

O Bing suporta o realce de resultados, que marca termos de consulta (ou outros termos que o Bing considera relevantes) nas cadeias de apresentação de algumas respostas. Por exemplo, os campos , displayUrle snippet de um resultado de namepágina Web podem conter termos de consulta marcados.

Por predefinição, o Bing não inclui marcadores de realce nas cadeias de apresentação. Para ativar os marcadores, inclua o textDecorations parâmetro de consulta no pedido e defina-o como true.

Exemplo de realce de resultados

O exemplo seguinte mostra um resultado Web para Sailing Dinghy. O Bing marcou o início e o fim do termo de consulta com os carateres E000 e E001 Unicode.

Selecionar Realce

Antes de apresentar o resultado na interface de utilizador, substitua os carateres Unicode pelos carateres adequados ao seu formato de apresentação.

Formatação do marcador

O Bing fornece a opção de utilizar carateres Unicode ou etiquetas HTML como marcadores. Para especificar os marcadores a utilizar, inclua o parâmetro de consulta textFormat :

Valor Marcador
textFormat=Raw Carateres Unicode (predefinição)
textFormat=HTML Carateres HTML

Decorações de texto adicionais

O Bing pode devolver várias decorações de texto diferentes. Por exemplo, uma Computation resposta pode conter marcadores inferior à linha para o termo log(2) de consulta no expression campo.

marcadores de computação

Se o pedido não especificar decorações, o expression campo conterá log10(2).

Se textDecorations for true, o Bing pode incluir os seguintes marcadores nas cadeias de apresentação de respostas. Se não existir uma etiqueta HTML equivalente, a célula da tabela estará vazia.

Unicode HTML Description
U+E000 <b> Marca o início do termo da consulta (realce de resultados)
U+E001 </b> Marca o fim do termo de consulta
U+E002 <i> Marca o início do conteúdo em itálico
U+E003 </i> Marca o fim do conteúdo em itálico
U+E004 <br/> Marca uma quebra de linha
U+E005 Marca o início de um número de telefone
U+E006 Marca o fim de um número de telefone
U+E007 Marca o início de um endereço
U+E008 Marca o fim de um endereço
U+E009   Marca um espaço sem interrupções
U+E00C <forte> Marca o início do conteúdo a negrito
U+E00D </strong> Marca o fim do conteúdo a negrito
U+E00E Marca o início do conteúdo cujo fundo deve ser mais leve do que o fundo adjacente
U+E00F Marca o fim do conteúdo cujo fundo deve ser mais leve do que o fundo adjacente
U+E010 Marca o início do conteúdo cujo fundo deve ser mais escuro do que o fundo adjacente
U+E011 Marca o fim do conteúdo cujo fundo deve ser mais escuro do que o fundo adjacente
U+E012 <del> Marca o início do conteúdo que deve ser atingido
U+E013 </del> Marca o fim do conteúdo que deve ser atingido
U+E016 <sub> Marca o início do conteúdo inferior à linha
U+E017 </sub> Marca o fim do conteúdo inferior à linha
U+E018 <sup> Marca o início do conteúdo superior à linha
U+E019 </sup> Marca o fim do conteúdo superior à linha

Passos seguintes