Traffic - Get Traffic Flow Tile

Dlaždice toku provozu

Platí pro: cenové úrovně S0 a S1.

Rozhraní API dlaždice toku Azure obsluhuje 256 x 256 pixelů znázorňující tok přenosů. Všechny dlaždice používají stejný systém mřížky. Vzhledem k tomu, že dlaždice přenosů používají průhledné obrázky, mohou být vrstveny na dlaždicích mapy, aby bylo možné vytvořit složený displej. Dlaždice toku používají barvy k indikaci rychlosti provozu na různých silničních segmentech nebo rozdíl mezi touto rychlostí a rychlostí volného toku na straně silničního segmentu.

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}?subscription-key={subscription-key}&api-version=1.0&style={style}&zoom={zoom}&x={x}&y={y}&thickness={thickness}

Parametry identifikátoru URI

Name In Required Type Description
format
path True

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

api-version
query True
  • string

Číslo verze Azure Maps rozhraní API. Aktuální verze je 1,0.

style
query True

Styl, který má být použit 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, 2 zoom -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, 2 zoom -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 Pro rastrové dlaždice musí být hodnota v rozsahu: 0-22 (včetně). Pro vektorové dlaždice musí být hodnota v rozsahu: 0-22 (včetně). Podrobnosti najdete v tématu úrovně přiblížení a mřížka dlaždic .

subscription-key
query
  • string

Jeden z Azure Maps klíčů poskytovaných z účtu mapy Azure. Podrobné informace o správě ověřování najdete v tomto článku .

thickness
query
  • integer
int32

Hodnota šířky čáry, která představuje provoz. Tato hodnota je násobitel a rozsah povolených hodnot od 1-20. Výchozí hodnota je 10. Tento parametr není platný, pokud je formát PBF.

Hlavička požadavku

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

Určuje, který účet je určený pro použití ve spojení s modelem zabezpečení Azure AD. Představuje jedinečné ID pro účet Azure Maps a lze ho načíst z rozhraní API pro účet roviny správy Azure Maps. Postup použití zabezpečení Azure AD v Azure Maps najdete v následujících článcích o návodech.

Odpovědi

Name Type Description
200 OK
  • string

OK

400 Bad Request

Chybný požadavek: jeden nebo více parametrů byl nesprávně zadán nebo se vzájemně vylučují.

401 Unauthorized

Přístup byl odepřen z důvodu neplatného klíče předplatného nebo neplatného tokenu Azure Active Directory nosiče. Ujistěte se, že jste zadali platný klíč pro aktivní předplatné Azure a prostředek map. V opačném případě Ověřte hlavičku WWW-Authenticate pro kód chyby a popis poskytnutého tokenu služby AAD.

Headers

  • WWW-Authenticate: string
403 Forbidden

Problémy s oprávněním, kapacitou nebo ověřováním.

404 Not Found

Nenalezeno: požadovaný prostředek nebyl nalezen, ale v budoucnu může být opět k dispozici.

500 Internal Server Error

Při zpracování požadavku došlo k chybě. Zkuste to později.

Zabezpečení

azure_auth

Toto jsou Azure Active Directory toky OAuth2 . Po párování s řízením přístupu na základě rolí Azure se dá použít k řízení přístupu k rozhraním REST API Azure Maps. Řízení přístupu na základě rolí Azure slouží k určení přístupu k jednomu nebo více Azure Maps účtu prostředku nebo dílčím prostředkům. Každému uživateli, skupině nebo instančnímu objektu se dá udělit přístup prostřednictvím předdefinované role nebo vlastní role složené z jednoho nebo více oprávnění pro Azure Maps rozhraní REST API.

K implementaci scénářů doporučujeme zobrazit Koncepty ověřování. V souhrnu Tato definice zabezpečení poskytuje řešení pro modelování aplikací prostřednictvím objektů schopných řízení přístupu pro konkrétní rozhraní API a obory.

