Compartir a través de

Migración de la API Get Imagery Metadata de Mapas de Bing

  • Artículo

Este artículo explica cómo migrar la API de Mapas de Bing Get Imagery Metadata a la API de Azure Maps Get Map Tile.

La API Get Map Tile de Azure Maps proporciona mosaicos de mapas en formatos vectoriales o rasterizados para usar en el SDK web de Azure Maps o en controles de mapas de terceros. Algunos iconos de ejemplo que se pueden solicitar son los carretera, satélite/aéreo o radar meteorológico de Azure Maps.

Requisitos previos

Diferencias destacadas

  • La API Get Imagery Metadata de Mapas de Bing proporciona metadatos de mosaicos de mapa en el cuerpo de la respuesta HTML, incluida una URL para obtener la imagen del mosaico de mapa (ImageUrl). La API Get Map Tile de Azure Maps proporciona la imagen del mosaico de mapa directamente en la respuesta HTML, pero no incluye metadatos.
  • La API Get Imagery Metadata de Mapas de Bing proporciona metadatos sobre los mosaicos de mapas en el cuerpo de la respuesta HTML, incluida la información antigua de los mosaicos de mapas (vintageStart y vintageEnd). La API Get Map Tile de Azure Maps proporciona información antigua del mosaico de mapa en el encabezado de la respuesta (Data-Capture-Date-Range), en lugar de en el cuerpo de la respuesta HTML.
  • La API Get Imagery Metadata de Mapas de Bing proporciona los metadatos de los mosaicos de mapa en el cuerpo de la respuesta HTML, incluida la información sobre los derechos de autor de los mosaicos de mapa. En el caso de la API Get Map Tile de Azure Maps, la información sobre la asignación de derechos de autor a los mapas puede obtenerse en la API Get Map Attribution de Azure Maps. La información sobre la asignación de derechos de autor debería estar en el mapa según los Términos del producto de Azure Maps.
  • La API Get Map Tile de Azure Maps no ofrece los siguientes estilos de mapa de la API Get Imagery Metadata de Mapas de Bing: Streetside, Birdseye y Ordnance Survey.
  • La API Get Map Tile de Azure Maps no ofrece actualmente un estilo de mapa de satélite/aéreo con etiquetas de carreteras, como el estilo de mapa AerialWithLabelsOnDemand de la API Get Imagery Metadata de Mapas de Bing. Sin embargo, el SDK web de Azure Maps sí ofrece un estilo de mapa similar denominado satellite_road_labels.
  • La API Get Imagery Metadata de Mapas de Bing ofrece un tamaño de mosaico de 256 x 256 píxeles. La API Get Map Tile de Azure Maps ofrece un tamaño de mosaico de 256 x 256 píxeles y otro de 512 x 512 píxeles. Para más información, consulte MapTileSize.
  • La API Get Imagery Metadata de Bing Maps es compatible con los formatos de respuesta XML y JSON, mientras que la API Get Map Tile de Azure Maps solo es compatible con JSON.
  • La API Get Imagery Metadata de Bing Maps ofrece mapas base de estilo cartográfico como carreteras e satélite/híbrido usando el parámetro de URI imagerySet. La API Get Map Tile de Azure Maps proporciona mapas base de ofertas similares usando el parámetro de URI TilesetID. Azure Maps TilesetID no es compatible con mosaicos AerialWithLabelsOnDemand o AerialWithLabels en Get Map Tiles. Los mosaicos Híbridos solo están disponibles en el Control de mapa del SDK web de Azure Maps.
  • A diferencia de Mapas de Bing para la empresa, Azure Maps es un servicio global que admite la especificación de un ámbito geográfico, lo que le permite limitar la residencia de datos a las áreas geográficas (geoáreas) de Europa (EU) o Estados Unidos (EE. UU.). Todas las solicitudes (incluidos los datos de entrada) se procesan exclusivamente en el área geográfica especificada. Para obtener más información, consulte Ámbito geográfico del servicio de Azure Maps.

Seguridad y autenticación

Mapas de Bing para la empresa solo admite la autenticación de clave de API. Azure Maps admite varias formas de autenticar las llamadas API, como una clave de suscripción, Microsoft Entra ID y Token de firma de acceso compartido (SAS). Para más información sobre seguridad y autenticación en Azure Maps, consulte Autenticación con Azure Maps y la Sección de seguridad en la documentación de Get Map Tile de Azure Maps.

