Render - Get Map Image

Služba:

Maps

Verze rozhraní API:

1.0

Slouží k vykreslení uživatelem definovaného obdélníkového obrázku obsahujícího oddíl mapy pomocí úrovně přiblížení v rozsahu od 0 do 20.

Poznámka

vyřazení služby Azure Maps Render v1

Služba Azure Maps Render v1 je nyní zastaralá a bude vyřazena 17. 9. 26. Aby nedocházelo k přerušení služeb, bude potřeba do 17. 9. 26. aktualizovat všechna volání rozhraní API pro vykreslování v1 tak, aby používalo rozhraní API pro vykreslování v2 .

Podporovaný rozsah rozlišení pro obrázek mapy je od 1x1 do 8192x8192. Pokud se rozhodujete, kdy použít službu statických obrázků ve službě mapových dlaždic, můžete zvážit, jak chcete s vykreslenou mapou pracovat. Pokud bude obsah mapy relativně neměnný, je vhodná statická mapa. Pokud chcete podporovat velké množství přiblížení, posouvání a změny obsahu mapy, bude lepší volbou služba mapových dlaždic.

Služba také poskytuje funkci Image Composition pro získání statického obrázku zpět s dalšími daty, jako jsou: překryvné připínáky a geometrie s následujícími funkcemi Gen1 S0, S1 a Gen2.

V Gen1 S0 můžete:

• Vykreslení až 5 pushpinů zadaných v požadavku
• Zadejte jeden vlastní obrázek pro špendlíky, na které se odkazuje v požadavku.
• Přidání popisků na připínáky

V Gen1 S1 a Gen2 můžete:

• Vykreslení připínáčků prostřednictvím služby Azure Maps Data Service
• Určení více stylů připnutí
• Vykreslovat typy geometrie kruhu, křivky a mnohoúhelníku.
• Vykreslení podporovaných typů geometrie GeoJSON nahraných prostřednictvím služby Azure Maps Data Service

Podrobné příklady najdete v průvodci postupy Vykreslení vlastních dat na rastrové mapě.

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

Podporované oblasti Lat a Lon při použití parametru bbox jsou následující:

Úroveň přiblížení	Max Lon Range	Max Lat Range
0	360.0	170.0
1	360.0	170.0
2	360.0	170.0
3	360.0	170.0
4	360.0	170.0
5	180.0	85,0
6	90.0	42.5
7	45.0	21.25
8	22.5	10.625
9	11.25	5.3125
10	5.625	2.62625
11	2.8125	1.328125
12	1.40625	0.6640625
13	0.703125	0.33203125
14	0.3515625	0.166015625
15	0.17578125	0.0830078125
16	0.087890625	0.0415039063
17	0.0439453125	0.0207519531
18	0.0219726563	0.0103759766
19	0.0109863281	0.0051879883
20	0.0054931641	0.0025939941

GET https://atlas.microsoft.com/map/static/png?api-version=1.0

S volitelnými parametry:

