Render - Get Map Static Image

Služba:

Maps

Verze rozhraní API:

2024-04-01

Toto rozhraní API pro vykreslování vytváří statická rastrová zobrazení mapy uživatelem definované oblasti. Je vhodný pro jednoduché webové aplikace, pokud požadované uživatelské prostředí nevyžaduje interaktivní ovládací prvky mapy nebo je-li šířka pásma omezená. Toto rozhraní API je také užitečné pro vkládání map do aplikací mimo prohlížeč, v back-endových službách, generování sestav nebo desktopových aplikacích.

Toto rozhraní API obsahuje parametry pro základní vizualizaci dat:

• Popisky připínáků ve více stylech
• Vykreslujte kruh, cestu a typy geometrie mnohoúhelníku.

Další informace a podrobné příklady najdete v tématu Vykreslení vlastních dat na rastrové mapě.

Rozměry parametru bboxu jsou omezené v závislosti na úrovni přiblížení. Tím zajistíte, že výsledný obrázek má odpovídající úroveň podrobností.

Úroveň zvětšení	Minimální rozsahlonů	Maximální dosah Lon	Minimální rozsah lat	Maximální rozsah Lat
0	56.25	360.0	30.1105585173	180.0
1	28.125	360.0	14.87468995	180.0
2	14.063	351.5625	7.4130741851	137.9576312246
3	7.03125	175.78125	3.7034501005	73.6354071932
4	3.515625	87.890625	1.8513375155	35.4776115315
5	1.7578125	43.9453125	0.925620264	17.4589959239
6	0.87890625	21.97265625	0.4628040687	8.6907788223
7	0.439453125	10.986328125	0.2314012764	4.3404320789
8	0.2197265625	5.4931640625	0.1157005434	2.1695927024
9	0.1098632812	2.7465820312	0.0578502599	1.0847183194
10	0.0549316406	1.3732910156	0.0289251285	0.5423494021
11	0.0274658203	0.6866455078	0.014462564	0.2711734813
12	0.0137329102	0.3433227539	0.007231282	0.1355865882
13	0.0068664551	0.171661377	0.003615641	0.067793275
14	0.0034332275	0.0858306885	0.0018078205	0.0338966351
15	0.0017166138	0.0429153442	0.0009039102	0.0169483173
16	0.0008583069	0.0214576721	0.0004519551	0.0084741586
17	0.0004291534	0.0107288361	0.0002259776	0.0042370793
18	0.0002145767	0.005364418	0.0001129888	0.0021185396
19	0.0001072884	0.002682209	5.64944E-05	0.0010592698
20	5.36442E-05	0.0013411045	2.82472E-05	0.0005296349

Poznámka: Do rozhraní API musí být zadán střed nebo bbox parametr.

GET https://atlas.microsoft.com/map/static?api-version=2024-04-01

S volitelnými parametry:

