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

Articolo
05/23/2024

Questo articolo spiega come eseguire la migrazione dell'API Get Traffic Incidents di Bing Maps all'API Get Traffic Incident Detail. L'API Get Traffic Incident Detail di Mappe di Azure fornisce dati sui lavori stradali, le chiusure stradali, gli incidenti e altri eventi imprevisti che possono influire sul traffico e vengono aggiornati ogni minuto.

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 Traffic Incident Detail è progettata per visualizzare gli eventi imprevisti del traffico nei riquadri della mappa.
Mappe di Azure richiede che si specifichi boundingZoom oltre a boundingbox. boundingZoom è il livello di zoom (0 - 22) per i riquadri raster e vettoriali.
Azure Maps richiede che si specifichi style. 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 a un 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 di scadere. 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 i tempi di ritardo in secondi causati dall'evento imprevisto del traffico e l'output DelayMagnitude fornisce l'entità 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, Microsoft Entra ID o 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 Traffic Incident Detail di Mappe di Azure.

Parametri della richiesta

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

Parametro di richiesta di Bing Mappe	Alias del parametro di richiesta di Bing Mappe	Mappe di Azure parametro di richiesta	Obbligatorio in Mappe di Azure	Mappe di Azure tipo di dati	Descrizione
mapArea		boundingbox	True	number[]	La proiezione usata per specificare le coordinate `boundingbox` 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.
culture	`c`	Linguaggio	False	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	Mappe di Azure restituisce eventi imprevisti del traffico di tutti i livelli di gravità per impostazione predefinita.
type	`t`	Non supportato	Non supportato	Non supportato	Mappe di Azure restituisce eventi imprevisti del traffico 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 dell'API Get Traffic Incident Detauls 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 durante l'esecuzione dell'API Get Traffic Incidents di Bing Maps e l'equivalente di Mappe di Azure:

Campo risposta di Bing Mappe	campo di risposta Mappe di Azure	Descrizione
Description (Json) Description (XML)	`d`	Questo output si trova nell'elemento di risposta tm di Mappe di Azure.
End (Json) EndTimeUTC (XML)	`ed`	Questo output si trova nell'elemento di risposta tm 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 di risposta tm di Mappe di Azure. Per altre informazioni, vedere IconCategory (`ic`).
incidentId (Json) IncidentId (XML)	`id`	Questo output si trova nell'elemento di risposta tm 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 di risposta tm di Mappe di Azure. Per altre informazioni, vedere punto (`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, vedere DelayMagnitude: (`ty`).
severityScore (Json) SeverityScore (XML)	Non supportato
Start (Json) StartTimeUTC (XML)	`sd`	Questo output si trova nell'elemento di risposta tm di Mappe di Azure. La data è descritta nel formato ISO8601 e include l'ora in formato UTC.
title (Json) Title (XML)	Vedere la descrizione	L'output `f` nell'elemento della risposta tm di Mappe di Azure fornisce il nome dell'intersezione o della posizione in cui viene avviato il traffico causato dall'evento imprevisto e può fungere da alternativa all'output `title` di Bing Maps.
toPoint (Json) ToPoint (XML)	Vedere la descrizione	L'output `t` nell'elemento della risposta tm di Mappe di Azure fornisce il nome dell'intersezione o della posizione in cui termina il traffico causato dall'evento imprevisto e può fungere da alternativa all'output `toPoint` di Bing Maps.
type (Json) Type (XML)	`c`	L'output `c` nell'elemento della risposta tm di Mappe di Azure fornisce la causa dell'evento imprevisto, se disponibile.

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

Esempi di risposta

L'esempio JSON seguente mostra cosa viene restituito nel corpo della risposta HTTP durante l'esecuzione di una 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 Get Traffic Incidents di Bing Maps, l'API Get Traffic Incident Detail di Mappe di Azure 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 per il traffico di Mappe di Azure

Get Traffic Flow Segment. Si utilizza per ottenere informazioni sulle velocità e sui tempi di viaggio della sezione di strada specificata.
Get Traffic Flow Tile. Si utilizza per ottenere riquadri da 256 x 256 pixel che mostrano il flusso del traffico.
Get Traffic Incident Tile. Si utilizza per ottenere riquadri da 256 x 256 pixel che mostrano gli eventi imprevisti relativi al traffico.
Get Traffic Incident Viewport. Si utilizza per ottenere informazioni legali e tecniche per un viewport.

Supporto tecnico

Forum di domande e risposte Microsoft

Condividi tramite