Freigeben über


Traffic - Get Traffic Flow Tile

Wird verwendet, um 256 x 256 Pixel Kacheln mit Datenverkehrsfluss 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 Flow Tile-API ist eine HTTP-GET Anforderung, die Echtzeitinformationen zu Verkehrsbedingungen in 256 x 256 Pixel-Kacheln zurückgibt, die den Datenverkehrsfluss 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. Die Flusskacheln verwenden Farben, um entweder die Geschwindigkeit des Verkehrs auf verschiedenen Straßensegmenten oder den Unterschied zwischen dieser Geschwindigkeit und der betreffenden Freilaufgeschwindigkeit auf dem betreffenden Straßensegment anzugeben.

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

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

TrafficFlowTileStyle

Die Formatvorlage, die zum Rendern der Kachel verwendet werden soll.

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-.

thickness
query

integer (int32)

minimum: 1
maximum: 20

Der Wert der Breite der Linie, die Datenverkehr darstellt. Dieser Wert ist ein Multiplizierer und der zulässige Wertebereich zwischen 1 und 20. Der Standardwert ist 10. Dieser Parameter ist ungültig, wenn das Format pbf ist.

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 Bild wird von einem erfolgreichen Aufruf der Datenverkehrsflusskachel 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 tile depicting the traffic flow

Beispielanforderung

GET https://atlas.microsoft.com/traffic/flow/tile/png?api-version=1.0&style=absolute&zoom=12&x=2044&y=1360

Beispiel für eine Antwort

"binary string image"

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.

TrafficFlowTileStyle

Die Formatvorlage, die zum Rendern der Kachel verwendet werden soll.

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.

TrafficFlowTileStyle

Die Formatvorlage, die zum Rendern der Kachel verwendet werden soll.

Wert Beschreibung
absolute

Farben spiegeln die absolute Geschwindigkeit wider. Absolute Geschwindigkeit ist die Möglichkeit, auf die volle Geschwindigkeit zuzugreifen.

relative

Dies ist die Geschwindigkeit relativ zum Freien Fluss, wobei Bereiche der Überlastung hervorgehoben werden, die den Verkehrsfluss visualisieren. Free-Flow bezieht sich auf Bedingungen, unter denen keine Staus vorhanden sind und der Verkehr den Geschwindigkeitsgrenzwerten folgen kann. Die am häufigsten verwendete Option zum Visualisieren des Datenverkehrsflusses auf einer Karte.

relative-delay

Zeigt nur relative Farben an, bei denen sie sich von den Freiflussgeschwindigkeiten unterscheiden. Mit dieser Option werden nur Staugebiete hervorgehoben.

reduced-sensitivity

Zeigt relative Farben an, aber ein größerer Unterschied vom Freilauf ist erforderlich, damit Segmente die Farbe ändern können. Dieser Modus ist nur gültig, wenn das Format png ist.