Condividi tramite

Eseguire la migrazione dell'API Get Traffic Incidents di Bing Maps

Questo articolo illustra come eseguire la migrazione dell'API Get Traffic Incidents di Bing Maps all'API Get Traffic Incident Detail di Mappe di Azure. L'API Get Traffic Incident Detail (Ottieni dettagli sugli incidenti di traffico) di Azure Maps fornisce dati sui lavori stradali, le chiusure stradali, gli incidenti stradali e altri incidenti che possono influire sul traffico e viene aggiornato ogni minuto.

Prerequisiti

Differenze rilevanti

  • L'API Get Traffic Incident Detail è progettata per visualizzare gli eventi imprevisti del traffico nei riquadri della mappa.
  • Mappe di Azure richiedono che boundingZoom sia specificato oltre a boundingbox. boundingZoom è il livello di zoom (0 - 22) per i riquadri raster e vettoriali.
  • Mappe di Azure richiede che style sia specificato. Stile usato per eseguire il rendering del riquadro nell'API Mappe di Azure [Riquadro eventi imprevisti del traffico]. Ciò influisce sulle coordinate degli eventi imprevisti del traffico nella risposta.
  • Mappe di Azure richiede un numero che fa riferimento al modello di traffico (trafficModelId), ottenuto dall'API Get Traffic Incident Viewport di Mappe di Azure. Viene aggiornato ogni minuto ed è valido per due minuti prima del timeout. Se viene specificato l'ID del modello di traffico errato, l'interfaccia restituisce il valore corretto. In alternativa all'uso dell'API Get Traffic Incident Viewport di Mappe di Azure, passando un valore di -1 per l'ID del modello di traffico nel riquadro eventi imprevisti del traffico di Mappe di Azure, la richiesta richiama sempre il modello di traffico più recente.
  • L'API Get Traffic Incidents di Bing Maps supporta la specifica della gravità e dei tipi di eventi imprevisti del traffico nella richiesta. L'API Get Traffic Incident Detail di Mappe di Azure restituisce invece tutti i tipi e i livelli di gravità dell'evento imprevisto del traffico per impostazione predefinita nella risposta.
  • L'API Get Traffic Incident Detail di Mappe di Azure fornisce in genere maggiori dettagli sui ritardi del traffico rispetto all'API Get Traffic Incidents di Bing Maps. In particolare, in Mappe di Azure, l'output dl fornisce tempi di ritardo in secondi causati dall'evento imprevisto del traffico e l'output DelayMagnitude fornisce la grandezza del ritardo associato all'evento imprevisto (questi valori corrispondono ai colori degli eventi imprevisti nei riquadri del traffico).
  • 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, un ID Microsoft Entra o un token di firma di accesso condiviso. Per ulteriori informazioni sulla sicurezza e sull'autenticazione in Mappe di Azure, consultare Autenticazione con Mappe di Azure e la sezione Sicurezza nella documentazione di Azure Maps per ottenere i dettagli sugli incidenti di traffico.

Parametri della richiesta

La tabella seguente elenca i parametri di richiesta Get Traffic Incidents di Bing Maps e il corrispondente in Azure Maps.

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
mapArea boundingbox Vero number[] La proiezione usata per specificare le boundingbox coordinate nella richiesta e nella risposta è EPSG900913 (impostazione predefinita) o EPSG4326. Usare projection=EPSG4326 per la compatibilità con la proiezione di coordinate usata nell'API Get Traffic Incidents di Bing Maps. 
cultura c  Linguaggio Falso string Codice ISO 639-1 per il linguaggio di output. Per altre informazioni, vedere Lingue supportate da Mappe di Azure.
includeJamcidents Non supportato Non supportato Non supportato Mappe di Azure restituisce condizioni di traffico anomale per impostazione predefinita.
severity s  Non supportato Non supportato Non supportato Le mappe di Azure restituiscono incidenti stradali di tutti i livelli di gravità per impostazione predefinita.
tipo t  Non supportato Non supportato Non supportato Azure Maps restituisce gli incidenti stradali di tutti i tipi per impostazione predefinita.

Per altre informazioni sui parametri di richiesta di Mappe di Azure, vedere Parametri URI nella documentazione dell'API Get Traffic Incident Detail di Mappe di Azure.

Esempi di richiesta

Richiesta dell'API Get Traffic Incidents di Bing Maps:

http://dev.virtualearth.net/REST/v1/Traffic/Incidents/37.8203,-122.2763,37.8321,-122.2542?key={Your-Bing-Maps-Key}

Richiesta API Get Traffic Incident Detail di Mappe di Azure:

http://atlas.microsoft.com/traffic/incident/detail/json?api-version=1.0&style=s3&boundingbox=37.8203,-122.2763,37.8321,-122.2542&boundingZoom=11&projection=EPSG4326&trafficmodelid=-1&subscription-key={Your-Azure-Maps-Subscription-key}

Campi di risposta

La tabella seguente elenca i campi che possono essere visualizzati nella risposta HTTP quando si esegue l'API Get Traffic Incidents di Bing Maps e l'equivalente di Mappe di Azure:

