Freigeben über


Traffic - Get Traffic Incident Tile

Wird verwendet, um 256 x 256 Pixel Kacheln mit Datenverkehrsvorfällen zu erhalten.

Hinweis

Einstellung des Azure Maps-Verkehrs v1-Diensts

Der Azure Maps-Dienst Traffic v1 ist jetzt veraltet und wird am 31.03.28 eingestellt. Um Dienstunterbrechungen zu vermeiden, müssen alle Aufrufe des Traffic v1-Dienstes bis zum 31.03.28 aktualisiert werden. Weitere Informationen finden Sie unter Migrieren von Azure Maps Traffic 1.0-APIs.

Die Traffic Incident Tile-API ist eine HTTP-GET Anforderung, die 256 x 256 Pixel-Kacheln zurückgibt, die Datenverkehrsvorfälle anzeigen. Alle Kacheln verwenden dasselbe Rastersystem. Da die Verkehrskacheln transparente Bilder verwenden, können sie über Kartenkacheln angeordnet werden, um eine zusammengesetzte Anzeige zu erstellen. Verkehrskacheln rendern Grafiken, um den Verkehr auf den Straßen im angegebenen Bereich anzuzeigen.

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

URI-Parameter

Name In Erforderlich Typ Beschreibung
format
path True

TileFormat

Gewünschtes Format der Antwort. Mögliche Werte sind png & Pbf.

api-version
query True

string

Versionsnummer der Azure Maps-API.

style
query True

TrafficIncidentTileStyle

Die Formatvorlage, die zum Rendern der Kachel verwendet werden soll. Dieser Parameter ist ungültig, wenn das Format pbf ist.

x
query True

integer (int32)

X-Koordinate der Kachel im Zoomraster. Der Wert muss sich im Bereich [0, 2zoom -1] befinden.

Weitere Informationen finden Sie unter Zoomstufen und kachelraster-.

y
query True

integer (int32)

Y-Koordinate der Kachel im Zoomraster. Der Wert muss sich im Bereich [0, 2zoom -1] befinden.

Weitere Informationen finden Sie unter Zoomstufen und kachelraster-.

zoom
query True

integer (int32)

Zoomfaktor für die gewünschte Kachel. Für Raster- Kacheln muss der Wert im Bereich liegen: 0-22 (einschließlich). Für Vektor Kacheln muss der Wert im Bereich liegen: 0-22 (einschließlich). Weitere Informationen finden Sie unter Zoomstufen und kachelraster-.

t
query

string

Referenzwert für den Datenverkehrsstatus zu einem bestimmten Zeitpunkt, abgerufen aus dem Viewport-API-Aufruf, trafficModelId-Attribut im TrafficState-Feld. Sie wird jede Minute aktualisiert und ist für zwei Minuten gültig, bevor ein Zeitüberschreitung erfolgt. Verwenden Sie -1, um die neuesten Datenverkehrsinformationen abzurufen. Standard: neueste Datenverkehrsinformationen.

Anforderungsheader

Name Erforderlich Typ Beschreibung
x-ms-client-id

string

Gibt das Konto an, das für die Verwendung mit dem Microsoft Entra ID-Sicherheitsmodell vorgesehen ist. Diese eindeutige ID für das Azure Maps-Konto kann über die Konto-API der Azure Maps-Verwaltungsebene abgerufen werden. Weitere Informationen zur Verwendung der Microsoft Entra ID-Sicherheit in Azure Maps finden Sie unter Verwalten der Authentifizierung in Azure Maps.

Antworten

Name Typ Beschreibung
200 OK

object

Dieses Objekt wird von einem erfolgreichen Aufruf der Datenverkehrsvorfallkachel zurückgegeben.

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

Header

Content-Type: string

Other Status Codes

ErrorResponse

Ein unerwarteter Fehler ist aufgetreten.

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

Sicherheit

AADToken

Dies sind die Microsoft Entra OAuth 2.0 Flows. Bei Kombination mit rollenbasierten Azure-Zugriff Steuern kann es verwendet werden, um den Zugriff auf Azure Maps-REST-APIs zu steuern. Azure-rollenbasierte Zugriffssteuerungen werden verwendet, um den Zugriff auf ein oder mehrere Azure Maps-Ressourcenkonten oder -Unterressourcen zu bestimmen. Jedem Benutzer, Gruppen- oder Dienstprinzipal kann über eine integrierte Rolle oder eine benutzerdefinierte Rolle, die aus einer oder mehreren Berechtigungen für Azure Maps-REST-APIs besteht, Zugriff gewährt werden.

Um Szenarien zu implementieren, empfehlen wir, Authentifizierungskonzepteanzuzeigen. Zusammenfassend bietet diese Sicherheitsdefinition eine Lösung für die Modellierung von Anwendungen über Objekte, die zugriffsfähig für bestimmte APIs und Bereiche sind.

