Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Questo articolo fornisce indicazioni sulla migrazione del servizio Traffico di Mappe di Azure v1 ad altri servizi di Mappe di Azure.
Nella tabella seguente vengono descritti tutti i servizi di traffico insieme alle rispettive opzioni di migrazione.
| Traffico di Mappe di Azure v1.0 | Opzione di migrazione di Mappe di Azure |
|---|---|
| Ottieni il segmento del flusso del traffico | Nessuna sostituzione diretta. I riquadri della mappa possono essere usati per visualizzare il flusso del traffico, ma la velocità e il tempo di viaggio non sono disponibili. |
|
Riquadro Get Traffic Flow -Assoluto - Riduzione della sensibilità -Relativo - Ritardo relativo |
Ottenere tessera della mappa TilesetID - microsoft.traffic.absolute (vector) - microsoft.traffic.absolute.main (raster) - microsoft.traffic.relative (vettore) - microsoft.traffic.relative.dark (raster) - microsoft.traffic.relative.main (raster) - microsoft.traffic.delay (vector) - microsoft.traffic.delay.main (raster) - microsoft.traffic.reduced.main (raster) |
| Ottenere i dettagli degli eventi imprevisti del traffico | Ottenere informazioni sugli incidenti stradali |
| Get Traffic Incident Tile |
Ottieni il tile della mappa TilesetID - microsoft.traffic.incident (vettore) |
| Ottenere il viewport degli eventi imprevisti del traffico | Nessuna sostituzione. Restituisce l'ID del modello di traffico usato dal servizio Traffic v1, ma non è necessario per il traffico o i servizi di rendering più recenti. |
Differenze rilevanti
A differenza del servizio Traffic v1.0, la versione più recente dell'API Get Traffic Incident di Mappe di Azure e l'API Get Map Tile del servizio di rendering non richiedono un ID modello di traffico.
Il riquadro di delimitazione dell'input Get Traffic Incident v2025-01-01 e la risposta presentano il formato GeoJSON.
Il segmento di flusso del traffico v1.0 fornisce informazioni sulle velocità del veicolo e sui tempi di viaggio del segmento stradale. Queste informazioni non sono disponibili nella versione più recente, ma i dati sul traffico possono essere visualizzati usando l'API Rendering Get Map Tile .
Per assegnare una categoria di icone ai punti restituiti da Get Traffic Incident v2025-01-01, usare l'enumerazione
incidentTypefornita nella risposta.I riquadri della mappa del traffico sono disponibili in formato vettoriale e raster nel servizio di rendering usando l'API Get Map Tile .Traffic map tiles are available in vector and raster format in the Render service using the Get Map Tile API.
Utilizzo delle transazioni
Per informazioni sul modo in cui vengono calcolate le transazioni per i servizi di traffico e rendering, vedere Informazioni sulle transazioni di Mappe di Azure.
Esempi di servizio del traffico
Questa sezione fornisce richieste e risposte di esempio per la versione 1.0 e 2025-01-01 dell'API Incidente di Traffico e la versione 2024-04-01 dell'API Render Map Tile.
Esempio di evento imprevisto del traffico versione 1.0
La versione 1.0 dell'API Traffic Incident è una richiesta GET HTTP che restituisce tutti gli incidenti del traffico all'interno del riquadro di delimitazione specificato.
https://atlas.microsoft.com/traffic/incident/detail/json?api-version=1.0&style=s3&boundingbox=37,-105,45,-94&boundingZoom=11&trafficmodelid=1335294634919&projection=EPSG4326&subscription-key={Your-Azure-Maps-Subscription-key}
La risposta contiene tutti gli incidenti del traffico all'interno del bounding box specificato in formato JSON. I risultati vengono troncati per brevità.
{
"tm": {
"@id": "1742459680",
"poi": [
{
"id": "CLUSTER_80251",
"p": {
"x": -105.0012712,
"y": 39.7117135
},
"ic": 8,
"ty": 0,
"cbl": {
"x": -105.0038575,
"y": 39.7096459
},
"ctr": {
"x": -104.99992,
"y": 39.7148278
},
"cs": 4,
"l": 1132
},
{
"id": "CLUSTER_80249",
"p": {
"x": -105.0070862,
"y": 39.7491353
},
"ic": 13,
"ty": 0,
"cbl": {
"x": -105.0214434,
"y": 39.7391984
},
"ctr": {
"x": -104.9985481,
"y": 39.7597951
},
"cs": 12,
"l": 2276
}
]
}
}
Esempio di incidente stradale 2025-01-01
La versione 2025-01-01 dell'API per gli incidenti stradali è una richiesta HTTP GET che restituisce tutti gli incidenti stradali all'interno della scatola di delimitazione specificata.
https://atlas.microsoft.com/traffic/incident?api-version=2025-01-01&bbox=-105,37,-94,45&subscription-key={Your-Azure-Maps-Subscription-key}
La risposta contiene tutti gli incidenti del traffico all'interno della zona delimitata specificata in formato GeoJSON. L'esempio seguente mostra un singolo evento imprevisto del traffico di tipo "Incidente":
{
"type": "FeatureCollection",
"features": [
{
"type": "Feature",
"id": 18558549332008001,
"geometry": {
"type": "Point",
"coordinates": [
-104.939053,
39.682642
]
},
"properties": {
"startTime": "2025-09-12T09:31:37Z",
"endTime": "2025-09-12T10:21:47Z",
"description": "At CO 2/Colorado Boulevard (Denver) at Mile Point 204. Two right lanes are closed due to a crash.",
"title": "I-25 N / US-87 N",
"incidentType": "Accident",
"severity": 4,
"delay": null,
"lastModified": "2025-09-12T10:21:47Z",
"endPoint": {
"type": "Point",
"coordinates": [
-104.940412,
39.68307
]
},
"isTrafficJam": false,
"isRoadClosed": false
}
}
]
}
Azure Maps Render Get Map Tile v2024-04-01
L'API Azure Maps Render Get Map Tile è una richiesta HTTP GET che restituisce riquadri vettoriali del traffico relativo.
Richiesta di esempio
https://atlas.microsoft.com/map/tile?api-version=2024-04-01&tilesetId=microsoft.traffic.relative&zoom=6&x=10&y=22&subscription-key={Your-Azure-Maps-Subscription-key}
Risposta di esempio
Content-Type: application/vnd.mapbox-vector-tile
stringa di immagine binaria