Condividi tramite

Traffic - Get Traffic Incident Tile

Servizio:
Maps
Versione API:
1.0

Usare per ottenere riquadri da 256 x 256 pixel che mostrano gli eventi imprevisti del traffico.

Annotazioni

Ritiro del servizio Traffico di Mappe di Azure v1

Il servizio Traffico di Mappe di Azure v1 è ora deprecato e verrà ritirato il 31/03/28. Per evitare interruzioni del servizio, tutte le chiamate al servizio Traffic v1 dovranno essere aggiornate entro il 31/03/28. Per altre informazioni, vedere Eseguire la migrazione delle API del traffico di Mappe di Azure 1.0.

L'API Traffic Incident Tile è una richiesta http GET che restituisce 256 riquadri x 256 pixel che mostrano eventi imprevisti del traffico. Tutti i riquadri usano lo stesso sistema griglia. Poiché i riquadri del traffico usano immagini trasparenti, possono essere sovrapposti ai riquadri della mappa per creare una visualizzazione composta. I riquadri del traffico eseguono il rendering della grafica per indicare il traffico sulle strade nell'area specificata.

GET https://atlas.microsoft.com/traffic/incident/tile/{format}?api-version=1.0&style={style}&zoom={zoom}&x={x}&y={y}
Con parametri facoltativi: 
GET https://atlas.microsoft.com/traffic/incident/tile/{format}?api-version=1.0&style={style}&zoom={zoom}&x={x}&y={y}&t={t}

Parametri dell'URI

Nome In Necessario Tipo Descrizione
format
 path True

TileFormat

Formato desiderato della risposta. I valori possibili sono png & pbf.
api-version
 query True

string

Numero di versione dell'API mappe di Azure.
style
 query True

TrafficIncidentTileStyle

Stile da utilizzare per eseguire il rendering del riquadro. Questo parametro non è valido quando format è pbf.
x
 query True

integer (int32)

Coordinata X del riquadro sulla griglia di zoom. Il valore deve essere compreso nell'intervallo [0, 2zoom -1].

Per informazioni dettagliate, vedere Livelli di zoom e griglia riquadri.
y
 query True

integer (int32)

Coordinata Y del riquadro sulla griglia di zoom. Il valore deve essere compreso nell'intervallo [0, 2zoom -1].

Per informazioni dettagliate, vedere Livelli di zoom e griglia riquadri.
zoom
 query True

integer (int32)

Livello di zoom per il riquadro desiderato. Per riquadri raster, il valore deve essere compreso nell'intervallo: 0-22 (incluso). Per riquadri vettoriali, il valore deve essere compreso nell'intervallo: 0-22 (inclusi). Per informazioni dettagliate, vedere Livelli di zoom e griglia riquadri.
t
 query

string

Valore di riferimento per lo stato del traffico in un determinato momento, ottenuto dalla chiamata API Viewport, attributo trafficModelId nel campo trafficState. Viene aggiornato ogni minuto ed è valido per due minuti prima del timeout. Usare -1 per ottenere le informazioni sul traffico più recenti. Impostazione predefinita: informazioni sul traffico più recenti.

Intestazione della richiesta

Nome Necessario Tipo Descrizione
x-ms-client-id

string

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

Risposte

Nome Tipo Descrizione
200 OK

object

Questo oggetto viene restituito da una chiamata riuscita al riquadro eventi imprevisti del traffico

Media Types: "application/json", "image/jpeg", "image/png", "image/pbf", "application/vnd.mapbox-vector-tile"

Intestazioni

Content-Type: string
Other Status Codes

ErrorResponse

Errore imprevisto.

Media Types: "application/json", "image/jpeg", "image/png", "image/pbf", "application/vnd.mapbox-vector-tile"

Sicurezza

AADToken

