Usando marcadores de decoração para destacar texto

Aviso

Em 30 de outubro de 2020, as APIs de pesquisa de Bing passaram dos Serviços Cognitivos para Bing Serviços de Busca. Esta documentação é fornecida apenas para referência. Para obter documentação atualizada, consulte a documentação Bing pesquisar a API. Para obter instruções sobre a criação de novos recursos Azure para Bing pesquisa, consulte Criar um recurso de pesquisa Bing através do Azure Marketplace.

Bing suporta o destaque do sucesso, que marca termos de consulta (ou outros termos que Bing considera relevantes) nas cadeias de exibição de algumas respostas. Por exemplo, um resultado de página web name, displayUrle snippet campos podem conter termos de consulta marcados.

Por padrão, Bing não inclui marcadores de destaque nas cordas de exibição. Para ativar os marcadores, inclua o textDecorations parâmetro de consulta no seu pedido e desa um remeta-o para true.

Exemplo de destaque de sucesso

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

Hit Highlighting

Antes de apresentar o resultado na interface do utilizador, substitua os caracteres Unicode por outros apropriados para o seu formato de exibição.

Formatação do marcador

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

Valor Marcador
textFormat=Raw Caracteres unicódigo (padrão)
textFormat=HTML Caracteres HTML

Decorações de texto adicionais

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

computation markers

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

Se textDecorations for true, Bing podem incluir os seguintes marcadores nas cadeias de respostas do visor. Se não houver uma etiqueta HTML equivalente, a célula de mesa está vazia.

Unicode HTML Description
U+E000 <b> Marca o início do termo de consulta (destaque de sucesso)
U+E001 </b> Marca o fim do termo de consulta
U+E002 <eu> Marca o início do conteúdo itálico
U+E003 </i> Marca o fim do conteúdo itálico
U+E004 <br/> Marca uma rutura 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 &nbsp; Marca um espaço sem rutura
U+E00C <forte> Marca o início de conteúdo arrojado
U+E00D </forte> Marca o fim do conteúdo arrojado
U+E00E Marca o início do conteúdo cujo fundo deve ser mais leve do que o seu fundo circundante
U+E00F Marca o fim do conteúdo cujo fundo deve ser mais leve do que o seu fundo circundante
U+E010 Marca o início do conteúdo cujo fundo deve ser mais escuro do que o seu fundo circundante
U+E011 Marca o fim do conteúdo cujo fundo deve ser mais escuro do que o seu fundo circundante
U+E012 <del> Marca o início do conteúdo que deve ser atingido através
U+E013 </del> Marca o fim do conteúdo que deve ser atingido através
U+E016 <sub> Marca o início do conteúdo subscrito
U+E017 </sub> Marca o fim do conteúdo subscrito
U+E018 <sup> Marca o início do conteúdo sobrescrito
U+E019 </sup> Marca o fim do conteúdo sobrescrito

Passos seguintes