Traffic - Get Traffic Flow Tile

Kachel "Datenverkehr Flow"

Gilt für: Siehe Tarife.

Die Azure Flow-Kachel-API bietet Kacheln mit 256 x 256 Pixeln, die den Datenverkehrsfluss anzeigen. Alle Kacheln verwenden das gleiche Rastersystem. Da die Verkehrskacheln transparente Bilder verwenden, können sie über Kartenkacheln übereinander platziert werden, um eine Verbundanzeige zu erstellen. Die Flow Kacheln verwenden Farben, um entweder die Geschwindigkeit des Verkehrs in verschiedenen Straßensegmenten oder den Unterschied zwischen dieser Geschwindigkeit und der Geschwindigkeit des freien Flusses 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 Required Type Description
format
path True

Das gewünschte Format der Antwort. Mögliche Werte sind png & pbf.

api-version
query True
  • string

Versionsnummer der Azure Karten-API.

style
query True

Der Stil, der zum Rendern der Kachel verwendet werden soll.

x
query True
  • integer
int32

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

Weitere Informationen finden Sie unter Zoomstufen und Kachelraster .

y
query True
  • integer
int32

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

Weitere Informationen finden Sie unter Zoomstufen und Kachelraster .

zoom
query True
  • integer
int32

Zoomfaktor für die gewünschte Kachel. Bei Rasterkacheln muss sich der Wert im Bereich von 0 bis 22 (einschließlich) befinden. Für Vektorkacheln muss der Wert im Bereich 0-22 (einschließlich) liegen. Weitere Informationen finden Sie unter Zoomstufen und Kachelraster .

thickness
query
  • integer
int32

Der Wert der Breite der Linie, die den Datenverkehr darstellt. Dieser Wert ist ein Multiplikator, und die akzeptierten Werte liegen zwischen 1 und 20. Der Standardwert ist 10. Dieser Parameter ist ungültig, wenn das Format pbf ist.

Anforderungsheader

Name Required Type Description
x-ms-client-id
  • string

Gibt an, welches Konto für die Verwendung in Verbindung mit dem Azure AD-Sicherheitsmodell vorgesehen ist. Sie stellt eine eindeutige ID für das Azure Karten-Konto dar und kann von der Konto-API der Azure Karten-Verwaltungsebene abgerufen werden. Informationen zur Verwendung Azure AD Sicherheit in Azure Karten finden Sie in den folgenden Artikeln.

Antworten

Name Type Description
200 OK
  • object

Dieses Bild wird von einem erfolgreichen Aufruf von Traffic Flow Tile zurückgegeben.

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

Headers

  • Content-Type: string
Other Status Codes

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 Azure Active Directory OAuth2-Flows. In Kombination mit der rollenbasierten Zugriffssteuerung von Azure kann sie verwendet werden, um den Zugriff auf Azure Karten REST-APIs zu steuern. Rollenbasierte Zugriffssteuerungen in Azure werden verwendet, um den Zugriff auf mindestens ein Azure Karten-Ressourcenkonto oder untergeordnete Ressourcen festzulegen. Jedem Benutzer, jeder Gruppe oder jedem Dienstprinzipal kann Zugriff über eine integrierte Rolle oder eine benutzerdefinierte Rolle gewährt werden, die aus mindestens einer Berechtigung für Azure Karten REST-APIs besteht.

Um Szenarien zu implementieren, wird empfohlen, Authentifizierungskonzepte anzuzeigen. Zusammenfassend bietet diese Sicherheitsdefinition eine Lösung zum Modellieren von Anwendungen über Objekte, die zugriffssteuerungsfähig für bestimmte APIs und Bereiche sind.

Notizen

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

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

  • Derzeit unterstützt Azure Active Directory v1.0 oder v2.0 Arbeits-, Schul- und Gastkonten, aber keine persönlichen Konten.

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

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

subscription-key

Dies ist ein gemeinsam verwendeter Schlüssel, der beim Erstellen einer Azure Karten-Ressource über die Azure-Verwaltungsebene über Azure-Portal, PowerShell, CLI, Azure SDKs oder REST-APIs bereitgestellt wird.