GET https://atlas.microsoft.com/map/static/png?api-version=1.0&layer={layer}&style={style}&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
format	path	True	RasterTileFormat	Požadovaný formát odpovědi. Možná hodnota: png.
api-version	query	True	string	Číslo verze rozhraní API Azure Maps.
bbox	query		number[]	Ohraničující rámeček. Použitá projekce – EPSG:3857. Formát: 'minLon, minLat, maxLon, maxLat'. Poznámka: Požadované parametry jsou bbox nebo center. Vzájemně se vylučují. Neměl by se používat s výškou ani šířkou. Maximá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. Formát: 'lon,lat'. Použitá projekce EPSG:3857. Rozsah zeměpisné délky: -180 až 180. Rozsah zeměpisné šířky: -85 až 85. Poznámka: Požadované parametry jsou buď střed, nebo bbox. Vzájemně se vylučují.
height	query		integer int32	Výška výsledného obrázku v pixelech Rozsah je 1 až 8192. Výchozí hodnota je 512. Neměl by se používat s bboxem.
language	query		string	Jazyk, ve kterém se mají vrátit výsledky hledání. Měl 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 k dispozici, použije se výchozí jazyk. Podrobnosti najdete v části Podporované jazyky .
layer	query		StaticMapLayer	Požadována vrstva mapy. Pokud je vrstva nastavená na popisky nebo hybridní, měl by být formát png.
path	query		string[]	Styl cesty a umístění. 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ě zakódovat hodnoty adresy URL tohoto parametru, protože bude obsahovat vyhrazené znaky, jako jsou například kanály a interpunkční znaména.) Parametr path se podporuje ve skladové položce účtu Azure Maps počínaje S1. Více instancí parametru path 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 na zeměpisné šířce 45°S a délkou 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 to bude vypadat takto: path=ra100%7C%7C-122+45 Všechny zde uvedené příklady pro přehlednost zobrazují parametr path bez kódování adresy URL. 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 Chcete-li vykreslit mnohoúhelník, musí být poslední umístění rovno počátečnímu umístění. Například použijte path=||-122 45|-119.5 43.2|-121.67 47.12|-122 45 Hodnoty zeměpisné délky a šířky pro umístění čar a mnohoúhelníků můžou být v rozsahu -360 až 360, aby bylo možné vykreslovat geometrie překračující anti-poledník. 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í název se dvěma písmeny. Tyto zkrácené názvy pomáhají zkrátit délku 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 šestimístné šestnáctkové číslo (třímístný formulář není podporován). Pokud chcete například použít tmavě růžovou barvu, kterou byste zadali jako #FF1493 v šablonách stylů CSS, použijte path=lcFF1493||-122 45|-119.5 43.2 Kombinací několika modifikátorů stylu lze vytvořit složitější vizuální styl. 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 Získání umístění cest z úložiště dat Azure Maps Pro všechny skladové položky účtu Azure Maps jiné než S0 je možné získat informace o umístění cesty z úložiště dat Azure Maps. Po nahrání dokumentu GeoJSON obsahujícího umístění cesty vrátí služba Data Storage jedinečné ID dat (UDID), které můžete použít k odkazování na data v parametru path. Pokud chcete použít geometrii bodů z nahraného dokumentu GeoJSON jako umístění cesty, zadejte identifikátor UDID v části locations parametru cesty. Třeba path=||udid-29dc105a-dee7-409f-a3f9-22b066ae4713 Všimněte si, že není povoleno kombinovat umístění cest ze služby Data Storage s umístěními zadanými v parametru path. Souhrn modifikátoru stylu Modifikátor Description Rozsah Lc Barva čáry 000000 až FFFFFF Fc Barva výplně 000000 až FFFFFF La Alfa řádku (neprůhlednost) 0 až 1 Dm Výplň alfa (neprůhlednost) 0 až 1 Lw Šířka čáry Větší než 0 Ra Poloměr kruhu (metry) Větší než 0
pins	query		string[]	Styl a instance připínáčků. 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áčků a instance určují souřadnice připínáčků a volitelné popisky pro každý kolík. (Nezapomeňte správně zakódovat hodnoty adresy URL tohoto parametru, protože bude obsahovat vyhrazené znaky, jako jsou například kanály a interpunkční znaména.) Skladová položka S0 účtu Azure Maps podporuje pouze jednu instanci parametru pins. Jiné skladové položky umožňují více instancím parametru pins zadat více stylů připnutí. Pokud chcete vykreslit připínáčko při 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 to bude vypadat takto: pins=default%7C%7C-122+45 Ve všech zde uvedených příkladech se kvůli přehlednosti zobrazuje parametr pins bez kódování adresy URL. Pokud chcete vykreslit špendlík na více místech, oddělte každé umístění znakem svislé čáry. Například použijte pins=default||-122 45|-119.5 43.2|-121.67 47.12 Skladová položka S0 Azure Maps účtu umožňuje pouze pět připínáčků. Jiné skladové položky účtů 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í název se dvěma písmeny. Tyto zkrácené názvy pomáhají zkrátit délku 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 šestimístné šestnáctkové číslo (třímístná forma není podporována). Pokud chcete například použít tmavě růžovou barvu, kterou byste zadali jako #FF1493 v šablonách stylů CSS, použijte pins=default|coFF1493||-122 45 Popisky připínáčků Pokud chcete přidat popisek do špendlíků, vložte ho do jednoduchých uvozovek těsně před souřadnice. Pokud chcete například označit tři špendlíky hodnotami 1, 2 a 3, použijte pins=default||'1'-122 45|'2'-119.5 43.2|'3'-121.67 47.12 Existuje integrovaný styl připínáku s názvem "none", který nezobrazuje obrázek připínáčkem. Tuto možnost můžete použít, pokud chcete zobrazit popisky bez připnutí obrázku. Třeba 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 popisky, 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 například chcete zvětšit velikost popisku na 12, použijte pins=default|ls12||'A'-122 45|'B'-119 43 Popisky jsou na středu připínáčku "ukotvení popisku". Umístění ukotvení je předdefinované pro předdefinované připínáky a je ve středu horní části vlastních připínáčků (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řipínáčku. Kladné hodnoty X posunou ukotvení doprava a kladné hodnoty Y posunou ukotvení dolů. Pokud chcete například umístit ukotvení popisků o 10 pixelů doprava a 4 pixely nad levý horní roh 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, jako název stylu připnutí použijte slovo "vlastní" a za informacemi o umístění a popisku zadejte adresu URL. Pomocí dvou znaků svislé roury označte, že jste dokončili zadávání umístění a že začínáte adresu URL. Třeba 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í se vlastní obrázky připínáčku nakreslují na střed souřadnic špendlíku. Obvykle to není ideální, protože zakrývá místo, které se snažíte zvýraznit. Pokud chcete přepsat umístění ukotvení obrázku připnutí, 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 špičku špendlíku v levém horním rohu obrázku, můžete na toto místo nastavit ukotvení pomocí pins=custom|an0 0||-122 45||http://contoso.com/pushpins/red.png Poznámka: Pokud použijete modifikátor barvy "co" s vlastním obrázkem připínáku, zadaná barva nahradí kanály RGB pixelů v obrázku, ale ponechá alfa (neprůhledný) kanál beze změny. To se obvykle provádí pouze pomocí vlastního obrázku plné barvy. Získání připínáčků z úložiště dat Azure Maps Pro všechny skladové položky účtu Azure Maps s výjimkou S0 je možné informace o umístění připínáku získat z úložiště dat Azure Maps. Po nahrání dokumentu GeoJSON obsahujícího umístění připnutí vrátí služba Data Storage jedinečné ID dat (UDID), které můžete použít k odkazování na data v parametru pins. Pokud chcete použít geometrii bodů z nahraného dokumentu GeoJSON jako umístění špendlíků, zadejte UDID v části locations parametru pins. Třeba pins=default||udid-29dc105a-dee7-409f-a3f9-22b066ae4713 Všimněte si, že se použije pouze geometrie bodů a více bodů, body a více bodů ze kolekcí geometrie a geometrie bodů z prvků. Geometrie čar a mnohoúhelníku bude ignorována. Pokud bod pochází z funkce a funkce má řetězcovou vlastnost s názvem "label", hodnota této vlastnosti se použije jako popisek pro špendlík. Umístění připnutí můžete kombinovat z úložiště dat a umístění připnutí zadaná v parametru pins. Jakékoli umístění kolíku odděleného kanály může být zeměpisná délka a zeměpisná šířka nebo UDID. Třeba pins=default||-122 45|udid-29dc105a-dee7-409f-a3f9-22b066ae4713|-119 43 Škálování, rotace a neprůhlednost Připínáky a jejich popisky můžete zvětšit nebo zmenšit pomocí modifikátoru stylu "sc". Jedná se o hodnotu větší než nula. Hodnota 1 je standardní měřítko. Hodnoty větší než 1 zvětší připnutí a hodnoty menší než 1 je zmenší. Pokud například chcete nakreslit připínáky o 50 % větší než obvykle, použijte pins=default|sc1.5||-122 45 Připínáky a jejich popisky můžete otáčet pomocí modifikátoru stylu otáčení ro. Jedná se o několik stupňů otočení po směru hodinových ručiček. Záporné číslo použijte k otočení proti směru hodinových ručiček. 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 Zadáním modifikátoru stylu alfa "al" můžete připínáky a jejich popisky částečně zprůhlednit. Jedná se o číslo mezi 0 a 1, které označuje neprůhlednost připínáčků. Díky nule jsou zcela průhledné (a nejsou viditelné) a hodnota 1 je zcela neprůhledná (což je výchozí nastavení). Pokud například chcete, aby připínáky a jejich popisky byly neprůstiskné z 67 %, použijte pins=default|al.67||-122 45 Souhrn modifikátoru stylu Modifikátor Description Rozsah Al Alfa (neprůhlednost) 0 až 1 an Připnout ukotvení * co Barva připínáčku 000000 až FFFFFF La Ukotvení popisků * Lc Barva popisku 000000 až FFFFFF ls Velikost popisku Větší než 0 Ro Obměna -360 až 360 Sc Měřítko Větší než 0 Souřadnice X a Y můžou být kdekoli v obrázku připnutí nebo na okraji kolem něj. Velikost okraje je minimální šířka a výška kolíku.
style	query		MapImageStyle	Styl mapy, který se má vrátit. Možné hodnoty jsou hlavní a tmavé.
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 geopoliticky sporné oblasti. Různé země nebo oblasti mají různá zobrazení těchto oblastí a parametr Zobrazení umožňuje, aby vaše aplikace splňovala zobrazení vyžadované zemí nebo oblastí, které bude vaše aplikace obsluhovat. Ve výchozím nastavení je parametr View nastavený na "Unified" i v případě, že jste ho v požadavku nedefinovali. Je na vás, abyste určili umístění uživatelů a pak pro toto umístění správně nastavili parametr View. Alternativně můžete nastavit View=Auto, která vrátí mapová data na základě IP adresy požadavku. Parametr Zobrazení v Azure Maps musí být použit v souladu s platný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 prostřednictvím Azure Maps. Příklad: view=IN. Podrobnosti a dostupná zobrazení najdete v části Podporovaná zobrazení.
width	query		integer int32	Šířka výsledného obrázku v pixelech Rozsah je 1 až 8192. Výchozí hodnota je 512. Neměl by se používat s bboxem.
zoom	query		integer int32	Požadovaná úroveň přiblížení mapy. Hodnota přiblížení musí být v rozsahu 0–20 (včetně). Výchozí hodnota je 12. Podrobnosti najdete v tématu Úrovně přiblížení a Mřížka dlaždic .

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 obrázek se vrátí z úspěšného volání Získat mapový statický obrázek. 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 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í.