GET https://atlas.microsoft.com/map/static?api-version=2024-04-01&tilesetId={tilesetId}&trafficLayer={trafficLayer}&zoom={zoom}&center={center}&bbox={bbox}&height={height}&width={width}&language={language}&view={view}&pins={pins}&path={path}

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
api-version	query	True	string	Číslo verze rozhraní API služby Azure Maps Aktuální verze je 2024-04-01.
bbox	query		number[]	Ohraničující rámeček je definován dvěma zeměpisnými šířkami a dvěma délkami, které představují čtyři strany obdélníkové oblasti na Zemi. Formát: "minLon, minLat, maxLon, maxLat" (ve dvou). Poznámka: Požadované parametry jsou bbox nebo střed. Vzájemně se vylučují. Bbox by neměl být použit s výškou ani šířkou. Maximální a minimální povolené rozsahy pro Lat a Lon jsou definovány pro každou úroveň přiblížení v tabulce v horní části této stránky.
center	query		number[]	Souřadnice středového bodu ve dvou. Formát: 'lon,lat'. Zeměpisná délka: -180 až 180. Rozsah zeměpisné šířky: -90 až 90. Poznámka: Požadované parametry jsou buď uprostřed, nebo bbox. Vzájemně se vylučují.
height	query		integer (int32) minimum: 80 maximum: 1500	Výška výsledného obrázku v pixelech Rozsah od 80 do 1500. Výchozí hodnota je 512. Nemělo by se používat s bboxem.
language	query		string	Jazyk, ve kterém mají být vráceny výsledky hledání. Měla by být jednou z podporovaných značek jazyka IETF, nerozlišují se malá a velká písmena. Pokud data v zadaném jazyce nejsou pro konkrétní pole dostupná, použije se výchozí jazyk. Podrobnosti najdete v podporovaných jazycích.
path	query		string[]	Styl cesty a umístění (ve dvou). Pomocí tohoto parametru můžete do obrázku volitelně přidat čáry, mnohoúhelníky nebo kruhy. Styl cesty popisuje vzhled čáry a výplně. (Nezapomeňte správně kódovat adresy URL hodnoty tohoto parametru, protože bude obsahovat rezervované znaky, jako jsou kanály a interpunkce.) Parametr cesty se podporuje ve skladové posadě SKU účtu Azure Maps počínaje S1. Více instancí parametru cesty umožňuje zadat více geometrií s jejich styly. Počet parametrů na požadavek je omezený na 10 a počet umístění je omezený na 100 na cestu. Pokud chcete vykreslit kruh s poloměrem 100 metrů a středovým bodem v zeměpisné šířce 45°N a délce 122°W pomocí výchozího stylu, přidejte parametr řetězce dotazu. path=ra100||-122 45 Všimněte si, že zeměpisná délka předchází zeměpisné šířce. Po kódování adresy URL bude vypadat takto: path=ra100%7C%7C-122+45 Všechny zde uvedené příklady ukazují parametr cesty bez kódování adresy URL, aby bylo jasné. Pokud chcete vykreslit čáru, oddělte každé umístění znakem svislé čáry. Například použijte path=||-122 45|-119.5 43.2|-121.67 47.12 Mnohoúhelník je určen uzavřenou cestou, kde jsou první a poslední body stejné. Například použijte path=||-122 45|-119.5 43.2|-121.67 47.12|-122 45 Zeměpisná délka pro umístění čar a mnohoúhelníku může být v rozsahu od -360 do 360, aby bylo možné vykreslovat geometrie překračující anti-meridian. Modifikátory stylu Vzhled cesty můžete upravit přidáním modifikátorů stylu. Ty se přidají před umístění. Modifikátory stylu mají každý název se dvěma písmeny. Tyto zkrácené názvy slouží ke snížení délky adresy URL. Pokud chcete změnit barvu obrysu, použijte modifikátor stylu "lc" a zadejte barvu pomocí barevného formátu HTML/CSS RGB, což je šesticiferné šestnáctkové číslo (třímístný formulář není podporován). Pokud chcete například použít hlubokou růžovou barvu, kterou byste zadali jako #FF1493 v šabloně stylů CSS, použijte path=lcFF1493||-122 45|-119.5 43.2 K vytvoření složitějšího vizuálního stylu lze kombinovat více modifikátorů stylu. lc0000FF|lw3|la0.60|fa0.50||-122.2 47.6|-122.2 47.7|-122.3 47.7|-122.3 47.6|-122.2 47.6 Souhrn modifikátoru stylu Modifikátor Popis Typ Rozmezí Lc Barva čáry řetězec 000000 až FFFFFF fc Barva výplně řetězec 000000 až FFFFFF předložka z francouzštiny Čára alfa (neprůhlednost) float 0 až 1 fa Výplň alfa (neprůhlednost) float 0 až 1 Lw Šířka čáry int32 (0, 50] Ra Poloměr kruhu (měřiče) float Větší než 0
pins	query		string[]	Styl a instance připínáku. Tento parametr použijte k volitelnému přidání připínáků do image. Styl připínáčku popisuje vzhled připínáčku a instance určují souřadnice připínáčku (v dvojitém) a volitelné popisky pro každý kolík. (Nezapomeňte správně kódovat adresy URL hodnoty tohoto parametru, protože bude obsahovat rezervované znaky, jako jsou kanály a interpunkce.) Skladová položka účtu Azure Maps podporuje pouze jednu instanci parametru špendlíků a počet umístění je omezený na 5 míst na pin. Ostatní skladové položky umožňují zadat více stylů špendlíků až 25 instancí parametru pinů a počet umístění je omezený na 50 míst na špendlík. Pokud chcete vykreslit připínák v zeměpisné šířce 45°N a délce 122°W pomocí výchozího integrovaného stylu připnutí, přidejte parametr řetězce dotazu. pins=default||-122 45 Všimněte si, že zeměpisná délka předchází zeměpisné šířce. Po kódování adresy URL bude vypadat takto: pins=default%7C%7C-122+45 Všechny zde uvedené příklady ukazují parametr špendlíků bez kódování adresy URL, aby bylo jasné. Pokud chcete vykreslit špendlík na více místech, oddělte každé umístění znakem svislé roury. Například použijte pins=default||-122 45|-119.5 43.2|-121.67 47.12 Skladová položka účtu S0 Azure Maps umožňuje pouze pět připínáků. Jiné skladové položky účtu toto omezení nemají. Modifikátory stylu Vzhled špendlíků můžete upravit přidáním modifikátorů stylu. Ty se přidají za styl, ale před umístění a popisky. Modifikátory stylu mají každý název se dvěma písmeny. Tyto zkrácené názvy slouží ke snížení délky adresy URL. Pokud chcete změnit barvu připínáku, použijte modifikátor stylu "co" a zadejte barvu pomocí barevného formátu HTML/CSS RGB, což je šesticiferné šestnáctkové číslo (tříciferný formulář není podporován). Pokud chcete například použít hlubokou růžovou barvu, kterou byste zadali jako #FF1493 v šabloně stylů CSS, použijte pins=default|coFF1493||-122 45 Popisky připínáku Pokud chcete k špendlíkům přidat popisek, vložte ho do jednoduchých uvozovek těsně před souřadnice. Nepoužívejte speciální znak, například | nebo || v popisku. Pokud chcete například označit tři špendlíky s hodnotami 1, 2 a 3, použijte pins=default||'1'-122 45|'2'-119.5 43.2|'3'-121.67 47.12 K dispozici je integrovaný styl připínáku s názvem none, který nezobrazuje obrázek připínáku. Tuto možnost můžete použít, pokud chcete zobrazit popisky bez připnutí obrázku. Příklad: pins=none||'A'-122 45|'B'-119.5 43.2 Pokud chcete změnit barvu popisků připínáku, použijte modifikátor stylu barvy popisku "lc". Pokud chcete například použít růžové připínáky s černými štítky, použijte pins=default|coFF1493|lc000000||-122 45 Pokud chcete změnit velikost popisků, použijte modifikátor stylu velikosti popisku "ls". Velikost popisku představuje přibližnou výšku textu popisku v pixelech. Pokud chcete například zvětšit velikost popisku na 12, použijte pins=default|ls12||'A'-122 45|'B'-119 43 Popisky se zacentrují na připínáč "ukotvení popisku". Umístění ukotvení je předdefinované pro předdefinované připínáky a je v horní části vlastního připínáku (viz níže). Pokud chcete přepsat ukotvení popisku, použijte modifikátor stylu "la" a zadejte souřadnice X a Y pixelů pro ukotvení. Tyto souřadnice jsou relativní vzhledem k levému hornímu rohu obrázku připnutí. Kladné hodnoty X přesunou ukotvení doprava a kladné hodnoty Y přesunou ukotvení dolů. Pokud chcete například umístit ukotvení popisku o 10 pixelů doprava a 4 pixely nad levým horním rohem obrázku připínáčku, použijte pins=default|la10 -4||'A'-122 45|'B'-119 43 Vlastní připínáky Pokud chcete použít vlastní obrázek připínáčku, použijte jako název stylu připnutí slovo "vlastní" a za informace o umístění a popisku zadejte adresu URL. Maximální povolená velikost obrázku přizpůsobeného štítku je 65 536 pixelů. Použijte dva znaky svislé znaky k označení, že jste dokončili zadávání umístění a spouštíte adresu URL. Příklad: pins=custom||-122 45||http://contoso.com/pushpins/red.png Po kódování adresy URL by to vypadalo takto: pins=custom%7C%7C-122+45%7C%7Chttp%3A%2F%2Fcontoso.com%2Fpushpins%2Fred.png Ve výchozím nastavení jsou vlastní obrázky připínáčku nakreslené na střed na souřadnicích kolíku. Obvykle to není ideální, protože zakrývá umístění, které se snažíte zvýraznit. Pokud chcete přepsat umístění ukotvení obrázku špendlíku, použijte modifikátor stylu "an". Používá se stejný formát jako modifikátor stylu ukotvení popisku "la". Pokud má například obrázek vlastního špendlíku v levém horním rohu obrázku špičku, můžete ukotvení nastavit na toto místo pomocí příkazu . pins=custom|an0 0||-122 45||http://contoso.com/pushpins/red.png Poznámka: Pokud použijete modifikátor barev "co" s vlastním obrázkem připnutí, zadaná barva nahradí kanály RGB pixelů na obrázku, ale ponechá alfa (neprůhledný) kanál beze změny. Obvykle by se to provádělo jenom s vlastním obrázkem s plnou barvou. Škálování, otočení a neprůhlednost Pomocí modifikátoru stylu měřítka sc můžete zvětšit nebo zmenšit popisky a jejich popisky. Jedná se o hodnotu větší než nula. Hodnota 1 je standardní měřítko. Hodnoty větší než 1 zvětší špendlíky a hodnoty menší než 1 je zmenší. Pokud chcete například nakreslit čepy 50% větší než normální, použijte pins=default|sc1.5||-122 45 Pomocí modifikátoru stylu otočení "ro" můžete otočit připínáče a jejich popisky. Jedná se o řadu stupňů otočení po směru hodinových ručiček. K otočení proti směru hodinových ručiček použijte záporné číslo. Pokud chcete například otočit připínáky o 90 stupňů po směru hodinových ručiček a zdvojnásobit jejich velikost, použijte pins=default|ro90|sc2||-122 45 Pomocí modifikátoru alfa "al" můžete nastavit částečně průhledné připínáky a jejich popisky. Jedná se o číslo v rozmezí od 0 do 1 označující neprůhlednost připínáku. Nula z nich dělá zcela průhledné (a není viditelné) a 1 je zcela neprůhledné (což je výchozí nastavení). Pokud například chcete, aby se připínáky a jejich popisky používaly pouze 67% neprůrůznamné, použijte pins=default|al.67||-122 45 Souhrn modifikátoru stylu Modifikátor Popis Typ Rozmezí hliník Alfa (neprůhlednost) float 0 až 1 jakýsi Připnout ukotvení <int32, int32> * co Barva špendlíku řetězec 000000 až FFFFFF předložka z francouzštiny Ukotvení popisku <int32, int32> * Lc Barva popisku řetězec 000000 až FFFFFF ls Velikost popisku float Větší než 0 ro Rotace float -360 až 360 sc Škála float Větší než 0 Souřadnice X a Y můžou být kdekoli v rámci připnutí obrázku nebo okraje kolem něj. Velikost okraje je minimální šířka a výška kolíku.
tilesetId	query		TilesetId	Styl mapy, který se má vrátit Možné hodnoty jsou microsoft.base.road, microsoft.base.darkgrey a microsoft.imagery. Výchozí hodnota je nastavená na microsoft.base.road. Další informace najdete v tématu Vykreslit id sady dlaždic.
trafficLayer	query		TrafficTilesetId	Nepovinná hodnota označující, že výsledek obrázku nepřekryje žádný tok provozu. Možné hodnoty jsou microsoft.traffic.relative.main a žádné. Výchozí hodnota není žádná, což znamená, že se nevrátí žádný tok provozu. Pokud je k dispozici id sady dlaždic souvisejících s provozem, vrátí se obrázek mapy s odpovídající vrstvou provozu. Další informace najdete v tématu Vykreslit id sady dlaždic.
view	query		LocalizedMapView	Parametr Zobrazení (označovaný také jako parametr "oblast uživatele") umožňuje zobrazit správné mapy pro určitou zemi nebo oblast pro geopolitické sporné oblasti. Různé země/oblasti mají různá zobrazení těchto oblastí a parametr View umožňuje vaší aplikaci dodržovat zobrazení vyžadované zemí nebo oblastí, kterou bude vaše aplikace obsluhovat. Ve výchozím nastavení je parametr View nastavený na Sjednocený, i když jste ho v požadavku nedefinovali. Je vaší zodpovědností určit umístění uživatelů a pak nastavit parametr View správně pro dané umístění. Alternativně máte možnost nastavit View=Auto, která vrátí mapová data na základě IP adresy požadavku. Parametr Zobrazení ve službě Azure Maps se musí používat v souladu s příslušnými zákony, včetně těch týkajících se mapování, země/oblasti, kde jsou mapy, obrázky a další data a obsah třetích stran, ke kterému máte oprávnění přistupovat přes Azure Maps, je zpřístupněn. Příklad: view=IN. Podrobnosti a dostupné zobrazení najdete v podporovaných zobrazeních.
width	query		integer (int32) minimum: 80 maximum: 2000	Šířka výsledného obrázku v pixelech Rozsah od 80 do 2000. Výchozí hodnota je 512. Neměl by se používat s bboxem.
zoom	query		integer (int32) minimum: 0 maximum: 20	Požadovaná úroveň přiblížení mapy. Podpora rozsahu hodnot zvětšení od 0 do 20 (včetně) pro tilesetId je microsoft.base.road nebo microsoft.base.darkgrey. Podpora rozsahu hodnot přiblížení od 0 do 19 (včetně) pro tilesetId je microsoft.imagery. Výchozí hodnota je 12. Další informace najdete v tématu úrovně přiblížení a mřížky dlaždic.

