Traffic - Get Traffic Incident Tile

  • Reference
Service:
Maps
API Version:
1.0

Umožňuje získat dlaždice o rozměrech 256 × 256 pixelů zobrazující dopravní incidenty.

Rozhraní Traffic Incident Tile API je požadavek HTTP GET , který vrací dlaždice o rozměrech 256 × 256 pixelů, které zobrazují dopravní incidenty. Všechny dlaždice používají stejný systém mřížky. Vzhledem k tomu, že dlaždice provozu používají průhledné obrázky, je možné je vrstvit na dlaždicích map a vytvořit tak složené zobrazení. Dlaždice provozu vykreslují grafiku, která označuje provoz na silnicích v zadané oblasti.

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

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
format
 path True

TileFormat

Požadovaný formát odpovědi. Možné hodnoty jsou png & pbf.
api-version
 query True

string

Číslo verze rozhraní API Azure Maps.
style
 query True

TrafficIncidentTileStyle

Styl, který se má použít k vykreslení dlaždice. Tento parametr není platný, pokud je formát pbf.
x
 query True

integer

int32

Souřadnice X dlaždice v mřížce lupy. Hodnota musí být v rozsahu [0, 2zoom -1].

Podrobnosti najdete v tématu Úrovně přiblížení a Mřížka dlaždic .
y
 query True

integer

int32

Souřadnice Y dlaždice v mřížce lupy. Hodnota musí být v rozsahu [0, 2zoom -1].

Podrobnosti najdete v tématu Úrovně přiblížení a Mřížka dlaždic .
zoom
 query True

integer

int32

Úroveň přiblížení požadované dlaždice U rastrových dlaždic musí být hodnota v rozsahu 0–22 (včetně). U vektorových dlaždic musí být hodnota v rozsahu 0–22 (včetně). Podrobnosti najdete v tématu Úrovně přiblížení a Mřížka dlaždic .
t
 query

string

Referenční hodnota stavu provozu v určitém čase získaná z volání rozhraní API viewport, atributu trafficModelId v poli trafficState. Aktualizuje se každou minutu a platí dvě minuty, než vyprší jeho časový limit. K získání nejnovějších informací o provozu použijte -1. Výchozí: nejnovější informace o provozu.

Hlavička požadavku

Name Vyžadováno Typ Description
x-ms-client-id

string

Určuje, který účet je určen pro použití ve spojení s modelem zabezpečení Microsoft Entra ID. Představuje jedinečné ID účtu Azure Maps a dá se načíst z rozhraní API účtu Azure Maps roviny správy. Pokud chcete použít zabezpečení Microsoft Entra ID v Azure Maps pokyny najdete v následujících článcích.

Odpovědi

Name Typ Description
200 OK

object

Tento objekt se vrátí z úspěšného volání dlaždice dopravního incidentu.

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

Headers

Content-Type: string
Other Status Codes

ErrorResponse

Došlo k neočekávané chybě.

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

Zabezpečení

AADToken

Toto jsou Microsoft Entra toky OAuth 2.0. Při spárování s řízením přístupu na základě role v Azure se dá použít k řízení přístupu k Azure Maps rozhraní REST API. Řízení přístupu na základě role v Azure slouží k určení přístupu k jednomu nebo několika Azure Maps účtu prostředku nebo dílčím prostředkům. Každému uživateli, skupině nebo instančnímu objektu je možné udělit přístup prostřednictvím předdefinované role nebo vlastní role, která se skládá z jednoho nebo více oprávnění k Azure Maps rozhraní REST API.

Pokud chcete implementovat scénáře, doporučujeme zobrazit si koncepty ověřování. Souhrnně řečeno, tato definice zabezpečení poskytuje řešení pro modelování aplikací prostřednictvím objektů schopných řízení přístupu k určitým rozhraním API a oborům.

Poznámky

  • Tato definice zabezpečení vyžaduje použití hlavičky x-ms-client-id k označení Azure Maps prostředku, ke kterému aplikace žádá o přístup. To je možné získat z rozhraní API pro správu map .