• Další informace o Microsoft identity platform najdete v přehledu 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ý 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.

Typ: apiKey
V: 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.

Typ: apiKey
V: header

Příklady

Successful Static Image Request

Ukázkový požadavek

HTTP

GET https://atlas.microsoft.com/map/static/png?api-version=1.0&layer=basic&style=main&zoom=2&bbox=1.355233,42.982261,24.980233,56.526017

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	Odpověď na chybu
LocalizedMapView	Parametr View (označovaný také jako parametr "oblast uživatele") umožňuje zobrazit správné mapy pro určitou zemi nebo oblast pro geopoliticky sporné oblasti. Různé země nebo oblasti mají různá zobrazení takových oblastí a parametr View umožňuje, aby aplikace splňovala zobrazení vyžadované zemí nebo oblastí, které bude vaše aplikace obsluhovat. Ve výchozím nastavení je parametr View nastavený na "Unified", i když jste ho v požadavku nedefinovali. Je vaší zodpovědností určit umístění uživatelů a pak pro toto umístění správně nastavit parametr View. Případně máte možnost nastavit View=Auto, která vrátí mapová data na základě IP adresy požadavku. Parametr View v Azure Maps musí být použit v souladu s platnými zákony, včetně těch, které se týkají 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 prostřednictvím Azure Maps jsou dostupné. Příklad: view=IN. Podrobnosti a dostupná zobrazení najdete v části Podporovaná zobrazení.
MapImageStyle	Styl mapy, který se má vrátit. Možné hodnoty jsou hlavní a tmavé.
RasterTileFormat	Požadovaný formát odpovědi. Možná hodnota: png.
StaticMapLayer	Požadována vrstva mapy. Pokud je vrstva nastavená na popisky nebo hybridní, měl by být formát png.

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.

