Ler em inglês

Partilhar via

Migrar API de metadados de imagens do Bing Maps

  • Artigo

Este artigo explica como migrar a API Get Imagery Metadata do Bing Maps para a API Get Map Tile do Azure Maps.

A API Get Map Tile do Azure Maps fornece blocos de mapa em formatos vetoriais ou raster para serem usados no SDK da Web do Azure Maps ou nos controles de mapa de terceiros 3rd. Alguns exemplos de blocos que podem ser solicitados são o Azure Maps road, satellite/aerial ou radar meteorológico.

Pré-requisitos

Diferenças notáveis

  • A API Get Imagery Metadata do Bing Maps fornece metadados de mosaico de mapa no corpo da resposta HTML, incluindo um URL para obter a imagem de mosaico de mapa (ImageUrl). A API Get Map Tile do Azure Maps fornece a imagem do mosaico do mapa diretamente na resposta HTML, mas não inclui metadados.
  • A API de Metadados de Obtenção de Imagens do Bing Maps fornece metadados de mosaico de mapa no corpo da resposta HTML, incluindo informações vintage de mosaico de mapa (vintageStart e vintageEnd). A API Get Map Tile do Azure Maps fornece informações vintage do mosaico do mapa no cabeçalho da resposta (Data-Capture-Date-Range), em vez de no corpo da resposta HTML.
  • A API Get Imagery Metadata do Bing Maps fornece metadados de mosaico de mapa no corpo da resposta HTML, incluindo informações de direitos de autor para os mosaicos de mapa. Para a API Get Map Tile do Azure Maps, as informações de atribuição de direitos autorais do mapa podem ser obtidas na API Get Map Attribution do Azure Maps. As informações de atribuição de direitos autorais devem ser exibidas no mapa de acordo com os Termos do Produto do Azure Maps.
  • A API de Mosaico Obter Mapa do Azure Maps não oferece os seguintes estilos de mapa da API de Metadados de Imagens do Bing Maps: Streetside, Birdseye e Ordnance Survey.
  • A API de Mosaico Obter Mapa do Azure Maps não oferece atualmente um estilo de mapa de satélite/aéreo com etiquetas de estrada, como o estilo de mapa AerialWithLabelsOnDemand da API de Metadados de Imagens do Bing Maps. No entanto, o SDK da Web do Azure Maps oferece um estilo de mapa semelhante chamado satellite_road_labels.
  • A API de Metadados de Imagens do Bing Maps oferece um tamanho de mosaico de 256 x 256 píxeis. A API de Mosaico Obter Mapa do Azure Maps oferece um tamanho de mosaico de 256 x 256 píxeis e um tamanho de mosaico de 512 x 512 píxeis. Para obter mais informações, consulte MapTileSize.
  • A API de Metadados de Obtenção de Imagens do Bing Maps suporta formatos de resposta XML e JSON, enquanto a API de Mosaico de Mapas do Azure Maps suporta apenas JSON.
  • A API de Metadados de Imagens do Bing Maps oferece mapas base de estilo de mapa, como estradas e satélite/híbrido, usando o imagerySet parâmetro URI. A API de mosaico Get Map do Azure Maps fornece mapas base de ofertas semelhantes utilizando o parâmetro URI TilesetID. O Azure Maps TilesetID não suporta AerialWithLabelsOnDemand nem AerialWithLabels mosaicos em Obter Mosaicos de Mapa. Os blocos híbridos só estão disponíveis no Controle de Mapa do SDK da Web do Azure Maps.
  • Ao contrário do Bing Maps for Enterprise, o Azure Maps é um serviço global que dá suporte à especificação de um escopo geográfico, que permite limitar a residência de dados às áreas geográficas (geos) europeias (UE) ou dos Estados Unidos (EUA). Todos os pedidos (incluindo dados de cálculo) são processados exclusivamente na área geográfica especificada. Para obter mais informações, consulte Escopo geográfico do serviço Azure Maps.

Segurança e autenticação

O Bing Maps for Enterprise suporta apenas a autenticação de chave de API. O Azure Maps dá suporte a várias maneiras de autenticar suas chamadas de API, como uma chave de assinatura, ID do Microsoft Entra e Token de Assinatura de Acesso Compartilhado (SAS). Para obter mais informações sobre segurança e autenticação no Azure Maps, consulte Autenticação com o Azure Maps e a seção Segurança na documentação Obter Bloco de Mapa do Azure Maps.

Parâmetros de solicitação

A tabela a seguir lista os parâmetros de solicitação Obter Metadados de Imagens do Bing Maps e o equivalente do Azure Maps:

