API de Bing Maps
Bing Maps es el servicio de mapas de Microsoft. search encuentra negocios que coinciden con una palabra clave alrededor de un centro de mapa y devuelve nombre, dirección, coordenadas, teléfono, web, categoría, estado de apertura y valoración.
Indica latitude y longitude de la zona que quieres; sin ellas Bing elige la ubicación. Las valoraciones y el número de reseñas suelen venir de sitios como Yelp o TripAdvisor, indicados en rating_source. Pasa de página con page, hasta 30 negocios por página.
Disponibilidad de la plataforma
- Salud 24 h
- Normal
Últimos 30 días
Funciones disponibles
Cada acción de Bing Maps, qué hace, su precio y su salud en las últimas 24 horas. Abre una acción para ver sus parámetros, campos de respuesta y ejemplos de código.
| Capacidad | Qué hace | Por 1.000 | Salud en 24 horas |
|---|---|---|---|
Buscar negocios en Bing Mapssearch | Envía una keyword y un centro de mapa en latitude y longitude para listar hasta 30 negocios por página con place_id, name, address, lat, lng, phone, website, category, rating, review_count, rating_source y open_state. | $0.56 por 1.000 solicitudes | Normal |
Abre una capacidad para ver sus parámetros, campos de respuesta, ejemplos de código y prueba.
¿Qué acepta cada acción de Bing Maps?
Cada respuesta enlaza una acción ejecutable con sus entradas reales. El significado y los valores permitidos pertenecen a esa acción; un nombre parecido no conserva automáticamente el mismo sentido en otra plataforma.
Las fuentes oficiales se enlazan solo para precisar el término de la plataforma indicado a su lado. No implican autorización ni respaldo y no añaden a EveryInfra funciones del sitio oficial.
| Acción | Obligatorios | Opcionales | Entrega | Límite | Por 1.000 | Campos de respuesta |
|---|---|---|---|---|---|---|
searchBuscar negocios en Bing Maps Envía una | keyword | language, latitude, longitude, page | Entrega síncrona | El catálogo declara defaultLimit = 20 y maxLimit = 30 para el límite de esta acción. Según la acción, la unidad puede aplicarse a una página, a cada elemento padre o a otra unidad propia de la acción; no es necesariamente el total final de filas de toda la solicitud. | $0.56 por 1.000 solicitudes | rank · place_id · name · url · category · address · lat · lng · phone · website · rating · rating_scale · review_count · rating_source · open_state · hours_text · image_url · platform |
¿Qué significan los parámetros de Bing Maps search?
Envía una keyword y un centro de mapa en latitude y longitude para listar hasta 30 negocios por página con place_id, name, address, lat, lng, phone, website, category, rating, review_count, rating_source y open_state.
keywordObligatorio- Qué buscar en el mapa: nombre de un negocio o categoría, como
coffeeopizza. languageOpcional- Código de idioma de dos letras, como
enode, para los resultados. latitudeOpcional- Latitud del centro del mapa, de -90 a 90, junto con
longitude. Sin centro Bing elige la ubicación, que puede no ser la ciudad que buscas.Microsoft Learn: la búsqueda local de Bing Maps devuelve negocios alrededor de una ubicación — La documentación de Microsoft indica que la búsqueda local de Bing Maps recibe una consulta y una ubicación del usuario, un rectángulo o un círculo, y devuelve negocios alrededor de ese punto; esa interfaz oficial está retirada para cuentas gratuitas y solo cubre negocios de EE. UU. La fuente solo confirma que Bing Maps busca negocios por ubicación en el mapa; `latitude` y `longitude` de esta API son un centro de mapa definido por EveryInfra, no esa interfaz oficial, y no tienen su límite regional. · Consultada longitudeOpcional- Longitud del centro del mapa, de -180 a 180, junto con
latitude. pageOpcional- Página de resultados, desde 1, con
limitnegocios por página (hasta 20 páginas).
Cómo usar la API de Bing Maps
- 01Consulta el catálogo público y elige una acción de la plataforma.
- 02Envía los parámetros platform y action, junto con los campos obligatorios, a POST /api/v1/social.
- 03Procesa el resultado síncrono o consulta el identificador de trabajo cuando la acción se ejecute de forma asíncrona.
- 04Guarda los campos de la respuesta estructurada que necesita tu aplicación.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"bing_maps","action":"search","params":{"keyword":"<keyword>"}}'
Preguntas sobre la API de Bing Maps
¿Cómo llamo a la API de Bing Maps?
Envía POST /api/v1/social con platform igual a bing_maps, elige uno de los identificadores de acción indicados e incluye sus parámetros obligatorios.
¿Qué devuelve la API de Bing Maps?
Devuelve JSON estructurado. Por ejemplo, el esquema de search incluye rank, place_id, name y category. Cada acción tiene su propia lista de campos; que un campo esté declarado no garantiza que todos los registros tengan un valor.
¿Qué matiz de la documentación oficial conviene conservar al usar datos de Bing Maps?
La documentación de Microsoft indica que la búsqueda local de Bing Maps recibe una consulta y una ubicación del usuario, un rectángulo o un círculo, y devuelve negocios alrededor de ese punto; esa interfaz oficial está retirada para cuentas gratuitas y solo cubre negocios de EE. UU. La fuente solo confirma que Bing Maps busca negocios por ubicación en el mapa; latitude y longitude de esta API son un centro de mapa definido por EveryInfra, no esa interfaz oficial, y no tienen su límite regional.
¿Qué parámetros son obligatorios?
Depende de la acción. search requiere keyword.
¿Las acciones de Bing Maps responden de inmediato?
Las acciones marcadas como asíncronas devuelven un identificador de trabajo que se consulta por sondeo. Cualquier otra acción también puede ejecutarse de forma asíncrona: añade "mode": "async" al cuerpo de la solicitud para recibir el identificador de inmediato, útil para tareas lentas o límites altos.