Hinweise

  • Diese Sicherheitsdefinition erfordert die Verwendung des x-ms-client-id-Headers, um anzugeben, auf welche Azure Maps-Ressource die Anwendung Zugriff anfordert. Dies kann über die Kartenverwaltung API erworben werden.

Die Authorization URL ist spezifisch für die Öffentliche Azure-Cloudinstanz. Souveräne Clouds verfügen über eindeutige Autorisierungs-URLs und Microsoft Entra-ID-Konfigurationen. * Die rollenbasierte Azure-Zugriffssteuerung wird über die Azure-Verwaltungsebene über das Azure-Portal, PowerShell, CLI, Azure SDKs oder REST-APIs konfiguriert. * Die Verwendung des Azure Maps Web SDK ermöglicht die konfigurationsbasierte Einrichtung einer Anwendung für mehrere Anwendungsfälle.

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name Beschreibung
https://atlas.microsoft.com/.default https://atlas.microsoft.com/.default

subscription-key

Dies ist ein freigegebener Schlüssel, der bereitgestellt wird, wenn Sie Erstellen eines Azure Maps-Kontos im Azure-Portal oder mithilfe von PowerShell, CLI, Azure SDKs oder REST-API.

Mit diesem Schlüssel kann jede Anwendung auf alle REST-API zugreifen. Mit anderen Worten, dieser Schlüssel kann als Hauptschlüssel in dem Konto verwendet werden, in dem sie ausgestellt werden.

Für öffentlich zugängliche Anwendungen empfiehlt es sich, die vertraulichen Clientanwendungen Ansatz für den Zugriff auf Azure Maps-REST-APIs zu verwenden, damit Ihr Schlüssel sicher gespeichert werden kann.

Typ: apiKey
In: query

SAS Token

Dies ist ein Freigegebenes Zugriffssignaturtoken wird aus dem Listen-SAS-Vorgang auf der Azure Maps-Ressource über die Azure-Verwaltungsebene über das Azure-Portal, PowerShell, CLI, Azure SDKs oder REST-APIs erstellt.

Mit diesem Token ist jede Anwendung für den Zugriff mit rollenbasierten Azure-Zugriffssteuerungen und feinkörniger Kontrolle auf den Ablauf, die Rate und die Region(en) der Verwendung für das jeweilige Token autorisiert. Mit anderen Worten, das SAS-Token kann verwendet werden, um Anwendungen das Steuern des Zugriffs auf eine sicherere Weise zu ermöglichen als der freigegebene Schlüssel.

Für öffentlich zugängliche Anwendungen empfiehlt es sich, eine bestimmte Liste der zulässigen Ursprünge auf der Zuordnungskontoressource zu konfigurieren,, um das Rendern von Missbrauch zu begrenzen und das SAS-Token regelmäßig zu erneuern.

Typ: apiKey
In: header

Beispiele

Request a tile depicting a traffic incident

Beispielanforderung

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

Beispiel für eine Antwort

{}

Definitionen

Name Beschreibung
ErrorAdditionalInfo

Der Ressourcenverwaltungsfehler zusätzliche Informationen.

ErrorDetail

Das Fehlerdetails.

ErrorResponse

Fehlerantwort

TileFormat

Gewünschtes Format der Antwort. Mögliche Werte sind png & Pbf.

TrafficIncidentTileStyle

Die Formatvorlage, die zum Rendern der Kachel verwendet werden soll. Dieser Parameter ist ungültig, wenn das Format pbf ist.

ErrorAdditionalInfo

Der Ressourcenverwaltungsfehler zusätzliche Informationen.

Name Typ Beschreibung
info

object

Die zusätzlichen Informationen.

type

string

Der zusätzliche Informationstyp.

ErrorDetail

Das Fehlerdetails.

Name Typ Beschreibung
additionalInfo

ErrorAdditionalInfo[]

Die zusätzlichen Informationen des Fehlers.

code

string

Der Fehlercode.

details

ErrorDetail[]

Die Fehlerdetails.

message

string

Die Fehlermeldung.

target

string

Das Fehlerziel.

ErrorResponse

Fehlerantwort

Name Typ Beschreibung
error

ErrorDetail

Das Fehlerobjekt.

TileFormat

Gewünschtes Format der Antwort. Mögliche Werte sind png & Pbf.

Wert Beschreibung
png

Ein Bild im PNG-Format. Unterstützt Zoomstufen 0 bis 18.

pbf

Vektorgrafik im Pbf-Format. Unterstützt Zoomstufen 0 bis 22.

TrafficIncidentTileStyle

Die Formatvorlage, die zum Rendern der Kachel verwendet werden soll. Dieser Parameter ist ungültig, wenn das Format pbf ist.

Wert Beschreibung
s1

Erstellt Verkehrslinien mit farbigen Chevrons, die den Schweregrad angeben.

s2

Erstellt einfache Linien mit einem bestimmten Leuchtgrad.

s3

Erstellt einfache Linien mit bestimmten Leuchtgraden, die sich von der Formatvorlage s2 unterscheiden.

night

Nachtformat.