Hlavička požadavku

Name	Vyžadováno	Typ	Description
x-ms-client-id		string	Označuje účet určený pro použití s modelem zabezpečení Microsoft Entra ID. Toto jedinečné ID pro účet Azure Maps lze získat z rozhraní API účtu roviny správy Azure Maps. Další informace o používání zabezpečení Microsoft Entra ID v Azure Maps najdete v tématu Správa ověřování v Azure Maps.
Accept		MediaType	Pole záhlaví Accept lze použít k určení předvoleb týkajících se typů médií odpovědí. Mezi povolené typy médií patří image/jpeg a image/png. Vraťte obrázek do image/png, pokud není zadáno záhlaví Přijmout.

Odpovědi

Name	Typ	Description
200 OK	object	Tento obrázek je vrácen z úspěšného volání Get Map Static Image. Media Types: "image/jpeg", "image/png" Hlavičky Content-Type: string
Other Status Codes	ErrorResponse	Došlo k neočekávané chybě. Media Types: "image/jpeg", "image/png"

Zabezpečení

AADToken

Jedná se o Microsoft Entra OAuth 2.0 Flow. Při spárování s přístupu na základě role Azure se dá řídit přístup k rozhraním REST API služby Azure Maps. Řízení přístupu na základě role Azure slouží k určení přístupu k jednomu nebo více úč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 složené z jednoho nebo více oprávnění k rozhraním REST API služby Azure Maps.