LocalizedMapView

Parametr View (označovaný také jako parametr "oblast uživatele") umožňuje zobrazit správné mapy pro určitou zemi nebo oblast pro geopoliticky sporné oblasti. Různé země nebo oblasti mají různá zobrazení takových oblastí a parametr View umožňuje, aby aplikace splňovala zobrazení vyžadované zemí nebo oblastí, které bude vaše aplikace obsluhovat. Ve výchozím nastavení je parametr View nastavený na "Unified", i když jste ho v požadavku nedefinovali. Je vaší zodpovědností určit umístění uživatelů a pak pro toto umístění správně nastavit parametr View. Případně máte možnost nastavit View=Auto, která vrátí mapová data na základě IP adresy požadavku. Parametr View v Azure Maps musí být použit v souladu s platnými zákony, včetně těch, které se týkají 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 prostřednictvím Azure Maps jsou dostupné. Příklad: view=IN.

Podrobnosti a dostupná zobrazení najdete v části Podporovaná zobrazení.

Name	Typ	Description
AE	string	Spojené arabské emiráty (zobrazení v arabštině)
AR	string	Argentina (argentinské zobrazení)
Auto	string	Vrátí mapová data na základě IP adresy požadavku.
BH	string	Bahrajn (zobrazení v arabštině)
IN	string	Indie (indické zobrazení)
IQ	string	Irák (zobrazení v arabštině)
JO	string	Jordánsko (arabské zobrazení)
KW	string	Kuvajt (zobrazení v arabštině)
LB	string	Libanon (zobrazení arabštiny)
MA	string	Maroko (marocké zobrazení)
OM	string	Omán (zobrazení arabštiny)
PK	string	Pákistán (pákistánské zobrazení)
PS	string	Palestinská samospráva (zobrazení v arabštině)
QA	string	Katar (zobrazení v arabštině)
SA	string	Saúdská Arábie (arabské zobrazení)
SY	string	Sýrie (zobrazení arabštiny)
Unified	string	Sjednocené zobrazení (ostatní)
YE	string	Jemen (arabské zobrazení)

MapImageStyle

Styl mapy, který se má vrátit. Možné hodnoty jsou hlavní a tmavé.

Name	Typ	Description
dark	string	Tmavě šedá verze hlavního stylu Azure Maps
main	string	Azure Maps hlavní styl

RasterTileFormat

Požadovaný formát odpovědi. Možná hodnota: png.

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

StaticMapLayer

Požadována vrstva mapy. Pokud je vrstva nastavená na popisky nebo hybridní, měl by být formát png.

Name	Typ	Description
basic	string	Vrátí obrázek obsahující všechny prvky mapy, včetně mnohoúhelníku, ohraničení, cest a popisků.
hybrid	string	Vrátí obrázek obsahující ohraničení, cesty a popisky a může být překryt na jiných dlaždicích (například satelitních snímků), aby se vytvořily hybridní dlaždice.
labels	string	Vrátí obrázek pouze informací o popisku mapy.