Migrieren der Bing Maps-API zum Abrufen von Datenverkehrsvorfällen

Artikel
05/26/2024

In diesem Artikel wird erläutert, wie Sie die Bing Maps Get Traffic Incidents-API zur Azure Maps Get Traffic Incident Detail-API migrieren. Die Azure Maps Get Traffic Incident Detail-API stellt Daten zum Bau, Straßenschließungen, Unfällen und anderen Vorfällen bereit, die sich auf den Verkehr auswirken können, und sie wird jede Minute aktualisiert.

Voraussetzungen

Ein Azure-Konto
Ein Azure Maps-Konto
Ein Abonnementschlüssel oder eine andere Form der Authentifizierung bei Azure Maps

Wichtige Unterschiede

Die Azure Maps Get Traffic Incident Detail-API wurde entwickelt, um Datenverkehrsvorfälle auf Kartenkacheln anzuzeigen.
Azure Maps erfordert, dass zusätzlich zu boundingbox boundingZoom angegeben wird. boundingZoom ist der Zoomfaktor (0 - 22) für Raster- und Vektorkacheln.
Azure Maps erfordert, dass style angegeben wird. Die Formatvorlage, die zum Rendern der Kachel in der Azure Maps-API [Traffic Incident Tile] verwendet wird. Dies wirkt sich auf die Koordinaten von Datenverkehrsvorfällen in der Antwort aus.
Azure Maps erfordert eine Zahl, die auf das Datenverkehrsmodell (trafficModelId) verweist, das aus der Azure Maps Get Traffic Incident Viewport-API abgerufen wird. Es wird jede Minute aktualisiert und ist für zwei Minuten gültig, bevor die Zeitüberschreitung erfolgt. Wenn die falsche Datenverkehrsmodell-ID angegeben ist, gibt die Schnittstelle den richtigen Wert zurück. Als Alternative zur Verwendung der Azure Maps Get Traffic Incident Viewport-API wird immer der Wert -1 für die Datenverkehrsmodell-ID in der Azure Maps Traffic Incident Tile-Anforderung aufgerufen.
Die Bing Maps Get Traffic Incidents-API unterstützt die Angabe des Schweregrads und der Art von Datenverkehrsvorfällen in der Anforderung. Die Azure Maps Get Traffic Incident Detail-API gibt stattdessen den gesamten Schweregrad und die Arten von Datenverkehrsvorfällen standardmäßig in der Antwort zurück.
Azure Maps Get Traffic Incident Detail-API bietet generell mehr Details zu Datenverkehrsverzögerungen als die Bing Maps Get Traffic Incidents-API. Insbesondere in Azure Maps stellt die dl-Ausgabe Verzögerungszeit in Sekunden bereit, die der Datenverkehrsvorfall verursacht hat, und die DelayMagnitude-Ausgabe stellt die Größe der Verzögerung im Zusammenhang mit Vorfällen bereit (diese Werte entsprechen den Vorfallfarben in den Datenverkehrskacheln).
Im Gegensatz zu Bing Maps for Enterprise ist Azure Maps ein globaler Dienst, der die Angabe eines geografischen Bereichs unterstützt, mit dem Sie die Datenresidenz auf die europäischen (EU) oder US-amerikanischen (US) geografischen Bereiche (Geografien) beschränken können. Alle Anforderungen (einschließlich Eingabedaten) werden ausschließlich im angegebenen geografischen Bereich verarbeitet. Weitere Informationen finden Sie unter Geografischer Bereich des Azure Maps-Dienstes.

Sicherheit und Authentifizierung

Bing Maps for Enterprise unterstützt nur die Authentifizierung mit einem API-Schlüssel. Azure Maps unterstützt mehrere Möglichkeiten für die Authentifizierung Ihrer API-Aufrufe, z. B. Abonnementschlüssel, Microsoft Entra ID oder SAS-Tokens (Shared Access Signature). Weitere Informationen zur Sicherheit und Authentifizierung in Azure Maps finden Sie unter Authentifizierung mit Azure Maps und im Abschnitt Sicherheit in der Dokumentation zum Abrufen von Datenverkehrsvorfällen in Azure Maps.

Anforderungsparameter

In der folgenden Tabelle sind die Anforderungsparameter für Bing Maps Get Traffic Incidents und die Azure Maps-Entsprechung aufgeführt:

Bing Maps-Anforderungsparameter	Alias des Bing Maps-Anforderungsparameters	Azure Maps-Anforderungsparameter	Erforderlich in Azure Maps	Azure Maps-Datentyp	Beschreibung
mapArea		Boundingbox	True	nummer[]	Die Projektion, die zum Angeben der `boundingbox`-Koordinaten in der Anforderung und Antwort verwendet wird, ist EPSG900913 (Standard) oder EPSG4326. Verwenden Sie „projection=EPSG4326“ zur Kompatibilität mit der Koordinatenprojektion, die in der Bing Maps Get Traffic Incidents-API verwendet wird.
culture	`c`	language	False	Zeichenfolge	ISO 639-1-Code für die Ausgabesprache. Weitere Informationen finden Sie unter Unterstützte Sprachen in Azure Maps.
includeJamcidents		Nicht unterstützt	Nicht unterstützt	Nicht unterstützt	Azure Maps gibt standardmäßig ungewöhnliche Datenverkehrsbedingungen zurück.
severity	`s`	Nicht unterstützt	Nicht unterstützt	Nicht unterstützt	Azure Maps gibt Datenverkehrsvorfälle aller Schweregrade standardmäßig zurück.
type	`t`	Nicht unterstützt	Nicht unterstützt	Nicht unterstützt	Azure Maps gibt standardmäßig Datenverkehrsvorfälle aller Arten zurück.