Chcete-li implementovat scénáře, doporučujeme zobrazit koncepty ověřování. Stručně řečeno, 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 rozsahy.

Poznámky

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

Authorization URL je specifická pro instanci veřejného cloudu Azure. Suverénní cloudy mají jedinečné adresy URL autorizace a konfigurace MICROSOFT Entra ID. * Řízení přístupu na základě role 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í.

• Další informace o platformě Microsoft Identity Platform najdete v tématu Přehled platformy Microsoft Identity Platform.

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ý je zřízený při vytváření prostředku Azure Maps prostřednictvím roviny správy Azure prostřednictvím webu Azure Portal, PowerShellu, rozhraní příkazového řádku, sad SDK Azure nebo rozhraní REST API.

S tímto klíčem má každá aplikace oprávnění pro přístup ke všem rozhraním REST API. Jinými slovy, tyto klíče lze v současné době považovat za hlavní klíče k účtu, pro který jsou vydány.

U veřejně vystavených aplikací doporučujeme používat přístup mezi servery k rozhraním REST API služby Azure Maps, kde je možné tento klíč bezpečně uložit.

Typ: apiKey
V: header

SAS Token

Jedná se o token sdíleného přístupového podpisu, který se vytvoří z operace Vypsat SAS v prostředku Azure Maps prostřednictvím roviny správy Azure prostřednictvím webu Azure Portal, PowerShellu, rozhraní příkazového řádku, sad SDK Azure 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 Azure a jemně odstupňované řízení vypršení platnosti, rychlosti a oblastí použití pro konkrétní token. Jinými slovy, token SAS lze 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ů na prostředku účtu Map omezit zneužití vykreslování a pravidelně obnovovat token SAS.

