Sugerencia de términos de consulta
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.
Generalmente, llamaría a Bing Autosuggest API cada vez que un usuario escribiera un carácter en el cuadro de búsqueda de la aplicación. La integridad de la cadena de consulta afecta a la relevancia de los términos de la consulta sugeridos que devuelve la API. Cuanto más completa sea la cadena de consulta, más apropiada será la lista de términos de consulta sugeridos. Por ejemplo, las sugerencias que puede devolver la API para s es probable que tengan menos relevancia que las consultas que devuelve para sailing dinghies.
Solicitud de ejemplo
En el ejemplo siguiente se muestra una solicitud que devuelve las cadenas de consulta sugeridas para navegar. Recuerde codificar como dirección URL el término de consulta parcial del usuario al establecer el parámetro de consulta q. Por ejemplo, si el usuario escribe sailing les, establezca q en sailing+les o sailing%20les.
GET https://api.cognitive.microsoft.com/bing/v7.0/suggestions?q=sail&mkt=en-us HTTP/1.1
Ocp-Apim-Subscription-Key: 123456789ABCDE
X-MSEdge-ClientIP: 999.999.999.999
X-Search-Location: lat:47.60357;long:-122.3295;re:100
X-MSEdge-ClientID: <blobFromPriorResponseGoesHere>
Host: api.cognitive.microsoft.com
La respuesta siguiente contiene una lista de objetos SearchAction que contienen los términos de consulta sugeridos.
{
"url" : "https:\/\/www.bing.com\/search?q=sailing+lessons+seattle&FORM=USBAPI",
"displayText" : "sailing lessons seattle",
"query" : "sailing lessons seattle",
"searchKind" : "WebSearch"
}, ...
Uso de términos de consulta sugeridos
Cada sugerencia incluye un campo displayText, query y url. El campo displayText contiene la consulta sugerida que usa para rellenar la lista desplegable del cuadro de búsqueda. Debe mostrar todas las sugerencias que incluye la respuesta, y en el orden especificado.
El ejemplo siguiente muestra un cuadro de búsqueda desplegable con los términos de consulta sugeridos de Bing Autosuggest API.
Si el usuario selecciona una consulta sugerida en la lista desplegable, puede usar la cadena de consulta del campo query para llamar a Bing Web Search API y ver los resultados por sí mismo. O bien, puede usar la dirección URL del campo url para enviar al usuario a la página de resultados de la búsqueda de Bing.