Eseguire la migrazione dell'API Get Imagery Metadata di Bing Maps

Articolo
05/23/2024

Questo articolo illustra come eseguire la migrazione dell'API Get Imagery Metadata di Bing Maps all'API Get Map Tile di Mappe di Azure.

L'API Get Map Tile di Mappe di Azure fornisce tessere mappa in formati vettoriali o raster da usare nei Web SDK di Mappe di Azure o nei controlli mappa di terze parti. Alcune tessere di esempio che è possibile richiedere sono mappe di Azure road, satellite/aeree o radar meteo.

Prerequisiti

Un account Azure
Un account Mappe di Azure
Una chiave di sottoscrizione o un altro tipo di autenticazione con Mappe di Azure

Differenze rilevanti

L'API Get Imagery Metadata di Bing Maps fornisce i metadati del riquadro della mappa nel corpo della risposta HTML, incluso un URL per ottenere l'immagine della tessera mappa (ImageUrl). L'API Get Map Tile di Mappe di Azure fornisce l'immagine delle tessere mappa direttamente nella risposta HTML, ma non include metadati.
L'API Get Imagery Metadata di Bing Maps fornisce i metadati del riquadro della mappa nel corpo della risposta HTML, incluse le informazioni precedenti delle tessere mappa (vintageStart e vintageEnd). L'API Get Map Tile di Mappe di Azure fornisce informazioni vintage sulle tessere mappa nell'intestazione della risposta (Data-Capture-Date-Range), anziché nel corpo della risposta HTML.
L'API Get Imagery Metadata di Bing Maps fornisce i metadati del riquadro della mappa nel corpo della risposta HTML, incluse le informazioni sul copyright per le tessere mappa. Per l'API Get Map Tile di Mappe di Azure, è possibile ottenere informazioni sull'attribuzione del copyright delle mappe dall'API Get Map Attribution di Mappe di Azure. Le informazioni sull'attribuzione del copyright devono essere visualizzate sulla mappa in base alle condizioni del prodotto Mappe di Azure.
L'API Get Map Tile di Mappe di Azure non offre gli stili di mappa dell'API Get Imagery Metadata di Bing Maps: Streetside, Birdseye e Ordnance Survey.
L'API Get Map Tile di Mappe di Azure attualmente non offre uno stile di mappa satellitare/aerea con etichette stradali, come fa ad esempio lo stile di mappa dell'API Get Imagery Metadata di Bing Maps AerialWithLabelsOnDemand. Tuttavia, Web SDK di Mappe di Azure offre uno stile mappa simile denominato satellite_road_labels.
L'API Get Imagery Metadata di Bing Maps offre dimensioni delle tessere di 256 x 256 pixel. L'API Get Map Tile di Mappe di Azure offre dimensioni delle tessere di 256 x 256 e 512 x 512 pixel. Per altre informazioni, vedere MapTileSize.
L'API Get Imagery Metadata di Bing Maps supporta i formati di risposta XML e JSON, mentre l'API Get Map Tile di Mappe di Azure supporta solo JSON.
L'API Get Imagery Metadata di Bing Maps offre mappe di base in stile mappa, ad esempio strade e satellite/ibrido usando il parametro URI imagerySet. L'API Get Map Tile di Mappe di Azure offre mappe di base simili usando il parametro URI TilesetID. TilesetID di Mappe di Azure non supporta tessere AerialWithLabelsOnDemand o AerialWithLabels in Get Map Tiles. Le tessere ibride sono disponibili solo nel controllo mappa di Web SDK di Mappe di Azure.
A differenza di Bing Maps for Enterprise, Mappe di Azure è un servizio globale che supporta la specifica di un ambito geografico, il che consente di limitare la residenza dei dati alle aree geografiche di Europa (UE) o Stati Uniti (US). Tutte le richieste (inclusi i dati di input) vengono elaborate esclusivamente nell'area geografica specificata. Per altre informazioni, vedere Ambito geografico del servizio Mappe di Azure.

Sicurezza e autenticazione

Bing Maps for Enterprise supporta solo l'autenticazione con chiave API. Mappe di Azure supporta diversi modi per autenticare le chiamate API, ad esempio una chiave di sottoscrizione, Microsoft Entra ID e il token di firma di accesso condiviso (SAS). Per altre informazioni sulla sicurezza e l'autenticazione in Mappe di Azure, vedere Autenticazione con Mappe di Azure e la sezione Sicurezza nella documentazione di Get Map Tile di Mappe di Azure.

Parametri della richiesta

Nella tabella seguente sono elencati i parametri di richiesta di Get Imagery Metadata di Bing Maps e l'equivalente di Mappe di Azure:

Parametro di richiesta Bing Maps	Alias parametro di richiesta Bing Mappe	Parametro di richiesta Mappe di Azure	Obbligatorio in Mappe di Azure	Tipo di dati Mappe di Azure	Descrizione
imagerySet	nessuno	tilesetId	True	TilesetID	Mappe di Azure include alcuni stili di mappa non disponibili nell'API Get Imagery Metadata di Bing Maps. L'API Get Imagery Metadata di Bing Maps include alcuni stili di mappa non disponibili in Mappe di Azure. Per altre informazioni sugli stili di mappa offerti da Mappe di Azure, vedere TilesetID.
centerPoint	nessuno	x y	True	integer int32	Per altre informazioni sulle coordinate X e Y, vedere Livelli di zoom e griglia riquadri.
culture	c	Linguaggio	False	string	Per altre informazioni, vedere Lingue supportate da Mappe di Azure.
includi	incl	ND	ND	ND	L'unica opzione per questo parametro in Bing Maps è `ImageryProviders`. Se specificato, le informazioni di attribuzione sui provider di immagini vengono restituite nella risposta, che deve essere visualizzata sulla mappa. Per l'API Get Map Tile di Mappe di Azure, è possibile ottenere informazioni sull'attribuzione del copyright delle mappe dall'API Get Map Attribution di Mappe di Azure. Le informazioni sull'attribuzione del copyright devono essere visualizzate sulla mappa in base alle condizioni del prodotto Mappe di Azure.
mapLayer	ml	ND	N/A	ND
orientation	dir	ND	ND	ND	Si applica allo stile mappa Birdseye di Bing Maps, che non è supportato in Mappe di Azure.
uriScheme		ND	ND	ND
zoomLevel	zl	zoom	True	integer int32	Per altre informazioni sulle coordinate X e Y, vedere Livelli di zoom e griglia riquadri.

