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 |
Gewünschtes Format der Antwort. Mögliche Werte sind png & Pbf. |
|
|
api-version
|
query | True |
string |
Versionsnummer der Azure Maps-API. |
|
style
|
query | True |
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, 2 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, 2 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: 1maximum: 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 |
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.
- Weitere Informationen zur Microsoft Identity Platform finden Sie unter Übersicht über die Microsoft Identity Platform.
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 |
|---|---|
|
Error |
Der Ressourcenverwaltungsfehler zusätzliche Informationen. |
|
Error |
Das Fehlerdetails. |
|
Error |
Fehlerantwort |
|
Tile |
Gewünschtes Format der Antwort. Mögliche Werte sind png & Pbf. |
|
Traffic |
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 |
Die zusätzlichen Informationen des Fehlers. |
|
| code |
string |
Der Fehlercode. |
| details |
Die Fehlerdetails. |
|
| message |
string |
Die Fehlermeldung. |
| target |
string |
Das Fehlerziel. |
ErrorResponse
Fehlerantwort
| Name | Typ | Beschreibung |
|---|---|---|
| error |
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. |