Typ: apiKey
V: header

Příklady

Successful Static Image Request

Ukázkový požadavek

HTTP

GET https://atlas.microsoft.com/map/static?api-version=2024-04-01&tilesetId=microsoft.base.road&zoom=10&center=-122.177621,47.613079

Ukázková odpověď

Stavový kód:

200

Content-Type: image/png

"{file}"

Definice

Name	Description
ErrorAdditionalInfo	Další informace o chybě správy prostředků
ErrorDetail	Podrobnosti o chybě.
ErrorResponse	Chybová odpověď
LocalizedMapView	Parametr Zobrazení (označovaný také jako parametr "oblast uživatele") umožňuje zobrazit správné mapy pro určitou zemi nebo oblast pro geopolitické sporné oblasti. Různé země/oblasti mají různá zobrazení těchto oblastí a parametr View umožňuje vaší aplikaci dodržovat zobrazení vyžadované zemí nebo oblastí, kterou bude vaše aplikace obsluhovat. Ve výchozím nastavení je parametr View nastavený na Sjednocený, i když jste ho v požadavku nedefinovali. Je vaší zodpovědností určit umístění uživatelů a pak nastavit parametr View správně pro dané umístění. Alternativně máte možnost nastavit View=Auto, která vrátí mapová data na základě IP adresy požadavku. Parametr Zobrazení ve službě Azure Maps se musí používat v souladu s příslušnými zákony, včetně těch týkajících se mapování, země/oblasti, kde jsou mapy, obrázky a další data a obsah třetích stran, ke kterému máte oprávnění přistupovat přes Azure Maps, je zpřístupněn. Příklad: view=IN. Podrobnosti a dostupné zobrazení najdete v podporovaných zobrazeních.
MediaType	Pole záhlaví Accept lze použít k určení předvoleb týkajících se typů médií odpovědí. Mezi povolené typy médií patří image/jpeg a image/png. Vraťte obrázek do image/png, pokud není zadáno záhlaví Přijmout.
TilesetId	Styl mapy, který se má vrátit Možné hodnoty jsou microsoft.base.road, microsoft.base.darkgrey a microsoft.imagery. Výchozí hodnota je nastavená na microsoft.base.road. Další informace najdete v tématu Vykreslit id sady dlaždic.
TrafficTilesetId	Nepovinná hodnota označující, že výsledek obrázku nepřekryje žádný tok provozu. Možné hodnoty jsou microsoft.traffic.relative.main a žádné. Výchozí hodnota není žádná, což znamená, že se nevrátí žádný tok provozu. Pokud je k dispozici id sady dlaždic souvisejících s provozem, vrátí se obrázek mapy s odpovídající vrstvou provozu. Další informace najdete v tématu Vykreslit id sady dlaždic.