Parámetros de solicitud

En la tabla siguiente se enumeran los parámetros de solicitud de Get Imagery Metadata de Bing Maps y los equivalentes de Azure Maps:

Parámetro de solicitud de Bing Maps Alias del parámetro de solicitud de Bing Maps Parámetro de solicitud de Azure Maps Obligatorio en Azure Maps Tipo de datos de Azure Maps Descripción
imagerySet Ninguno tilesetId Verdadero TilesetID Azure Maps tiene algunos estilos de mapas que la API Get Imagery Metadata de Bing Maps no tiene. La API Get Imagery Metadata de Bing Maps tiene algunos estilos de mapas que Azure Maps no tiene. Para más información sobre los estilos de mapa que ofrece Azure Maps, consulte TilesetID.
centerPoint Ninguno x
y 		Verdadero integer int32 Para más información sobre las coordenadas X, Y, consulte Niveles de zoom y cuadrícula de mosaicos. 
culture c language False string Para más información, vea Idiomas admitidos por Azure Maps.
include incl N/D N/D N/D La única opción para este parámetro en Bing Maps es ImageryProviders. Cuando se especifica, se devuelve información de atribución sobre los proveedores de imágenes en la respuesta, que se debe mostrar en el mapa. En el caso de la API Get Map Tile de Azure Maps, la información sobre la asignación de derechos de autor a los mapas puede obtenerse en la API Get Map Attribution de Azure Maps. La información sobre la asignación de derechos de autor debería estar en el mapa según los Términos del producto de Azure Maps.
mapLayer ml N/D N/A N/D
orientation dir N/D N/D N/D Se aplica al estilo de mapa de Birdseye de Bing Maps, que no se admite en Azure Maps. 
UriScheme         N/D N/D N/D
zoomLevel zl zoom Verdadero integer int32 Para más información sobre las coordenadas X, Y, consulte Niveles de zoom y cuadrícula de mosaicos. 

Para obtener más información sobre los parámetros de solicitud de Azure Maps, consulte Parámetros de URI.

Ejemplos de solicitud

Solicitud de API Get Imagery Metadata de Bing Maps:

http://dev.virtualearth.net/REST/V1/Imagery/Metadata/road/37.770864,-122.467217?zl=15&key={YourBingMapsKey}

Solicitud de API Get Map Tile de Azure Maps:

https://atlas.microsoft.com/map/tile?api-version=2022-08-01&tilesetId=microsoft.base.&zoom=15&x=5236&y=12665&tileSize=256&subscription-key={Your-Azure-Maps-Subscription-key}

Campos de respuesta

En la tabla siguiente se enumeran los campos que pueden aparecer en la respuesta HTTP al ejecutar la API Get Imagery Metadata de Bing Maps y el equivalente de Azure Maps:

Campo de respuesta de Mapas de Bing Campo de respuesta de Azure Maps Descripción
imageHeight (Json)
ImageWidth (XML) 		No compatible La API Get Map Tile de Azure Maps proporciona la imagen del mosaico de mapa directamente en la respuesta HTML (cadena de imagen binaria) y ofrece tamaños de mosaico de 256 x 256 y 512 x 512 píxeles. 
imageUrl (Json)
ImageUrl (XML) 		No compatible La API Get Map Tile de Azure Maps proporciona la imagen del icono de mapa directamente en la respuesta HTML (cadena de imagen binaria), en lugar de una URL de imagen.
imageUrlSubdomains (Json)
ImageUrlSubdomains (XML) 		No compatible La API Get Map Tile de Azure Maps proporciona la imagen del icono de mapa directamente en la respuesta HTML (cadena de imagen binaria), en lugar de una URL de imagen. 
imageWidth (Json)
ImageWidth (XML) 		No compatible La API Get Map Tile de Azure Maps proporciona la imagen del mosaico de mapa directamente en la respuesta HTML (cadena de imagen binaria) y ofrece tamaños de mosaico de 256 x 256 y 512 x 512 píxeles. 
vintageEnd (Json)
VintageEnd (XML) 		No compatible La API Get Map Tile de Azure Maps proporciona información antigua sobre los mosaicos de mapa en el encabezado de la respuesta (Data-Capture-Date-Range1), en lugar de en el cuerpo de la respuesta. 
vintageStart (Json)
VintageStart (XML)		 No compatible La API Get Map Tile de Azure Maps proporciona información antigua sobre los mosaicos de mapa en el encabezado de la respuesta (Data-Capture-Date-Range1), en lugar de en el cuerpo de la respuesta. 
zoomMax (Json)
ZoonMax (XML) 		No compatible Para obtener información sobre los niveles de zoom y el zoom máximo compatible con los estilos de mosaico de mapa, consulte Niveles de zoom y cuadrícula de mosaico y TilesetID.
zoomMin (Json)
ZoomMin (XML) 		No compatible Para obtener información sobre los niveles de zoom y el zoom máximo compatible con los estilos de mosaico de mapa, consulte Niveles de zoom y cuadrícula de mosaico y TilesetID.  