Questi sono i flussi di Microsoft Entra OAuth 2.0. Se abbinato a l'accesso in base al ruolo di Azure controllarlo, può essere usato per controllare l'accesso alle API REST di Mappe di Azure. I controlli di accesso in base al ruolo di Azure vengono usati per designare l'accesso a uno o più account di risorse di Mappe di Azure o a risorse secondarie. A qualsiasi utente, gruppo o entità servizio può essere concesso l'accesso tramite un ruolo predefinito o un ruolo personalizzato composto da una o più autorizzazioni per le API REST di Mappe di Azure.

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 risorsa di Mappe di Azure l'applicazione richiede l'accesso. Questa operazione può essere acquisita dall'API di gestione Maps.

Il Authorization URL è specifico dell'istanza del cloud pubblico di Azure. I cloud sovrani hanno URL di autorizzazione univoci e configurazioni microsoft Entra ID. * Il controllo degli accessi in base al ruolo di Azure viene configurato dal piano di gestione di Azure tramite il portale di Azure, PowerShell, l'interfaccia della riga di comando, gli SDK di Azure o le API REST. * L'utilizzo del Sdk Web di Mappe di Azure consente la configurazione basata sulla 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

Si tratta di una chiave condivisa di cui viene effettuato il provisioning quando si Creare un account di Mappe di Azure nel portale di Azure o usando PowerShell, l'interfaccia della riga di comando, gli SDK di Azure o l'API REST.

Con questa chiave, qualsiasi applicazione può accedere a tutte le API REST. In altre parole, questa chiave può essere usata come chiave master nell'account in cui vengono rilasciati.

Per le applicazioni esposte pubblicamente, è consigliabile usare l'approccio applicazioni client riservate per accedere alle API REST di Mappe di Azure in modo che la chiave possa essere archiviata in modo sicuro.

Tipo: apiKey
In: query

SAS Token

Si tratta di un token di firma di accesso condiviso creato dall'operazione List SAS nell'risorsa di Mappe di Azure tramite il piano di gestione di Azure tramite il portale di Azure, PowerShell, l'interfaccia della riga di comando, gli SDK di Azure o le API REST.

Con questo token, qualsiasi applicazione è autorizzata ad accedere ai controlli di accesso in base al ruolo di Azure e al controllo granulare per la scadenza, la frequenza e le aree d'uso per il token specifico. 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

Request a tile depicting a traffic incident

Esempio di richiesta

GET https://atlas.microsoft.com/traffic/incident/tile/png?api-version=1.0&style=night&zoom=10&x=175&y=408

Risposta di esempio

Codice di stato:
200 
{}

Definizioni

Nome Descrizione
ErrorAdditionalInfo

Informazioni aggiuntive sull'errore di gestione delle risorse.
ErrorDetail

Dettagli dell'errore.
ErrorResponse

Risposta di errore
TileFormat

Formato desiderato della risposta. I valori possibili sono png & pbf.
TrafficIncidentTileStyle

Stile da utilizzare per eseguire il rendering del riquadro. Questo parametro non è valido quando format è pbf.

ErrorAdditionalInfo

Object

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome Tipo Descrizione
info

object

Informazioni aggiuntive.
type

string

Tipo di informazioni aggiuntive.

ErrorDetail

Object

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

Object

Risposta di errore

Nome Tipo Descrizione
error

ErrorDetail

Oggetto error.

TileFormat

Enumerazione

Formato desiderato della risposta. I valori possibili sono png & pbf.

Valore Descrizione
png

Immagine nel formato png. Supporta i livelli di zoom da 0 a 18.
pbf

Elemento grafico vettoriale nel formato pbf. Supporta i livelli di zoom da 0 a 22.

TrafficIncidentTileStyle

Enumerazione

Stile da utilizzare per eseguire il rendering del riquadro. Questo parametro non è valido quando format è pbf.

Valore Descrizione
s1

Crea linee di traffico con frecce colorate che indicano la gravità.
s2

Crea linee semplici con un certo grado di alone.
s3

Crea linee semplici con un certo grado di alone, diverso dallo stile s2.
night

Stile notte.