ErrorAdditionalInfo

Objekt

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

Name	Typ	Description
info	object	Další informace.
type	string	Další typ informací.

ErrorDetail

Objekt

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

Objekt

Chybová odpověď

Name	Typ	Description
error	ErrorDetail	Objekt chyby.

LocalizedMapView

Výčet

Parametr Zobrazení (označovaný také jako parametr "oblast uživatele") umožňuje zobrazit správné mapy pro určitou zemi nebo oblast pro geopolitické sporné oblasti. Různé země/oblasti mají různá zobrazení těchto oblastí a parametr View umožňuje vaší aplikaci dodržovat zobrazení vyžadované zemí nebo oblastí, kterou bude vaše aplikace obsluhovat. Ve výchozím nastavení je parametr View nastavený na Sjednocený, i když jste ho v požadavku nedefinovali. Je vaší zodpovědností určit umístění uživatelů a pak nastavit parametr View správně pro dané umístění. Alternativně máte možnost nastavit View=Auto, která vrátí mapová data na základě IP adresy požadavku. Parametr Zobrazení ve službě Azure Maps se musí používat v souladu s příslušnými zákony, včetně těch týkajících se mapování, země/oblasti, kde jsou mapy, obrázky a další data a obsah třetích stran, ke kterému máte oprávnění přistupovat přes Azure Maps, je zpřístupněn. Příklad: view=IN.

