Uso de marcadores de decoración para resaltar texto
Advertencia
El 30 de octubre de 2020, las API de Bing Search se trasladaron de los servicios de Azure AI a los servicios de Bing Search. Esta documentación se proporciona solo como referencia. Para obtener documentación actualizada, consulte la documentación de Bing Search API. Para obtener instrucciones sobre cómo crear nuevos recursos de Azure para Bing Search, consulte el artículo sobre la creación de un recurso de Bing Search a través de Azure Marketplace.
Bing admite el resaltado de aciertos, que marca los términos de la consulta (u otros términos que Bing considere pertinentes) en las cadenas de presentación de algunas respuestas. Por ejemplo, los campos name, displayUrl y snippet del resultado de una página web pueden contener términos de consulta marcados.
De forma predeterminada, Bing no incluye marcadores de resaltado en las cadenas de presentación. Para habilitar los marcadores, incluya el parámetro de consulta textDecorations en la solicitud y establézcalo en true.
Ejemplo de resaltado de aciertos
En el ejemplo siguiente se muestra un resultado de web para Sailing Dinghy. Bing ha marcado el principio y el final del término de consulta con los caracteres Unicode E000 y E001.
Antes de mostrar la cadena en la interfaz de usuario, reemplace los caracteres Unicode por aquellos adecuados para el formato de presentación.
Formato del marcador
Bing ofrece la opción de usar caracteres Unicode o etiquetas HTML como marcadores. Para especificar los marcadores que se van a usar, incluya el parámetro de consulta textFormat:
| Valor | Marcador |
|---|---|
textFormat=Raw |
Caracteres Unicode (valor predeterminado) |
textFormat=HTML |
Caracteres HTML |
Decoraciones de texto adicionales
Bing puede devolver varias decoraciones de texto diferentes. Por ejemplo, una respuesta de Computation puede contener marcadores de subíndice para el término de consulta log(2) en el campo expression.
Si la solicitud no hubiese especificado decoraciones, el campo expression contendría log10(2).
Si textDecorations es true, Bing puede incluir los siguientes marcadores en las cadenas de presentación de las respuestas. Si no hay ninguna etiqueta HTML equivalente, la celda correspondiente de la tabla aparece vacía.
| Unicode | HTML | Description |
|---|---|---|
| U+E000 | <b> | Marca el principio del término de la consulta (resaltado de aciertos) |
| U+E001 | </b> | Marca el final del término de la consulta |
| U+E002 | <i> | Marca el principio del contenido en cursiva |
| U+E003 | </i> | Marca el final del contenido en cursiva |
| U+E004 | <br/> | Marca un salto de línea |
| U+E005 | Marca el principio de un número de teléfono | |
| U+E006 | Marca el final de un número de teléfono | |
| U+E007 | Marca el principio de una dirección | |
| U+E008 | Marca el final de una dirección | |
| U+E009 | Marca un espacio de no separación | |
| U+E00C | <seguro> | Marca el principio del contenido en negrita |
| U+E00D | </strong> | Marca el final del contenido en negrita |
| U+E00E | Marca el principio del contenido cuyo fondo debe ser más claro que el fondo circundante | |
| U+E00F | Marca el final del contenido cuyo fondo debe ser más claro que el fondo circundante | |
| U+E010 | Marca el principio del contenido cuyo fondo debe ser más oscuro que el fondo circundante | |
| U+E011 | Marca el final del contenido cuyo fondo debe ser más oscuro que el fondo circundante | |
| U+E012 | <del> | Marca el principio del contenido que debe tacharse |
| U+E013 | </del> | Marca el final del contenido que debe tacharse |
| U+E016 | <sub> | Marca el principio del contenido de subíndice |
| U+E017 | </sub> | Marca el final del contenido de subíndice |
| U+E018 | <sup> | Marca el principio del contenido de superíndice |
| U+E019 | </sup> | Marca el final del contenido de superíndice |