Mit diesem Schlüssel ist jede Anwendung berechtigt, auf alle REST-APIs zuzugreifen. Anders ausgedrückt: Diese können derzeit als Hauptschlüssel für das Konto behandelt werden, für das sie ausgestellt werden.

Für öffentlich verfügbar gemachte Anwendungen wird empfohlen, den Server-zu-Server-Zugriff auf Azure Karten REST-APIs zu verwenden, in denen dieser Schlüssel sicher gespeichert werden kann.

Type: apiKey
In: query

SAS Token

Dies ist ein SAS-Token für den gemeinsamen Zugriff, das aus dem Vorgang SAS auflisten für die Azure Karten-Ressource über die Azure-Verwaltungsebene über Azure-Portal, PowerShell, CLI, Azure SDKs oder REST-APIs erstellt wird.

Mit diesem Token ist jede Anwendung für den Zugriff mit rollenbasierten Azure-Zugriffssteuerungen und einer differenzierten Steuerung des Ablaufs, der Rate und der Regionen autorisiert, die für das jeweilige Token verwendet werden. Anders ausgedrückt: Das SAS-Token kann verwendet werden, um Anwendungen die Steuerung des Zugriffs auf sicherere Weise als der gemeinsam genutzte Schlüssel zu ermöglichen.

Für öffentlich verfügbar gemachte Anwendungen empfiehlt es sich, eine bestimmte Liste zulässiger Ursprünge in der Map-Kontoressource zu konfigurieren, um Rendering-Missbrauch einzuschränken und das SAS-Token regelmäßig zu erneuern.

Type: apiKey
In: header

Beispiele

Request tile depicting the traffic flow

Sample Request

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

Sample Response

"binary string image"

Definitionen

ErrorAdditionalInfo

Zusätzliche Informationen zu Ressourcenverwaltungsfehlern.

ErrorDetail

Die Fehlerdetails.

ErrorResponse

Fehlerantwort

TileFormat

Das gewünschte Format der Antwort. Mögliche Werte sind png & pbf.

TrafficFlowTileStyle

Der Stil, der zum Rendern der Kachel verwendet werden soll.

ErrorAdditionalInfo

Zusätzliche Informationen zu Ressourcenverwaltungsfehlern.

Name Type Description
info
  • object

Die zusätzlichen Informationen.

type
  • string

Der zusätzliche Infotyp.

ErrorDetail

Die Fehlerdetails.

Name Type Description
additionalInfo

Die zusätzlichen Informationen zum Fehler.

code
  • string

Der Fehlercode.

details

Die Fehlerdetails.

message
  • string

Die Fehlermeldung.

target
  • string

Das Fehlerziel.

ErrorResponse

Fehlerantwort

Name Type Description
error

Das Fehlerobjekt.

TileFormat

Das gewünschte Format der Antwort. Mögliche Werte sind png & pbf.

Name Type Description
pbf
  • string

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

png
  • string

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

TrafficFlowTileStyle

Der Stil, der zum Rendern der Kachel verwendet werden soll.

Name Type Description
absolute
  • string

Farben spiegeln die gemessene absolute Geschwindigkeit wider. Absolute Geschwindigkeit ist die Fähigkeit, auf die volle Geschwindigkeit zuzugreifen.

reduced-sensitivity
  • string

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

relative
  • string

Dies ist die Geschwindigkeit relativ zum freien Fluss, wobei Überlastungsbereiche hervorgehoben werden, die den Datenverkehrsfluss visualisieren. Der freie Fluss bezieht sich auf Bedingungen, bei denen keine Überlastung vorliegt und der Datenverkehr die Geschwindigkeitsbegrenzungen einhalten kann. Die am häufigsten verwendete Option zum Visualisieren des Datenverkehrsflusses auf einer Karte.

relative-delay
  • string

Zeigt relative Farben nur an, wenn sie sich von den Geschwindigkeiten des freien Flusses unterscheiden. Diese Option hebt nur Überlastungsbereiche hervor.