Poznámka

  • Tato definice zabezpečení vyžaduje použití x-ms-client-id hlavičky k označení, ke kterému Azure Maps prostředku aplikace žádá o přístup. To lze získat z rozhraní API pro správu map.
  • Authorization URLJe specifický pro instanci veřejného cloudu Azure. Svrchované cloudy mají jedinečné autorizační adresy URL a konfigurace služby Azure Active Directory.
  • Řízení přístupu na základě rolí Azure je nakonfigurované z plochy správy Azure prostřednictvím Azure Portal, PowerShellu, CLI, sad Azure SDK nebo rozhraní REST API.
  • Použití Azure Maps Web SDK umožňuje nastavení na základě konfigurace aplikace pro více případů použití.
  • V současné době jsou podporovány tokeny Azure Active Directory v 1.0 .

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

subscription-key

Jedná se o sdílený klíč, který se zřídí při vytváření prostředku Azure Maps přes rovinu správy Azure prostřednictvím Azure Portal, PowerShellu, CLI, sad Azure SDK nebo rozhraní REST API. S tímto klíčem jsou všechny aplikace autorizované pro přístup ke všem rozhraním REST API. Jinými slovy, je možné, že se v současné době budou za hlavní klíče vycházet z účtu, pro který jsou vydávány. U veřejně vydaných aplikací doporučujeme použít server pro přístup k serveru Azure Maps rozhraní REST API, kde je možné tento klíč bezpečně uložit.

Type: apiKey
In: query

Příklady

GetTrafficFlowTile

Sample Request

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

Sample Response

"binary string image"
{
  "error": {
    "code": "400 BadRequest",
    "message": "Bad request: one or more parameters were incorrectly specified or are mutually exclusive."
  }
}
{
  "error": {
    "code": "401 Unauthorized",
    "message": "Access denied due to invalid subscription key. Make sure to provide a valid key for an active subscription."
  }
}
{
  "error": {
    "code": "403 Forbidden",
    "message": "Permission, capacity, or authentication issues."
  }
}
{
  "error": {
    "code": "404 NotFound",
    "message": "Not Found: the requested resource could not be found, but it may be available again in the future."
  }
}
{
  "error": {
    "code": "500 InternalServerError",
    "message": "An error occurred while processing the request. Please try again later."
  }
}

Definice

ODataError

Tento objekt se vrátí, když dojde k chybě v rozhraní API služby Maps.

ODataErrorResponse

Tento objekt odpovědi se vrátí, když dojde k chybě v rozhraní API mapy.

TileFormat

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

TrafficFlowTileStyle

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

ODataError

Tento objekt se vrátí, když dojde k chybě v rozhraní API služby Maps.

Name Type Description
code
  • string

Kód ODataError.

details

Tento objekt se vrátí, když dojde k chybě v rozhraní API služby Maps.

message
  • string

V případě, že je k dispozici, čitelný popis chyby.

target
  • string

Je-li k dispozici, cíl způsobil chybu.

ODataErrorResponse

Tento objekt odpovědi se vrátí, když dojde k chybě v rozhraní API mapy.

Name Type Description
error

Tento objekt se vrátí, když dojde k chybě v rozhraní API služby Maps.

TileFormat

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

Name Type 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ý má být použit k vykreslení dlaždice.

Name Type Description
absolute
  • string

Barvy budou odpovídat absolutní měřené rychlosti. Absolutní rychlost je schopnost získat přístup k plné rychlosti.

reduced-sensitivity
  • string

Zobrazí relativní barvy, ale pro segmenty, které mění barvu, se vyžaduje větší rozdíl od FreeFlow. Tento režim je platný pouze v případě, že formát je png.

relative
  • string

Toto je rychlost vzhledem k volnému toku, která zvýrazňuje oblasti zahlcení, které vizualizují tok přenosů. Bezplatné toky označují podmínky, za kterých nedochází k zahlcení a přenos může sledovat omezení rychlosti. Nejčastěji používaná možnost k vizualizaci toku přenosů na mapě.

relative-delay
  • string

Zobrazí relativní barvy pouze v případě, že se liší od rychlosti volného toku. Tato možnost bude zvýrazňovat jenom oblasti zahlcení.