Condividi tramite

Render - Get Map Attribution

Servizio:
Maps
Versione API:
2024-04-01

Usare per ottenere informazioni sull'attribuzione del copyright della mappa.

L'API Get Map Attribution consente agli utenti di richiedere informazioni sull'attribuzione del copyright per una sezione di un set di tessere.

GET https://atlas.microsoft.com/map/attribution?api-version=2024-04-01&tilesetId={tilesetId}&zoom={zoom}&bounds={bounds}

Parametri dell'URI

Nome In Necessario Tipo Descrizione
api-version
 query True

string

Numero di versione di Azure Maps API. La versione attuale è 2024-04-01.
bounds
 query True

number[]

Stringa che rappresenta l'area rettangolare di un rettangolo delimitatore. Il parametro bounds è definito dalle 4 coordinate del rettangolo delimitatore, con longitudine e latitudine WGS84 dell'angolo sud-ovest seguito da longitudine WGS84 e latitudine dell'angolo nord-orientale. La stringa viene presentata nel formato seguente: [SouthwestCorner_Longitude, SouthwestCorner_Latitude, NortheastCorner_Longitude, NortheastCorner_Latitude].
tilesetId
 query True

TilesetID

Un set di tessere è una raccolta di dati raster o vettoriali suddivisi in una griglia uniforme di riquadri quadrati a livelli di zoom predefiniti. Ogni set di riquadri ha un tilesetId da usare durante l'esecuzione di richieste. I tileset pronti all'uso forniti da Azure Maps sono elencati di seguito. Ad esempio, microsoft.base.
zoom
 query True

integer (int32)

Livello di zoom per l'attribuzione della mappa desiderata.

Intestazione della richiesta

Nome Necessario Tipo Descrizione
x-ms-client-id

string

Indica l'account destinato all'uso con il modello di sicurezza Microsoft Entra ID. Questo ID univoco per l'account Azure Maps può essere ottenuto dall'Account API Azure Maps piano di gestione. Per maggiori informazioni sull'uso della sicurezza Microsoft Entra ID in Azure Maps, vedi Gestire l'autenticazione in Azure Maps.

Risposte

Nome Tipo Descrizione
200 OK

MapAttribution

Va bene
Other Status Codes

ErrorResponse

Errore imprevisto.

Sicurezza

AADToken

Questi sono i flussi Microsoft Entra OAuth 2.0. Quando abbinata al controllo Azure basato su ruolo può essere utilizzata per controllare l'accesso alle API REST di Azure Maps. I controlli di accesso basati su ruoli di Azure sono utilizzati per designare l'accesso a uno o più account o sottorisorse risorse di Azure Maps. Qualsiasi utente, gruppo o principale di servizio può ricevere l'accesso tramite un ruolo integrato o un ruolo personalizzato composto da uno o più permessi alle API REST di Azure Maps.

Per implementare scenari, è consigliabile visualizzare concetti di autenticazione. In sintesi, questa definizione di sicurezza offre una soluzione per la modellazione di applicazioni tramite oggetti in grado di controllare l'accesso su API e ambiti specifici.

Note

  • Questa definizione di sicurezza richiede l'uso dell'intestazione x-ms-client-id per indicare a quale Azure Maps risorsa l'applicazione richiede accesso. Questa operazione può essere acquisita dall'API di gestione di mappe .

Il Authorization URL è specifico per l'istanza Azure cloud pubblico. I cloud sovrani hanno URL di autorizzazione unici e configurazioni Microsoft Entra ID. * Il controllo accessi basato sul ruolo Azure è configurato dal piano di gestione Azure tramite Azure portale, PowerShell, CLI, Azure SDKs o API REST. * L'uso del Web SDK Azure Maps consente la configurazione di un'applicazione per più casi d'uso.

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome Descrizione
https://atlas.microsoft.com/.default https://atlas.microsoft.com/.default

subscription-key

Questa è una chiave condivisa che viene fornita quando si crea una risorsa Azure Maps tramite il piano di gestione Azure tramite Azure portale, PowerShell, CLI, Azure SDKs o API REST.

Con questa chiave, qualsiasi applicazione è autorizzata ad accedere a tutte le API REST. In altre parole, questi possono essere attualmente considerati chiavi master per l'account per cui vengono rilasciati.

Per applicazioni pubblicamente esposte, la nostra raccomandazione è di utilizzare l'accesso server-to-server alle API REST di Azure Maps, dove questa chiave può essere memorizzata in modo sicuro.

Tipo: apiKey
In: header

SAS Token

Questo è un token di firma di accesso condiviso creato dall'operazione List SAS sulla risorsa Azure Maps tramite il piano di gestione Azure tramite Azure portale, PowerShell, CLI, Azure SDKs o API REST.

Con questo token, qualsiasi applicazione è autorizzata ad accedere tramite Azure ai controlli di accesso basati su ruoli e a un controllo fine della scadenza, del tasso e delle regioni di utilizzo per il particolare token. In altre parole, il token di firma di accesso condiviso può essere usato per consentire alle applicazioni di controllare l'accesso in modo più protetto rispetto alla chiave condivisa.

Per le applicazioni esposte pubblicamente, è consigliabile configurare un elenco specifico di origini consentite nella risorsa account mappa per limitare l'abuso di rendering e rinnovare regolarmente il token di firma di accesso condiviso.

Tipo: apiKey
In: header

Esempio

Successful Attribution Request

Esempio di richiesta

GET https://atlas.microsoft.com/map/attribution?api-version=2024-04-01&tilesetId=microsoft.base&zoom=6&bounds=-122.414162,47.57949,-122.247157,47.668372

Risposta di esempio