1 Al usar la API de Azure Maps para obtener imágenes de satélite RGB, también puede recuperar información sobre la fecha de adquisición. La respuesta HTTP incluye un encabezado denominado Data-Capture-Date-Range, que proporciona un intervalo de fechas que indica cuándo se capturó la imagen. Por ejemplo, podría aparecer como "31/7/2022-9/1/2023". Tenga en cuenta que las imágenes por satélite suelen abarcar un intervalo de fechas debido al procesamiento por lotes y a la unión de varias imágenes de fechas diferentes para crear mapas sin fisuras. Por lo tanto, aunque una sola fecha no siempre es aplicable, el intervalo de fechas le da una idea de cuándo se recogieron los datos de la imagen.

Para más información sobre los campos de respuesta de la API Get Map Tile de Azure Maps, consulte Respuesta.

Ejemplos de respuesta

En el ejemplo JSON siguiente se muestra lo que se devuelve en el cuerpo de la respuesta HTTP al ejecutar la solicitud Get Imagery Metadata de Bing Maps:

{ 
    "authenticationResultCode": "ValidCredentials", 
    "brandLogoUri": "https://dev.virtualearth.net/Branding/logo_powered_by.png", 
    "copyright": "Copyright © 2024 Microsoft and its suppliers. All rights reserved. This API cannot be accessed and the content and any results may not be used, reproduced or transmitted in any manner without express written permission from Microsoft Corporation.", 
    "resourceSets": [ 
        { 
            "estimatedTotal": 1, 
            "resources": [ 
                { 
                    "__type": "ImageryMetadata:http://schemas.microsoft.com/search/local/ws/rest/v1", 
                    "imageHeight": 256, 
                    "imageUrl": "http://ecn.t2.tiles.virtualearth.net/tiles/r023010203332102.jpeg?g=14374&mkt={culture}&shading=hill", 
                    "imageUrlSubdomains": null, 
                    "imageWidth": 256, 
                    "imageryProviders": null, 
                    "vintageEnd": "02 Dec 2019 GMT", 
                    "vintageStart": "02 Dec 2019 GMT", 
                    "zoomMax": 15, 
                    "zoomMin": 15 
                } 
            ] 
        } 
    ], 
    "statusCode": 200, 
    "statusDescription": "OK", 
    "traceId": "c0630758c8475d6f60d65af81b548c6f|MWH0032BEB|0.0.0.1" 
}

En el ejemplo JSON siguiente se muestra lo que se devuelve en el cuerpo de la respuesta HTTP al ejecutar la solicitud de Get Map Tile de Azure Maps:

Código de estado: 200

Content-Type: application/vnd.mapbox-vector-tile

Cuerpo de la respuesta

"binary image string"

Uso de transacciones

La API Get Imagery Metadata de Bing Maps genera una transacción facturable por solicitud de API. La API Get Map Tile de Azure Maps genera una transacción facturable por cada 15 mosaicos. Para más información sobre las transacciones de Azure Maps, vea Descripción de las transacciones de Azure Maps.

Información adicional

Para ver más API de representación de Azure Maps, consulte:

  • Get Map Attribution: se usa para usar la información de atribución de derechos de autor de los mapas para los mosaicos.
  • Get Map Static Image: se usa para representar una imagen rectangular definida por el usuario que contiene una sección de mapa.

Soporte técnico