Parâmetro de solicitação do Bing Maps Alias de parâmetro de solicitação do Bing Maps Parâmetro de solicitação do Azure Maps Obrigatório no Azure Maps Tipo de dados do Azure Maps Description
imagerySet Nenhum tilesetId Verdadeiro TilesetID O Azure Maps tem alguns estilos de mapa que a API de Metadados de Obtenção de Imagens do Bing Maps não tem. A API de Metadados de Obtenção de Imagens do Bing Maps tem alguns estilos de mapa que o Azure Maps não tem. Para obter mais informações sobre os estilos de mapa oferecidos pelo Azure Maps, consulte TilesetID.
ponto central Nenhum x
y 		Verdadeiro inteiro int32 Para obter mais informações sobre coordenadas X, Y, consulte Níveis de zoom e grade de blocos. 
cultura c Idioma Falso string Para obter mais informações, consulte Idiomas suportados do Azure Maps.
incluem incl NA NA NA A única opção para esse parâmetro no Bing Maps é ImageryProviders. Quando especificado, as informações de atribuição sobre os provedores de imagens são retornadas na resposta, que deve ser exibida no mapa. Para a API Get Map Tile do Azure Maps, as informações de atribuição de direitos autorais do mapa podem ser obtidas na API Get Map Attribution do Azure Maps. As informações de atribuição de direitos autorais devem ser exibidas no mapa de acordo com os Termos do Produto do Azure Maps.
mapLayer ml NA N/A NA
Orientação Dir NA NA NA Aplica-se ao estilo de mapa Birdseye do Bing Maps, que não é suportado no Azure Maps. 
uriScheme         NA NA NA
zoomLevel ZL Zoom Verdadeiro inteiro int32 Para obter mais informações sobre coordenadas X, Y, consulte Níveis de zoom e grade de blocos. 

Para obter mais informações sobre os parâmetros de solicitação do Azure Maps, consulte Parâmetros de URI.

Exemplos de pedidos

Bing Maps Obter solicitação de API de metadados de imagens:

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

Azure Maps Obter solicitação de API de bloco de mapa:

HTTP 
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 resposta

A tabela a seguir lista os campos que podem aparecer na resposta HTTP ao executar a API Get Imagery Metadata do Bing Maps e o equivalente do Azure Maps:

Campo de resposta do Bing Maps Campo de resposta do Azure Maps Description
imageHeight (Json)
ImageWidth (XML) 		Não suportado A API Get Map Tile do Azure Maps fornece a imagem do mosaico do mapa diretamente na resposta HTML (cadeia de caracteres de imagem binária) e oferece tamanhos de mosaico de 256 x 256 e 512 x 512 pixels. 
imageUrl (Json)
ImageUrl (XML) 		Não suportado A API de mosaico Get Map do Azure Maps fornece a imagem do mosaico do mapa diretamente na resposta HTML (cadeia de caracteres de imagem binária), em oposição a um URL de imagem.
imageUrlSubdomínios (Json)
ImageUrlSubdomínios (XML) 		Não suportado A API de mosaico Get Map do Azure Maps fornece a imagem do mosaico do mapa diretamente na resposta HTML (cadeia de caracteres de imagem binária), em oposição a um URL de imagem. 
imageWidth (Json)
ImageWidth (XML) 		Não suportado A API Get Map Tile do Azure Maps fornece a imagem do mosaico do mapa diretamente na resposta HTML (cadeia de caracteres de imagem binária) e oferece tamanhos de mosaico de 256 x 256 e 512 x 512 pixels. 
vintageEnd (Json)
VintageEnd (XML) 		Não suportado A API Get Map Tile do Azure Maps fornece informações vintage do mosaico do mapa no cabeçalho da resposta (Data-Capture-Date-Range1), em vez de no corpo da resposta. 
vintageStart (Json)
VintageStart (XML)		 Não suportado A API Get Map Tile do Azure Maps fornece informações vintage do mosaico do mapa no cabeçalho da resposta (Data-Capture-Date-Range1), em vez de no corpo da resposta. 
zoomMax (Json)
ZoonMax (XML) 		Não suportado Para obter informações sobre os níveis de zoom e zoom máximo suportados pelos estilos de mosaico do mapa, consulte Níveis de zoom e grelha de mosaicos e TilesetID.
zoomMin (Json)
ZoomMin (XML) 		Não suportado Para obter informações sobre os níveis de zoom e zoom máximo suportados pelos estilos de mosaico do mapa, consulte Níveis de zoom e grelha de mosaicos e TilesetID.  

1 Ao usar a API do Azure Maps para obter imagens de satélite RGB, você também pode recuperar informações sobre a data de aquisição. A resposta HTTP inclui um cabeçalho chamado Data-Capture-Date-Range, que fornece um intervalo de datas que indica quando a imagem foi capturada. Por exemplo, pode aparecer como "31/07/2022-01/09/2023". Tenha em mente que as imagens de satélite geralmente abrangem um intervalo de datas devido ao processamento em lote e à costura de várias imagens de datas diferentes para criar mapas perfeitos. Portanto, embora uma única data nem sempre seja aplicável, o intervalo de datas fornece informações sobre quando os dados da imagem foram coletados.

Para obter mais informações sobre os campos de resposta da API Get Map Tile do Azure Maps, consulte Resposta.

Exemplos de respostas

O exemplo JSON a seguir mostra o que é retornado no corpo da resposta HTTP ao executar a solicitação Obter metadados de imagens do Bing Maps:

JSON 
{ 
    "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" 
}

O exemplo JSON a seguir mostra o que é retornado no corpo da resposta HTTP ao executar uma solicitação Get Map Tile do Azure Maps:

Código de status: 200

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

Organismo de resposta

JSON 
"binary image string"

Utilização de transações

A API de Metadados de Imagens do Bing Maps gera uma transação faturável por solicitação de API. A API Get Map Tile do Azure Maps gera uma transação faturável para cada 15 blocos. Para obter mais informações sobre transações do Azure Maps, consulte Noções básicas sobre transações do Azure Maps.

Informações adicionais

Para obter mais APIs de renderização do Azure Maps, consulte:

  • Obter atribuição de mapa: use para obter informações de atribuição de direitos autorais de mapa para blocos.
  • Obter imagem estática do mapa: use para renderizar uma imagem retangular definida pelo usuário contendo uma seção de mapa.

Suporte