Per altre informazioni sui parametri di richiesta di Mappe di Azure, vedere Parametri URI.

Esempi di richiesta

Richiesta API Get Imagery Metadata di Bing Maps:

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

Richiesta API Get Map Tile di Mappe di Azure:

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}

Campi di risposta

La tabella seguente elenca i campi che possono essere visualizzati nella risposta HTTP durante l'esecuzione dell'API Get Imagery Metadata di Bing Maps e l'equivalente di Mappe di Azure:

Campo risposta di Bing Mappe	Campo risposta di Mappe di Azure	Descrizione
imageHeight (Json) ImageWidth (XML)	Non supportate	L'API Get Map Tile di Mappe di Azure fornisce l'immagine delle tessere mappa direttamente nella risposta HTML (stringa immagine binaria) e offre dimensioni dei riquadri di 256 x 256 e 512 x 512 pixel.
imageUrl (Json) ImageUrl (XML)	Non supportate	L'API Get Map Tile di Mappe di Azure fornisce l'immagine delle tessere mappa direttamente nella risposta HTML (stringa immagine binaria), contrariamente all'URL di un'immagine.
imageUrlSubdomains (Json) ImageUrlSubdomains (XML)	Non supportate	L'API Get Map Tile di Mappe di Azure fornisce l'immagine delle tessere mappa direttamente nella risposta HTML (stringa immagine binaria), contrariamente all'URL di un'immagine.
imageWidth (Json) ImageWidth (XML)	Non supportate	L'API Get Map Tile di Mappe di Azure fornisce l'immagine delle tessere mappa direttamente nella risposta HTML (stringa immagine binaria) e offre dimensioni dei riquadri di 256 x 256 e 512 x 512 pixel.
vintageEnd (Json) VintageEnd (XML)	Non supportate	L'API Get Map Tile di Mappe di Azure fornisce informazioni vintage sulle tessere mappa nell'intestazione della risposta (Data-Capture-Date-Range¹), anziché nel corpo della risposta.
vintageStart (Json) VintageStart (XML)	Non supportate	L'API Get Map Tile di Mappe di Azure fornisce informazioni vintage sulle tessere mappa nell'intestazione della risposta (Data-Capture-Date-Range¹), anziché nel corpo della risposta.
zoomMax (Json) ZoonMax (XML)	Non supportate	Per informazioni sui livelli di zoom e sullo zoom massimo supportati dagli stili delle tessere mappa, vedere Livelli di zoom e griglia di riquadri e TilesetID.
zoomMin (Json) ZoomMin (XML)	Non supportate	Per informazioni sui livelli di zoom e sullo zoom massimo supportati dagli stili delle tessere mappa, vedere Livelli di zoom e griglia di riquadri e TilesetID.

¹ Quando si usa l'API Mappe di Azure per ottenere immagini satellitari RGB, è anche possibile recuperare informazioni sulla data di acquisizione. La risposta HTTP include un'intestazione denominata Data-Capture-Date-Range, che fornisce un intervallo di date che indica quando l'immagine è stata acquisita. Ad esempio, potrebbe apparire come "7/31/2022-9/1/2023". Tenere presente che le immagini satellitari spesso si estendono su un intervallo di date a causa dell'elaborazione batch e dell'unione di più immagini da date diverse per creare mappe senza interruzioni. Pertanto, mentre una singola data non è sempre applicabile, l'intervallo di date fornisce informazioni dettagliate su quando sono stati raccolti i dati dell'immagine.

Per altre informazioni sui campi di risposta dell'API Get Map Tile di Mappe di Azure, vedere Risposta.

Esempi di risposta

L'esempio JSON seguente mostra cosa viene restituito nel corpo della risposta HTTP durante l'esecuzione di una richiesta Get Imagery Metadata di 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" 
}

L'esempio JSON seguente mostra cosa viene restituito nel corpo della risposta HTTP durante l'esecuzione di una richiesta Get Map Tile di Mappe di Azure:

Codice di stato: 200

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

Testo della risposta

"binary image string"

Utilizzo delle transazioni

L'API Get Imagery Metadata di Bing Maps genera una transazione fatturabile per ogni richiesta API. L'API Get Map Tile di Mappe di Azure genera una transazione fatturabile ogni 15 tessere. Per altre informazioni sulle transazioni di Mappe di Azure, vedere Informazioni sulle transazioni di Mappe di Azure.

Informazioni aggiuntive

Per altre API di rendering di Mappe di Azure, vedere:

Ottenere l'attribuzione della mappa: usare per ottenere informazioni sull'attribuzione del copyright della mappa per le tessere.
Get Map Static Image: usare per eseguire il rendering di un'immagine rettangolare definita dall'utente contenente una sezione della mappa.

Supporto tecnico

Forum di domande e risposte Microsoft

Condividi tramite