Campo risposta di Bing Mappe Campo di risposta di Azure Maps Descrizione
Descrizione (JSON)
Descrizione (XML) 		d  Questo output si trova nell'elemento tm response di Mappe di Azure. 
End (JSON)
EndTimeUTC (XML) 		ed  Questo output si trova nell'elemento tm response di Mappe di Azure. La data è descritta nel formato ISO8601 e include l'ora in formato UTC. 
eventList (JSON)
EventList (XML) 		Non supportato
icon (Json)
Icon (XML) 		ic  Questo output si trova nell'elemento tm response di Mappe di Azure. Per altre informazioni, vedi IconCategory (ic). 
incidentId (JSON)
IncidentId (XML) 		id Questo output si trova nell'elemento tm response di Mappe di Azure. 
isEndTimeBackfilled (JSON)
IsEndTimeBackfilled (XML) 		Non supportato
isJamcident (JSON)
IsJamcident (XML) 		Non supportato
lastModified (JSON)
LastModifiedUTC (XML) 		Non supportato
point (JSON)
Point (XML) 		p  Questo output si trova nell'elemento tm response di Mappe di Azure. Per altre informazioni, vedere point (p). 
roadClosed (JSON)
RoadClosed (XML) 		Vedere la descrizione L'output IconCategory dell'elemento di risposta tm di Mappe di Azure può essere usato per indicare una chiusura stradale.  
severity (JSON)
Severity (XML) 		ty  Questo output si trova nell'elemento di risposta tm . Per altre informazioni, vedi DelayMagnitude: (ty). 
severityScore (JSON)
SeverityScore (XML) 		Non supportato
Start (JSON)
StartTimeUTC (XML) 		sd  Questo output si trova nell'elemento tm response di Mappe di Azure. La data è descritta nel formato ISO8601 e include l'ora in formato UTC. 
title (JSON)
Titolo (XML) 		Vedere la descrizione L'output f nell'elemento di risposta tm di Mappe di Azure fornisce il nome dell'intersezione o della località in cui inizia il traffico causato dall'incidente e può fungere da alternativa all'output di Bing Maps title. 
toPoint (JSON)
ToPoint (XML) 		Vedere la descrizione L'output t nell'elemento di risposta tm di Mappe di Azure fornisce il nome dell'intersezione o del luogo in cui termina il traffico a causa dell'incidente e può fungere da alternativa all'output di Bing Maps toPoint. 
tipo (JSON)
Tipo (XML) 		c  L'output c nell'elemento della risposta tm di Mappe di Azure fornisce la causa dell'evento imprevisto, se disponibile. 

Per ulteriori informazioni sui campi di risposta dell'API Get Traffic Incident Detail di Azure Maps, vedere Risposte.

Esempi di risposta

L'esempio JSON seguente mostra cosa viene restituito nel corpo della risposta HTTP durante l'esecuzione della richiesta Get Traffic Incidents 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": "TrafficIncident:http://schemas.microsoft.com/search/local/ws/rest/v1",
                    "point": {
                        "type": "Point",
                        "coordinates": [
                            37.824025,
                            -122.265829
                        ]
                    },
                    "alertCCodes": [
                        10
                    ],
                    "delay": 0,
                    "description": "Flooding on Telegraph Ave from I-580/W MacArthur Blvd to W MacArthur Blvd.",
                    "end": "/Date(1711764788159)/",
                    "eventList": [
                        907
                    ],
                    "icon": 0,
                    "incidentId": 14648704852012000,
                    "isEndTimeBackfilled": true,
                    "isJamcident": false,
                    "lastModified": "/Date(1711757588159)/",
                    "roadClosed": false,
                    "severity": 4,
                    "severityScore": 79,
                    "source": 5,
                    "start": "/Date(1711749960000)/",
                    "title": "Telegraph Ave",
                    "toPoint": {
                        "type": "Point",
                        "coordinates": [
                            37.824601,
                            -122.265675
                        ]
                    },
                    "type": 5,
                    "verified": true
                }
            ]
        }
    ],
    "statusCode": 200,
    "statusDescription": "OK",
    "traceId": "35657cf08e01f49cd50543aa7d88c139|MWH0032BF3|0.0.0.0"
}

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

{
    "tm": {
        "@id": "1711765520",
        "poi": [
            {
                "id": "0043f39aed6a43411b869729bc30cba4",
                "p": {
                    "x": -122.2631419,
                    "y": 37.8235763
                },
                "ic": 11,
                "ty": 0,
                "cs": 0,
                "d": "Flooding",
                "sd": "2024-03-29T22:06:00Z",
                "f": "I-580/W MacArthur Blvd (Telegraph Ave)",
                "t": "W MacArthur Blvd (Telegraph Ave)",
                "l": 66
            }
        ]
    }
}

Utilizzo delle transazioni

Analogamente all'API Bing Maps Get Traffic Incidents, l'API Azure Maps Get Traffic Incident Detail registra una transazione fatturabile per ogni richiesta. Per altre informazioni sulle transazioni di Mappe di Azure, vedere Informazioni sulle transazioni di Mappe di Azure.

Informazioni aggiuntive

Altre API del traffico di Mappe di Azure

Assistenza