Compartilhar via


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

Aviso

Em 30 de outubro de 2020, as APIs de Pesquisa do Bing foram migradas dos serviços de IA do Azure para os Serviços de Pesquisa do Bing. Esta documentação é fornecida apenas para referência. Para obter a documentação atualizada, consulte 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, consulte Criar um recurso de Pesquisa do Bing por meio do Azure Marketplace.

O Bing suporta o realce de ocorrências que marca os termos de consulta (ou outros termos que o Bing achar relevantes) nas cadeias de caracteres de exibição de algumas das respostas. Por exemplo, os campos name, displayUrl e snippet dos resultados de uma página Web podem conter os termos de consulta marcados.

Por padrão, o Bing não inclui realce de marcadores em cadeias de exibição. Para habilitar os marcadores, inclua o parâmetro de consulta textDecorations na solicitação e defina-o como true.

Exemplo de realce de ocorrência

O exemplo a seguir mostra um resultado da Web para Sailing Dinghy. O Bing marcou o início e o fim do termo de consulta usando os caracteres Unicode E000 e E001.

Realce de ocorrência

Antes de exibir o resultado na interface do usuário, substitua os caracteres Unicode por caracteres apropriados para seu formato de exibição.

Formatação de marcador

O Bing oferece a opção de usar caracteres Unicode ou tags HTML como marcadores. Para especificar quais marcadores usar, inclua o parâmetro de consulta textFormat:

Valor Marker
textFormat=Raw Caracteres Unicode (padrão)
textFormat=HTML Caracteres HTML

Decorações de texto adicionais

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

marcadores de computação

Se a solicitação não especificou decorações, o campo expression conterá log10(2).

Se textDecorations for true, o Bing pode incluir os marcadores a seguir nas cadeias de caracteres de exibição das respostas. Se não houver nenhuma tag HTML equivalente, a célula da tabela ficará vazia.

Unicode HTML Descrição
U+E000 <b> Marca o início do termo de consulta (realce de ocorrências)
U+E001 </b> Marca o final do termo de consulta
U+E002 <i> Marca o início do conteúdo em itálico
U+E003 </i> Marca o final 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 final de um número de telefone
U+E007 Marca o início de um endereço
U+E008 Marca o final de um endereço
U+E009   Marca um espaço rígido
U+E00C <strong> Marca o início do conteúdo em negrito
U+E00D </strong> Marca o fim do conteúdo em negrito
U+E00E Marca o início do conteúdo cujo plano de fundo deve ser mais claro do que seu plano de fundo ao redor
U+E00F Marca o final do conteúdo cujo plano de fundo deve ser mais claro do que seu plano de fundo ao redor
U+E010 Marca o início do conteúdo cujo plano de fundo deve ser mais escuro do que seu plano de fundo ao redor
U+E011 Marca o final do conteúdo cujo plano de fundo deve ser mais escuro do que seu plano de fundo ao redor
U+E012 <del> Marca o início do conteúdo que deve ser ignorado
U+E013 </del> Marca o final do conteúdo que deve ser ignorado
U+E016 <sub> Marca o início do conteúdo subscrito
U+E017 </sub> Marca o final do conteúdo subscrito
U+E018 <sup> Marca o início do conteúdo sobrescrito
U+E019 </sup> Marca o final do conteúdo sobrescrito

Próximas etapas