Sdílet prostřednictvím


Traffic - Get Traffic Flow Tile

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

Rozhraní Traffic Flow Tile API je požadavek HTTP GET , který vrací informace o podmínkách provozu v reálném čase na dlaždicích o rozměrech 256 × 256 pixelů, které zobrazují tok provozu. 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 Flow používají barvy k označení buď rychlosti provozu v různých segmentech silnic, nebo rozdílu mezi danou rychlostí a rychlostí volného toku v daném segmentu silnic.

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}

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 služby Azure Maps

style
query True

TrafficFlowTileStyle

Styl, který se má použít k vykreslení dlaždice.

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 .

thickness
query

integer

int32

Hodnota šířky čáry představující provoz. Tato hodnota je násobitel a přijaté hodnoty jsou v rozsahu od 1 do 20. Výchozí hodnota je 10. Tento parametr není platný, pokud je formát pbf.

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 roviny správy Služby Azure Maps. Informace o použití zabezpečení Microsoft Entra ID ve službě Azure Maps najdete v následujících článcích .

Odpovědi

Name Typ Description
200 OK

object

Tento obrázek se vrátí z úspěšného volání dlaždice toku provozu.

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

Hlavičky

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 toky Microsoft Entra 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 rozhraním REST API služby Azure Maps. Řízení přístupu na základě role v Azure slouží k určení přístupu k jednomu nebo několika účtům prostředků nebo dílčím prostředkům Azure Maps. 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 rozhraním REST API služby Azure Maps.

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í prostředku Azure Maps, 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 webu Azure Portal, PowerShellu, rozhraní příkazového řádku, sad Azure SDK nebo rozhraní REST API. * Použití webové sady SDK služby Azure Maps umožňuje nastavení aplikace na základě konfigurace pro více případů použití.

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/authorize

Rozsahy

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 na webu 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žít pro přístup k rozhraním REST API služby Azure Maps přístup k důvěrným klientským aplikacím , aby se váš klíč mohl bezpečně uložit.

Typ: apiKey
V: query

SAS Token

Jedná se o token sdíleného přístupového podpisu, který se vytvoří z operace List SAS v prostředku Azure Maps prostřednictvím roviny správy 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.

Typ: apiKey
V: header

Příklady

Request tile depicting the traffic flow

Ukázkový požadavek

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

Ukázková odpověď

"binary string image"

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.

TrafficFlowTileStyle

Styl, který se má použít k vykreslení dlaždice.

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.

TrafficFlowTileStyle

Styl, který se má použít k vykreslení dlaždice.

Name Typ Description
absolute

string

Barvy budou odrážet absolutní naměřenou rychlost. Absolutní rychlost je schopnost přístupu k plné rychlosti.

reduced-sensitivity

string

Zobrazí relativní barvy, ale k tomu, aby segmenty měnily barvu, vyžaduje větší rozdíl od volného toku. Tento režim platí jenom v případě, že je formát png.

relative

string

Jedná se o rychlost vzhledem k volnému toku, která zvýrazňuje oblasti zahlcení a vizualizuje tok provozu. Volný tok označuje podmínky, kdy nedochází k zahlcení a provoz může dodržovat rychlostní limity. Nejpoužívanější možnost pro vizualizaci toku provozu na mapě

relative-delay

string

Zobrazí relativní barvy jenom tam, kde se liší od rychlosti volného toku. Tato možnost zvýrazní pouze oblasti zahlcení.