Codice di stato:
200 
{
  "copyrights": [
    "<a data-azure-maps-attribution-tileset=\"microsoft.base\">&copy;2022 TomTom</a>"
  ]
}

Definizioni

Nome Descrizione
ErrorAdditionalInfo

Informazioni aggiuntive sull'errore di gestione delle risorse.
ErrorDetail

Dettagli dell'errore.
ErrorResponse

Risposta di errore
MapAttribution

Attribuzione del copyright per la sezione richiesta di un set di tessere.
TilesetID

Un set di tessere è una raccolta di dati raster o vettoriali suddivisi in una griglia uniforme di riquadri quadrati a livelli di zoom predefiniti. Ogni set di riquadri ha un tilesetId da usare durante l'esecuzione di richieste. I tileset pronti all'uso forniti da Azure Maps sono elencati di seguito. Ad esempio, microsoft.base.

ErrorAdditionalInfo

Oggetto

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome Tipo Descrizione
info

object

Informazioni aggiuntive.
type

string

Tipo di informazioni aggiuntive.

ErrorDetail

Oggetto

Dettagli dell'errore.

Nome Tipo Descrizione
additionalInfo

ErrorAdditionalInfo[]

Informazioni aggiuntive sull'errore.
code

string

Codice di errore.
details

ErrorDetail[]

Dettagli dell'errore.
message

string

Messaggio di errore.
target

string

Destinazione dell'errore.

ErrorResponse

Oggetto

Risposta di errore

Nome Tipo Descrizione
error

ErrorDetail

Oggetto error.

MapAttribution

Oggetto

Attribuzione del copyright per la sezione richiesta di un set di tessere.

Nome Tipo Descrizione
copyrights

string[]

Elenco di stringhe di copyright.

TilesetID

Enumerazione

Un set di tessere è una raccolta di dati raster o vettoriali suddivisi in una griglia uniforme di riquadri quadrati a livelli di zoom predefiniti. Ogni set di riquadri ha un tilesetId da usare durante l'esecuzione di richieste. I tileset pronti all'uso forniti da Azure Maps sono elencati di seguito. Ad esempio, microsoft.base.

Valore Descrizione
microsoft.base

Una mappa di base è una mappa standard che visualizza strade, caratteristiche naturali e artificiali insieme alle etichette per tali caratteristiche in un riquadro vettoriale.

Supporta i livelli di zoom da 0 a 22. Formato: vettore (pbf).
microsoft.base.labels

Visualizza le etichette per strade, caratteristiche naturali e artificiali in un riquadro vettoriale.

Supporta i livelli di zoom da 0 a 22. Formato: vettore (pbf).
microsoft.base.hybrid

Visualizza i dati di strada, limite e etichetta in un riquadro vettoriale.

Supporta i livelli di zoom da 0 a 22. Formato: vettore (pbf).
microsoft.terra.main

Rilievo ombreggiato e strati terra.

Supporta i livelli di zoom da 0 a 6. Formato: raster (png).
microsoft.base.road

Tutti i livelli con il nostro stile principale.

Supporta i livelli di zoom da 0 a 22. Formato: raster (png).
microsoft.base.darkgrey

Tutti i livelli con il nostro stile grigio scuro.

Supporta i livelli di zoom da 0 a 22. Formato: raster (png).
microsoft.base.labels.road

Etichettare i dati nello stile principale.

Supporta i livelli di zoom da 0 a 22. Formato: raster (png).
microsoft.base.labels.darkgrey

Etichettare i dati nello stile grigio scuro.

Supporta i livelli di zoom da 0 a 22. Formato: raster (png).
microsoft.base.hybrid.road

Dati su strada, limiti e etichette nello stile principale.

Supporta i livelli di zoom da 0 a 22. Formato: raster (png).
microsoft.base.hybrid.darkgrey

Dati su strada, limiti e etichette nello stile grigio scuro.

Supporta i livelli di zoom da 0 a 22. Formato: raster (png).
microsoft.imagery

Combinazione di immagini satellitari o aeree. Disponibile solo nello SKU dei prezzi di S1 e G2.

Supporta i livelli di zoom da 1 a 19. Formato: raster (png).
microsoft.weather.radar.main

Riquadri radar meteo. Ultime immagini radar meteo, tra cui aree di pioggia, neve, ghiaccio e condizioni miste. Per maggiori informazioni sulla copertura del servizio meteorologico Azure Maps, vedi Azure Maps copertura dei servizi meteorologici. Per maggiori informazioni sui dati radar, vedi Servizi meteorologici in Azure Maps.

Supporta i livelli di zoom da 0 a 15. Formato: raster (png).
microsoft.weather.infrared.main

Piastrelle a infrarossi meteo. Le immagini satellite a infrarossi più recenti mostrano le nuvole in base alla temperatura. Per ulteriori informazioni, consulta Azure Maps copertura dei servizi meteorologici. Per maggiori informazioni sui dati satellitari restituiti, vedi Servizi meteorologici in Azure Maps.

Supporta i livelli di zoom da 0 a 15. Formato: raster (png).
microsoft.traffic.absolute

riquadri di traffico assoluti nel vettore
microsoft.traffic.absolute.main

riquadri di traffico assoluti in raster nello stile principale.
microsoft.traffic.relative

riquadri relativi del traffico nel vettore
microsoft.traffic.relative.main

riquadri relativi del traffico in raster nello stile principale.
microsoft.traffic.relative.dark

riquadri relativi del traffico in raster nello stile scuro.
microsoft.traffic.delay

riquadri del traffico nel vettore
microsoft.traffic.delay.main

riquadri del traffico in raster nello stile principale
microsoft.traffic.reduced.main

riduzione dei riquadri del traffico in raster nello stile principale
microsoft.traffic.incident

riquadri degli eventi imprevisti nel vettore