Reemplazo compatible (drop-in) de Bing Maps REST Services

Microsoft va a retirar Bing Maps for Enterprise. Las claves gratuitas y básicas dejaron de funcionar el 30 de junio de 2025 y los contratos empresariales terminan el 30 de junio de 2028. Si tienes código basado en los servicios REST Locations, Autosuggest, Time Zone o Elevation, apúntalo a bing.mygeocode.com y conserva el mismo análisis de respuestas.

Cambia un nombre de host

Host original
  • dev.virtualearth.net
Usa en su lugarbing.mygeocode.com
Parámetro de la clavekey (opcional: cualquier dirección recibe 2.500 solicitudes al día sin clave; pon aquí tu clave de My Geocode para tener crédito, paquetes y un historial de uso)
Antes
curl "https://dev.virtualearth.net/REST/v1/Locations?q=1%20Microsoft%20Way%2C%20Redmond%2C%20WA&key=YOUR_BING_KEY"
Después
curl "https://bing.mygeocode.com/REST/v1/Locations?q=1%20Microsoft%20Way%2C%20Redmond%2C%20WA&key=YOUR_MYGEOCODE_KEY"

Por qué se cambia la gente

Los endpoints de Bing van a desaparecer según un calendario fijo. Migrar a Azure Maps implica nuevas estructuras de respuesta y nuevo código cliente. Cambiar un nombre de host, no.

La misma cuota gratuita, con clave o sin ella. Las solicitudes a bing.mygeocode.com cuentan para las mismas 2.500 solicitudes gratuitas al día que tu dirección, o tu clave, recibe en nuestros propios endpoints. Por encima de eso, crédito prepago a 0,0001 € por solicitud, o 50 € al mes por una clave Unlimited. Para registrarte solo necesitas una dirección de correo electrónico.

Ver precios Obtén una clave gratis

Endpoints

Ruta en bing.mygeocode.comQué haceRespaldado por
/REST/v1/Locations?q=...Buscar una ubicación por consultaGeocodificación directa
/REST/v1/Locations?countryRegion=...&locality=...&addressLine=...Buscar una ubicación por dirección estructuradaGeocodificación directa
/REST/v1/Locations/{lat},{lon}Buscar una ubicación por punto (inversa)Geocodificación inversa
/REST/v1/Autosuggest?query=...AutosuggestAutocompletado de direcciones
/REST/v1/TimeZone/{lat},{lon}Zona horaria por puntoConsulta de zona horaria
/REST/v1/Elevation/List?points=lat,lon,lat,lonElevaciones para una lista de puntosConsulta de elevación

Ejemplo de respuesta

Esto es lo que devuelve la solicitud anterior. Los nombres de campo, el anidamiento y los tipos siguen a Bing Maps. Solo los datos que hay detrás son nuestros.

Respuesta de bing.mygeocode.com
{
  "authenticationResultCode": "ValidCredentials",
  "brandLogoUri": "https://www.mygeocode.com/assets/img/logo.svg",
  "copyright": "Copyright My Geocode",
  "resourceSets": [
    {
      "estimatedTotal": 1,
      "resources": [
        {
          "__type": "Location:http://schemas.microsoft.com/search/local/ws/rest/v1",
          "bbox": [47.635742, -122.140518, 47.643468, -122.125237],
          "name": "1 Microsoft Way, Redmond, WA 98052",
          "point": { "type": "Point", "coordinates": [47.639605, -122.129877] },
          "address": {
            "addressLine": "1 Microsoft Way",
            "adminDistrict": "WA",
            "adminDistrict2": "King County",
            "countryRegion": "United States",
            "formattedAddress": "1 Microsoft Way, Redmond, WA 98052",
            "locality": "Redmond",
            "postalCode": "98052"
          },
          "confidence": "High",
          "entityType": "Address",
          "geocodePoints": [
            { "type": "Point", "coordinates": [47.639605, -122.129877], "calculationMethod": "Rooftop", "usageTypes": ["Display"] }
          ],
          "matchCodes": ["Good"]
        }
      ]
    }
  ],
  "statusCode": 200,
  "statusDescription": "OK",
  "traceId": "mg-7f2a9c1e4b"
}

Detalles y diferencias

No se necesita clave para las primeras 2.500 solicitudes al día. Para usar una clave de My Geocode, ponla donde iba tu clave de Bing Maps: el parámetro de consulta key. La cabecera X-API-Key, Authorization: Bearer y la autenticación HTTP Basic (con la clave como nombre de usuario) también funcionan en todos los hosts, así que las bibliotecas cliente que se autentican a su manera siguen funcionando sin cambios.

Las líneas de copyright, los nombres de licencia y los enlaces a los términos y a la privacidad de la respuesta son nuestros y no del proveedor original. Todo lo demás conserva la estructura original.

  • Las solicitudes de elevación aceptan los puntos en la cadena de consulta, en un cuerpo de formulario o en el cuerpo text/plain que documenta Bing.
  • Elevation/SeaLevel responde 404: aquí las alturas ya están sobre el nivel medio del mar, así que no hay que aplicar ningún desfase del geoide.
  • Las respuestas de zona horaria incluyen el objeto dstRule, con la regla escrita como lo hace la base de datos de zonas horarias (Sun>=8, lastSun) y el ajuste en minutos.
  • estimatedTotal cuenta los recursos del conjunto, como hace Bing.
  • TimeZone?query= acepta un par de latitud y longitud.
  • Elevation List, Polyline y Bounds aceptan hasta 1.024 puntos, como Bing; aquí cada punto cuenta como una solicitud.

Si tu cliente depende de un campo o de un comportamiento que no aparece aquí, dínoslo. Las carencias de compatibilidad se corrigen rápido porque suelen ser pequeñas.

Otros hosts compatibles

Cómo funcionan los hosts compatibles, el resumen y los reemplazos compatibles de bibliotecas JavaScript.