Je Authorization URL specifický pro instanci veřejného cloudu Azure. Suverénní cloudy mají jedinečné autorizační adresy URL a konfigurace Microsoft Entra ID. * Řízení přístupu na základě role v Azure se konfiguruje z roviny správy Azure prostřednictvím Azure Portal, PowerShellu, rozhraní příkazového řádku, sad Azure SDK nebo rozhraní REST API. * Použití sady Azure Maps Web SDK umožňuje nastavení aplikace na základě konfigurace pro více případů použití.

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

Jedná se o sdílený klíč, který se zřídí při vytvoření účtu Azure Maps v Azure Portal nebo pomocí PowerShellu, rozhraní příkazového řádku, sad Azure SDK nebo rozhraní REST API.

S tímto klíčem má každá aplikace přístup ke všem rozhraním REST API. Jinými slovy, tento klíč se dá použít jako hlavní klíč v účtu, ve který je vystavený.

U veřejně vystavených aplikací doporučujeme používat pro přístup k rozhraním REST API Azure Maps přístup k důvěrným klientským aplikacím, aby se váš klíč mohl bezpečně uložit.

Type: apiKey
In: query

SAS Token

Jedná se o token sdíleného přístupového podpisu, který se vytvoří z operace List SAS prostředku Azure Maps prostřednictvím roviny správy Azure prostřednictvím Azure Portal, PowerShellu, rozhraní příkazového řádku, sad Azure SDK nebo rozhraní REST API.

S tímto tokenem má každá aplikace oprávnění k přístupu pomocí řízení přístupu na základě role v Azure a podrobného řízení k vypršení platnosti, četnosti a oblastem použití konkrétního tokenu. Jinými slovy, token SAS je možné použít k tomu, aby aplikace mohly řídit přístup bezpečnějším způsobem než sdílený klíč.

U veřejně vystavených aplikací doporučujeme nakonfigurovat konkrétní seznam povolených zdrojů v prostředku mapového účtu , aby se omezilo zneužití vykreslování a pravidelně obnovovali token SAS.

Type: apiKey
In: header

Příklady

Request a tile depicting a traffic incident

Sample Request

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

Sample Response

Status code:
200 
{}

Definice

Name Description
ErrorAdditionalInfo

Další informace o chybě správy prostředků
ErrorDetail

Podrobnosti o chybě.
ErrorResponse

Odpověď na chybu
TileFormat

Požadovaný formát odpovědi. Možné hodnoty jsou png & pbf.
TrafficIncidentTileStyle

Styl, který se má použít k vykreslení dlaždice. Tento parametr není platný, pokud je formát pbf.

ErrorAdditionalInfo

Další informace o chybě správy prostředků

Name Typ Description
info

object

Další informace.
type

string

Další typ informací.

ErrorDetail

Podrobnosti o chybě.

Name Typ Description
additionalInfo

ErrorAdditionalInfo[]

Další informace o chybě
code

string

Kód chyby
details

ErrorDetail[]

Podrobnosti o chybě
message

string

Chybová zpráva
target

string

Cíl chyby.

ErrorResponse

Odpověď na chybu

Name Typ Description
error

ErrorDetail

Objekt chyby.

TileFormat

Požadovaný formát odpovědi. Možné hodnoty jsou png & pbf.

Name Typ Description
pbf

string

Vektorová grafika ve formátu pbf. Podporuje úrovně přiblížení 0 až 22.
png

string

Obrázek ve formátu png. Podporuje úrovně přiblížení 0 až 18.

TrafficIncidentTileStyle

Styl, který se má použít k vykreslení dlaždice. Tento parametr není platný, pokud je formát pbf.

Name Typ Description
night

string

Noční styl.
s1

string

Vytvoří dopravní čáry s barevnými šipkami označujícími závažnost.
s2

string

Vytvoří prosté čáry s určitým stupněm záře.
s3

string

Vytvoří prosté čáry s určitým stupněm záře, které se liší od stylu s2.