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