Envío y uso de consultas y respuestas de Bing Local Business Search API
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.
Puede obtener resultados locales de Bing Local Business Search API si envía una consulta de búsqueda a su punto de conexión e incluye el encabezado Ocp-Apim-Subscription-Key, que es obligatorio. Junto con los encabezados y los parámetros disponibles, las búsquedas se pueden personalizar mediante la especificación de límites geográficos para el área de búsqueda y las categorías de lugares devueltos.
Creación de una solicitud
Para enviar una solicitud a Bing Local Business Search API, anexe un término de búsqueda al parámetro q= antes de que se agregue al punto de conexión de API e incluya el encabezado Ocp-Apim-Subscription-Key. Por ejemplo:
https://api.cognitive.microsoft.com/bing/localbusinesses/v7.0/search?q=restaurant+in+Bellevue
A continuación se muestra la sintaxis de la dirección URL de solicitud completa. Consulte las guías de inicio rápido de Bing Local Business Search API y el contenido de referencia para encabezados y parámetros para más información sobre el envío de solicitudes.
Para obtener información sobre las categorías de búsqueda local, consulte Categorías de búsqueda para Bing Local Business Search API.
https://api.cognitive.microsoft.com/bing/v7.0/localbusinesses/search[?q][&localCategories][&cc][&mkt][&safesearch][&setlang][&count][&first][&localCircularView][&localMapView]
Uso de respuestas
Las respuestas JSON de Bing Local Business Search API contienen un objeto SearchResponse. La API devolverá resultados de búsqueda pertinentes en el campo places. Si no se encuentra ningún resultado, el campo places no se incluirá en la respuesta.
Nota
Como los formatos y los parámetros de dirección URL están sujetos a cambios sin previo aviso, use todas las direcciones URL tal y como están. No debe tomar dependencias en el formato o los parámetros de dirección URL, excepto donde se indique.
{
"_type": "SearchResponse",
"queryContext": {
"originalQuery": "restaurant in Bellevue"
},
"places": {
"totalEstimatedMatches": 10,
. . .
Atributos de resultados de búsqueda
Los resultados JSON devueltos por la API incluyen los siguientes atributos:
- _type
- address
- entityPresentationInfo
- geoárea
- id
- name
- routeablePoint
- telephone
- url
Para obtener información general sobre encabezados, parámetros, códigos de mercado, objetos de respuesta, errores etc., consulte la referencia Bing Local Search API v7.
Nota
Tenga en cuenta que ni usted, ni un tercero en su nombre, pueden usar, retener, guardar, almacenar en caché, compartir o distribuir datos de Local Search API con el fin de probar, desarrollar, entrenar, distribuir o poner a disposición cualquier servicio o característica que no sea de Microsoft.
Ejemplo de respuesta JSON
La siguiente respuesta JSON incluye los resultados de búsqueda especificados por la consulta ?q=restaurant+in+Bellevue.
Vary: Accept-Encoding
BingAPIs-TraceId: 5376FFEB65294E24BB9F91AD70545826
BingAPIs-SessionId: 06ED7CEC80F746AA892EDAAC97CB0CB4
X-MSEdge-ClientID: 112C391E72C0624204153594738C63DE
X-MSAPI-UserState: aeab
BingAPIs-Market: en-US
X-Search-ResponseInfo: InternalResponseTime=659,MSDatacenter=CO4
X-MSEdge-Ref: Ref A: 5376FFEB65294E24BB9F91AD70545826 Ref B: BY3EDGE0306 Ref C: 2018-10-16T16:26:15Z
apim-request-id: fe54f585-7c54-4bf5-8b92-b9bede2b710a
Strict-Transport-Security: max-age=31536000; includeSubDomains; preload
x-content-type-options: nosniff
Cache-Control: max-age=0, private
Date: Tue, 16 Oct 2018 16:26:15 GMT
P3P: CP="NON UNI COM NAV STA LOC CURa DEVa PSAa PSDa OUR IND"
Content-Length: 978
Content-Type: application/json; charset=utf-8
Expires: Tue, 16 Oct 2018 16:25:15 GMT
{
"_type": "SearchResponse",
"queryContext": {
"originalQuery": "restaurant Bellevue"
},
"places": {
"totalEstimatedMatches": 50,
"value": [{
"_type": "LocalBusiness",
"id": "https:\/\/cognitivegblppe.azure-api.net\/api\/v7\/#Places.0",
"name": "Facing East Taiwanese Restaurant",
"url": "http:\/\/litadesign.wix.com\/facingeastrestaurant",
"entityPresentationInfo": {
"entityScenario": "ListItem",
"entityTypeHints": ["Place", "LocalBusiness", "Restaurant"]
},
"geo": {
"latitude": 47.6199188232422,
"longitude": -122.202796936035
},
"routablePoint": {
"latitude": 47.6199188232422,
"longitude": -122.201713562012
},
"address": {
"streetAddress": "1075 Bellevue Way NE Ste B2",
"addressLocality": "Bellevue",
"addressRegion": "WA",
"postalCode": "98004",
"addressCountry": "US",
"neighborhood": "Bellevue",
"text": "1075 Bellevue Way NE Ste B2, Bellevue, WA 98004"
},
"telephone": "(425) 688-2986"
}],
"searchAction": {
"location": [{
"name": "Bellevue, Washington"
}],
"query": "restaurant"
}
}
}
Solicitudes de limitación
El servicio y el tipo de suscripción determinan el número de consultas que puede realizar por segundo (QPS). Asegúrese de que la aplicación incluye la lógica necesaria para mantenerse dentro de su cuota. Si se alcanza el límite de consultas por segundo, o se supera, se produce un error en la solicitud y se devolverá el código de estado HTTP 429. La respuesta incluye el encabezado Retry-After, que indica cuánto tiempo debe esperar antes de enviar otra solicitud.
Denegación de servicio frente a Limitación
El servicio diferencia entre un ataque de denegación de servicio (DoS) y una infracción de las consultas por segundo. Si el servicio sospecha de un ataque de denegación de servicio, la solicitud se realiza correctamente (código de estado HTTP 200 OK). Sin embargo, el cuerpo de la respuesta está vacío.