Weitere Informationen zu den Azure Maps-Anforderungsparametern finden Sie unter URI-Parameter in der Dokumentation zur Azure Maps Get Traffic Incident Detail-API.

Beispiele für Anforderungen

Anforderung der Bing Maps Get Traffic Incidents-API:

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

Azure Maps Get Traffic Incident Detail API-Anforderung:

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}

Antwortfelder

In der folgenden Tabelle sind die Felder aufgeführt, die in der HTTP-Antwort angezeigt werden können, wenn die Bing Maps Get Traffic Incidents-API und die Azure Maps-Entsprechung ausgeführt werden:

Bing Maps-Antwortfeld	Azure Maps Antwortfeld	Beschreibung
Beschreibung (Json) Beschreibung (XML)	`d`	Diese Ausgabe befindet sich im tm-Antwortelement von Azure Maps.
End (Json) EndTimeUTC (XML)	`ed`	Diese Ausgabe befindet sich im tm-Antwortelement von Azure Maps. Das Datum wird im ISO8601-Format beschrieben und enthält die Zeit in UTC.
eventList (Json) EventList (XML)	Nicht unterstützt
icon (Json) Icon (XML)	`ic`	Diese Ausgabe befindet sich im tm-Antwortelement von Azure Maps. Weitere Informationen finden Sie unter IconCategory (`ic`).
incidentId (Json) IncidentId (XML)	`id`	Diese Ausgabe befindet sich im tm-Antwortelement von Azure Maps.
isEndTimeBackfilled (Json) IsEndTimeBackfilled (XML)	Nicht unterstützt
isJamcident (Json) IsJamcident (XML)	Nicht unterstützt
lastModified (Json) LastModifiedUTC (XML)	Nicht unterstützt
point (Json) Point (XML)	`p`	Diese Ausgabe befindet sich im tm-Antwortelement von Azure Maps. Weitere Informationen finden Sie unter point (`p`).
roadClosed (Json) RoadClosed (XML)	Siehe Beschreibung	Die IconCategory-Ausgabe des tm-Antwortelements von Azure Maps kann verwendet werden, um eine Straßenschließung anzugeben.
severity (Json) Severity (XML)	`ty`	Diese Ausgabe befindet sich im tm-Antwortelement. Weitere Informationen finden Sie unter DelayMagnitude: (`ty`)
severityScore (Json) SeverityScore (XML)	Nicht unterstützt
Start (Json) StartTimeUTC (XML)	`sd`	Diese Ausgabe befindet sich im tm-Antwortelement von Azure Maps. Das Datum wird im ISO8601-Format beschrieben und enthält die Zeit in UTC.
title (Json) Title (XML)	Siehe Beschreibung	Die `f`-Ausgabe im tm-Antwortelement von Azure Maps stellt den Namen der Schnittmenge oder den Ort bereit, an dem der vom Vorfall verursachte Datenverkehr beginnt und als Alternative zur Bing Maps-Ausgabe `title` dienen kann.
toPoint (Json) ToPoint (XML)	Siehe Beschreibung	Die `t`-Ausgabe im tm-Antwortelement von Azure Maps stellt den Namen der Schnittmenge oder den Ort bereit, an dem der Datenverkehr aufgrund des Vorfalls endet und als Alternative zur Bing Maps-Ausgabe `toPoint` dienen kann.
type (Json) Typ (XML)	`c`	Die `c`-Ausgabe im tm-Antwortelement von Azure Maps stellt die Ursache des Vorfalls bereit, falls verfügbar.

Weitere Informationen zu den Antwortfeldern der Azure Maps Get Traffic Incident Detail API finden Sie unter Antworten.

Beispielantworten

Das folgende JSON-Beispiel zeigt, was im Textkörper der HTTP-Antwort zurückgegeben wird, wenn die Anforderung von Bing Maps Get Traffic Incidents ausgeführt wird:

{
    "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"
}

Das folgende JSON-Beispiel zeigt, was im Textkörper der HTTP-Antwort zurückgegeben wird, wenn eine Azure Maps Get Traffic Incident Detail-Anforderung ausgeführt wird:

{
    "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
            }
        ]
    }
}

Transaktionsnutzung

Wie Bing Maps Get Traffic Incidents-API protokolliert Azure Maps Get Traffic Incident Detail-API eine abrechnungsfähige Transaktion pro Anforderung. Weitere Informationen zu Azure Maps-Transaktionen finden Sie unter Grundlegendes zu Azure Maps-Transaktionen.

Weitere Informationen

Andere Azure Maps Traffic-APIs

Get Traffic Flow Segment. Wird verwendet, um Informationen über die Geschwindigkeiten und Fahrzeiten des angegebenen Straßenabschnitts zu erhalten.
Get Traffic Flow Tile. Wird verwendet, um 256 x 256 Pixel-Kacheln mit Datenverkehrsfluss zu erhalten.
Get Traffic Incident Tile. Wird verwendet, um 256 x 256 Pixel-Kacheln mit Datenverkehrsvorfällen zu erhalten.
Get Traffic Incident Viewport. Hier erhalten Sie rechtliche und technische Informationen für einen Viewport.

Unterstützung

Microsoft Q&A-Forum

Freigeben über