Podrobnosti a dostupné zobrazení najdete v podporovaných zobrazeních.

Hodnota	Description
AE	Spojené arabské emiráty (zobrazení arabštiny)
AR	Argentina (argentinský pohled)
BH	Arabština (zobrazení arabštiny)
IN	Indie (indické zobrazení)
IQ	Irák (arabské zobrazení)
JO	Jordánsko (arabské zobrazení)
KW	Kuvajt (arabské zobrazení)
LB	Libanon (zobrazení arabštiny)
MA	Maroko (marocký pohled)
OM	Omán (zobrazení arabštiny)
PK	Pákistán (pákistánské zobrazení)
PS	Palestinská autorita (arabské zobrazení)
QA	Katar (zobrazení arabštiny)
SA	Saúdská Arábie (zobrazení arabštiny)
SY	Sýrie (zobrazení arabštiny)
US	Spojené státy americké
YE	Jemen (arabské zobrazení)
Auto	Vrátí data mapy na základě IP adresy požadavku.
Unified	Jednotné zobrazení (ostatní)

MediaType

Výčet

Pole záhlaví Accept lze použít k určení předvoleb týkajících se typů médií odpovědí. Mezi povolené typy médií patří image/jpeg a image/png. Vraťte obrázek do image/png, pokud není zadáno záhlaví Přijmout.

Hodnota	Description
image/png	Návratový obrázek ve formátu PNG.
image/jpeg	Návratový obrázek ve formátu jpeg.

TilesetId

Výčet

Styl mapy, který se má vrátit Možné hodnoty jsou microsoft.base.road, microsoft.base.darkgrey a microsoft.imagery. Výchozí hodnota je nastavená na microsoft.base.road. Další informace najdete v tématu Vykreslit id sady dlaždic.

Hodnota	Description
microsoft.base.road	TilesetId obsahuje všechny vrstvy s vykreslovacím hlavním stylem.
microsoft.base.darkgrey	TilesetId obsahuje všechny vrstvy s naším tmavě šedým stylem.
microsoft.imagery	TilesetId obsahuje kombinaci satelitních a leteckých snímků.

TrafficTilesetId

Výčet

Nepovinná hodnota označující, že výsledek obrázku nepřekryje žádný tok provozu. Možné hodnoty jsou microsoft.traffic.relative.main a žádné. Výchozí hodnota není žádná, což znamená, že se nevrátí žádný tok provozu. Pokud je k dispozici id sady dlaždic souvisejících s provozem, vrátí se obrázek mapy s odpovídající vrstvou provozu. Další informace najdete v tématu Vykreslit id sady dlaždic.

Hodnota	Description
microsoft.traffic.relative.main	Podporovaný provoz související s tilesetId.
none	Výchozí hodnota, žádné překrytí toku provozu.