Uso de la clasificación para mostrar los resultados de la búsqueda de entidades
Advertencia
El 30 de octubre de 2020, las API de Bing Search se trasladaron de los servicios de Azure AI a Bing Search Services. Esta documentación solo se proporciona como referencia. Para obtener documentación actualizada, consulte la documentación de la API de búsqueda de Bing . Para obtener instrucciones sobre cómo crear nuevos recursos de Azure para la búsqueda de Bing, consulte Creación de un recurso de Bing Search a través de Azure Marketplace.
Cada respuesta de búsqueda de entidades incluye una respuesta RankingResponse que especifica cómo debe mostrar los resultados de búsqueda devueltos por Bing Entity Search API. La respuesta de clasificación agrupa los resultados en contenido principal, de línea principal y de barra lateral. El resultado principal es el más importante o destacado y debe mostrarse primero. Si no muestra los resultados restantes en un formato tradicional de línea principal y barra lateral, debe proporcionar mayor visibilidad del contenido de línea principal que el contenido de la barra lateral.
Dentro de cada grupo, la matriz Elementos identifica el orden en el que debe aparecer el contenido. Cada elemento proporciona dos maneras de identificar el resultado dentro de una respuesta.
| Campo | Descripción |
|---|---|
answerType y resultIndex |
answerType identifica la respuesta (entidad o lugar) y resultIndex identifica un resultado dentro de esa respuesta (por ejemplo, una entidad). El índice comienza en 0. |
value |
value Contiene un identificador que coincide con el identificador de una respuesta o un resultado dentro de la respuesta. La respuesta o los resultados contienen el identificador, pero no ambos. |
El uso de answerType y resultIndex es un proceso de dos pasos. En primer lugar, use answerType para identificar la respuesta que contiene los resultados que se van a mostrar. A continuación, use resultIndex para indexar los resultados de esa respuesta para obtener el resultado que se va a mostrar. (El valor de answerType es el nombre del campo en el objeto SearchResponse). Si se supone que debe mostrar todos los resultados de la respuesta juntos, el elemento de clasificación de la respuesta no incluye el campo resultIndex.
El uso del identificador requiere hacer coincidir el identificador de clasificación con el de una respuesta o uno de sus resultados. Si un objeto de respuesta incluye un campo id, muestre todos los resultados de la respuesta juntos. Por ejemplo, si el objeto Entities incluye el campo id, muestre todos los artículos de entidades juntos. Si el objeto Entities no incluye el campo id, cada entidad contiene un campo id y la respuesta de clasificación combina las entidades con los resultados de Places.
Ejemplo de respuesta de clasificación
A continuación se muestra un ejemplo RankingResponse.
{
"_type": "SearchResponse",
"queryContext": {
"originalQuery": "Jimi Hendrix"
},
"entities": { ... },
"rankingResponse": {
"sidebar": {
"items": [
{
"answerType": "Entities",
"resultIndex": 0,
"value": {
"id": "https://www.bingapis.com/api/v7/#Entities.0"
}
},
{
"answerType": "Entities",
"resultIndex": 1,
"value": {
"id": "https://www.bingapis.com/api/v7/#Entities.1"
}
}
]
}
}
}
En función de esta respuesta de clasificación, la barra lateral mostrará los dos resultados de entidades relacionados con Jimi Hendrix.