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.
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.
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 |