Render - Get Map Static Image

Szolgáltatás:

Maps

API-verzió:

2024-04-01

Ez a renderelési API statikus, raszterizált térképnézeteket hoz létre egy felhasználó által definiált területről. Alkalmas egyszerűsített webalkalmazásokhoz, ha a kívánt felhasználói élményhez nincs szükség interaktív térképvezérlőkre, vagy ha a sávszélesség korlátozott. Ez az API a térképek böngészőn kívüli alkalmazásokba, háttérszolgáltatásokba, jelentésgenerálásba vagy asztali alkalmazásokba való beágyazásához is hasznos.

Ez az API az alapszintű adatvizualizáció paramétereit tartalmazza:

• Több stílusban címkézett nyomófürtök.
• Kör-, elérésiút- és sokszöggeometriai típusok renderelése.

További információkért és részletes példákért lásd: Egyéni adatok renderelése raszteres térképen.

A bbox paraméter méretei a nagyítási szinttől függően korlátozottak. Ez biztosítja, hogy az eredményként kapott kép megfelelő részletességgel rendelkezik.

Nagyítási szint	Minimális Lon-tartomány	Maximális Lon-tartomány	Minimális lattartomány	Maximális lattartomány
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

Megjegyzés : A center vagy a bbox paramétert meg kell adni az API-nak.

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

Opcionális paraméterekkel:

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}

URI-paraméterek

Name	In	Kötelező	Típus	Description
api-version	query	True	string	Az Azure Maps API verziószáma. A jelenlegi verzió: 2024-04-01.
bbox	query		number[]	A határolókeretet két szélességi szélesség és két hosszúság határozza meg, amelyek a Föld négyszögletes területének négy oldalát jelölik. Formátum: 'minLon, minLat, maxLon, maxLat' (dupla). Megjegyzés: A bbox vagy a center paraméter megadása kötelező. Kölcsönösen kizárják egymást. A bbox nem használható magassággal vagy szélességgel. A Lat és a Lon maximális és minimális megengedett tartományai az oldal tetején található táblázat minden nagyítási szintjéhez meg vannak határozva.
center	query		number[]	A középpont koordinátái dupla értékben. Formátum: 'lon,lat'. Hosszúsági tartomány: -180 és 180 között. Szélességi tartomány: -90 és 90 között. Megjegyzés: A középre vagy a bboxra kötelező paramétereket megadni. Kölcsönösen kizárják egymást.
height	query		integer int32	Az eredményként kapott kép magassága képpontban. Tartomány: 80 és 1500 között. Az alapértelmezett érték 512. A bbox nem használható.
language	query		string	Az a nyelv, amelyben a keresési eredményeket vissza kell adni. A támogatott IETF nyelvcímkék egyikének kell lennie, a kis- és nagybetűk nem különböztethetők meg. Ha a megadott nyelvű adatok nem érhetők el egy adott mezőhöz, a rendszer az alapértelmezett nyelvet használja. Részletekért tekintse meg a támogatott nyelveket ismertető cikket.
path	query		string[]	Elérési út stílusa és helye (dupla). Ezzel a paraméterrel adhat hozzá vonalakat, sokszögeket vagy köröket a képhez. Az elérési út stílusa a vonal és a kitöltés megjelenését írja le. (Ügyeljen arra, hogy a paraméter URL-kódolási értékei megfelelően legyenek kódolva, mivel fenntartott karaktereket, például csöveket és írásjeleket fog tartalmazni.) Az elérésiút-paraméter az S1-től kezdődően támogatott az Azure Maps-fiók termékváltozatában. Az elérésiút-paraméter több példánya lehetővé teszi több geometria megadását a stílusukkal. A kérésenkénti paraméterek száma 10-re van korlátozva, a helyek száma pedig útvonalonként 100-ra van korlátozva. Ha egy 100 méter sugarú kört szeretne megjeleníteni a 45°N szélességi és 122°W hosszúsági fokon az alapértelmezett stílussal, adja hozzá a querystring paramétert path=ra100||-122 45 Vegye figyelembe, hogy a hosszúság a szélesség előtt van. Az URL-kódolás után ez a következőképpen fog kinézni: path=ra100%7C%7C-122+45 Az itt szereplő példák mindegyike URL-kódolás nélküli elérésiút-paramétert mutat be az egyértelműség érdekében. Egy vonal megjelenítéséhez különítse el az egyes helyeket egy csőkarakorral. Használja például a path=||-122 45|-119.5 43.2|-121.67 47.12 A sokszög zárt elérési úttal van megadva, ahol az első és az utolsó pont egyenlő. Használja például a path=||-122 45|-119.5 43.2|-121.67 47.12|-122 45 A vonalak és sokszögek helyének hosszúsági értéke -360 és 360 között lehet, hogy lehetővé tegye az anti-meridiánon áthaladó geometriák renderelését. Stílusmódosítók Az elérési út megjelenését stílusmódosítók hozzáadásával módosíthatja. Ezek a helyek előtt lesznek hozzáadva. A stílusmódosítók mindegyike kétbetűs névvel rendelkezik. Ezek a rövidített nevek segítenek csökkenteni az URL-cím hosszát. A körvonal színének módosításához használja az "lc" stílusmódosítót, és adja meg a színt a HTML/CSS RGB színformátummal, amely egy hatjegyű hexadecimális szám (a háromjegyű formátum nem támogatott). Ha például egy mély rózsaszín színt szeretne megadni a CSS-ben #FF1493, használja a path=lcFF1493||-122 45|-119.5 43.2 Összetettebb vizuális stílus létrehozásához több stílusmódosító is kombinálható. 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 Stílusmódosító összegzése Módosító Leírás Típus Tartomány Lc Sor színe sztring 000000–FFFFFFFF Fc Kitöltési szín sztring 000000–FFFFFFFF lá Alfa vonal (átlátszatlanság) float 0–1 fá Alfa kitöltése (átlátszatlanság) float 0–1 Lw Vonalszélesség int32 (0, 50] ra Kör sugara (méter) float 0-nál nagyobb
pins	query		string[]	Leküldéses stílus és példányok. Ezt a paramétert használhatja leküldéses rajzszögek képhez való hozzáadásához. A leküldéses stílus a leküldéses tűk megjelenését írja le, a példányok pedig az egyes tűk koordinátáit (dupla) és opcionális címkéket adják meg. (Ügyeljen arra, hogy a paraméter URL-kódolási értékei megfelelően legyenek kódolva, mivel fenntartott karaktereket, például csöveket és írásjeleket fog tartalmazni.) Az Azure Maps-fiók S0 termékváltozata csak a PIN-kód paraméter egyetlen példányát támogatja. Más termékváltozatok lehetővé teszik, hogy a pins paraméter több példánya több pin-stílust adjon meg. Ha az alapértelmezett beépített leküldési stílussal szeretné megjeleníteni a leküldéses vesszőt az N szélesség 45°N és a hosszúság 122°W között, adja hozzá a querystring paramétert pins=default||-122 45 Vegye figyelembe, hogy a hosszúság a szélesség előtt van. Az URL-kódolás után ez a következőképpen fog kinézni: pins=default%7C%7C-122+45 Az itt látható példák mindegyike URL-kódolás nélküli PIN-kódoló paramétert mutat be az egyértelműség érdekében. Ha egy tűt több helyen szeretne megjeleníteni, különítse el az egyes helyeket egy csőkarakorral. Használja például a pins=default||-122 45|-119.5 43.2|-121.67 47.12 Az S0 Azure Maps-fiók termékváltozata csak öt pushpint engedélyez. Más fiók-termékváltozatok nem rendelkeznek ezzel a korlátozásokkal. Stílusmódosítók A gombostűk megjelenését stílusmódosítók hozzáadásával módosíthatja. Ezek a stílus után, de a helyek és címkék előtt jelennek meg. A stílusmódosítók mindegyike kétbetűs névvel rendelkezik. Ezek a rövidített nevek segítenek csökkenteni az URL-cím hosszát. A pushpin színének módosításához használja a "co" stílusmódosítót, és adja meg a színt a HTML/CSS RGB színformátummal, amely egy hatjegyű hexadecimális szám (a háromjegyű formátum nem támogatott). Ha például egy mély rózsaszín színt szeretne megadni a CSS-ben #FF1493, használja a pins=default|coFF1493||-122 45 Leküldéses címkék Ha címkét szeretne hozzáadni a tűkhöz, helyezze a címkét szimpla idézőjelekbe közvetlenül a koordináták elé. Kerülje az olyan speciális karakterek használatát, mint a | vagy || a címke. Ha például három tűt szeretne címkézni az "1", a "2" és a "3" értékekkel, használja a pins=default||'1'-122 45|'2'-119.5 43.2|'3'-121.67 47.12 Létezik egy "none" nevű beépített pushpin stílus, amely nem jelenít meg leküldéses képet. Ezt akkor használhatja, ha a címkéket pin-kép nélkül szeretné megjeleníteni. Példa: pins=none||'A'-122 45|'B'-119.5 43.2 A leküldéses címkék színének módosításához használja az "lc" címke színstílus-módosítót. Ha például rózsaszín nyomófürtöket szeretne használni fekete címkékkel, használja a pins=default|coFF1493|lc000000||-122 45 A címkék méretének módosításához használja az "ls" címkeméret-módosítót. A címke mérete a címkeszöveg képpontban kifejezett hozzávetőleges magasságát jelöli. Ha például a címke méretét 12-re szeretné növelni, használja a pins=default|ls12||'A'-122 45|'B'-119 43 A címkék a "címkehorgony" nyomócsúcson vannak középre igazítva. A horgony helye előre definiálva van a beépített leküldéses pontokhoz, és az egyéni leküldéses pontok felső közepén található (lásd alább). A címkehorgony felülbírálásához használja az "la" stílusmódosítót, és adja meg a horgony X és Y képpont koordinátáit. Ezek a koordináták a leküldéses kép bal felső sarkához viszonyítva találhatók. A pozitív X értékek jobbra mozgatják a horgonyt, a pozitív Y értékek pedig lefelé mozgatják a horgonyt. Ha például a címkehorgonyt 10 képponttal jobbra és 4 képponttal a leküldéses kép bal felső sarka fölé szeretné helyezni, használja a pins=default|la10 -4||'A'-122 45|'B'-119 43 Egyéni leküldéses rajzszögek Egyéni leküldéses kép használatához használja az "egyéni" szót a rögzítési stílus neveként, majd adjon meg egy URL-címet a hely és a címke adatai után. A testre szabott címkeképek maximális mérete 65 536 képpont. Két csőkarakterek jelzik, hogy befejezte a helyek megadását, és elindítja az URL-címet. Példa: pins=custom||-122 45||http://contoso.com/pushpins/red.png Az URL-kódolás után ez a következőképpen nézne ki: pins=custom%7C%7C-122+45%7C%7Chttp%3A%2F%2Fcontoso.com%2Fpushpins%2Fred.png Alapértelmezés szerint az egyéni leküldéses képek középre vannak húzva a pin-kód koordinátáinál. Ez általában nem ideális, mivel elhomályosítja a kiemelni kívánt helyet. A rögzítési kép horgonyhelyének felülbírálásához használja az "an" stílusmódosítót. Ez ugyanazt a formátumot használja, mint az "la" címkehorgonystílus-módosító. Ha például az egyéni tűképen a gombostű csúcsa látható a kép bal felső sarkában, a horgonyt erre a pontra állíthatja a pins=custom|an0 0||-122 45||http://contoso.com/pushpins/red.png Megjegyzés: Ha a "co" színmódosítót egyéni leküldéses képpel használja, a megadott szín lecseréli a kép képpontjainak RGB-csatornáit, de változatlanul hagyja az alfa (átlátszatlanság) csatornát. Ez általában csak egyszínű egyéni képpel végezhető el. Skálázás, forgatás és átlátszatlanság Az "sc" skálázási stílusmódosítóval nagyíthatja vagy csökkentheti a nyomócsúcsokat és a címkéket. Ez egy nullánál nagyobb érték. Az 1 érték a standard skálázás. Az 1-nél nagyobb értékek nagyobbak lesznek, az 1-nél kisebb értékek pedig kisebbek lesznek. Ha például a normálnál 50%-kal nagyobb nyomófürtöket szeretne rajzolni, használja a pins=default|sc1.5||-122 45 A nyomófürtöket és címkéiket a "ro" forgatóstílus-módosítóval lehet elforgatni. Ez az óramutató járásával megegyező irányban történő elforgatás több foka. Negatív szám használata az óramutató járásával ellentétes irányban történő elforgatásához. Ha például az óramutató járásával megegyező irányban 90 fokkal szeretné elforgatni a nyomófürtöket, és meg szeretné duplázni a méretüket, használja a pins=default|ro90|sc2||-122 45 Az "al" alfa stílusú módosító megadásával részlegesen áttetszővé teheti a pushpineket és címkéiket. Ez egy 0 és 1 közötti szám, amely a nyomófürtök átlátszatlanságát jelzi. A nulla teljesen átlátszóvá (és nem láthatóvá) teszi őket, az 1 pedig teljesen átlátszatlanná teszi őket (ez az alapértelmezett). Ha például a nyomófürtöket és címkéiket csak 67%-ban szeretné átlátszatlansá tenni, használja a pins=default|al.67||-122 45 Stílusmódosító összegzése Módosító Leírás Típus Tartomány al Alfa (átlátszatlanság) float 0–1 an Horgony rögzítése <int32, int32> * co Szín rögzítése sztring 000000–FFFFFFFF lá Címkehorgony <int32, int32> * Lc Címke színe sztring 000000–FFFFFFFF ls Címke mérete float 0-nál nagyobb Ro Változtatás float -360–360 Sc Méretezés float 0-nál nagyobb Az X és Y koordináták bárhol lehetnek a rögzítési képen vagy a körülöttük lévő margón belül. A margó mérete a tű szélességének és magasságának minimuma.
tilesetId	query		TilesetId	A visszaadandó leképezési stílus. Lehetséges értékek: microsoft.base.road, microsoft.base.darkgrey és microsoft.imagery. Az alapértelmezett érték a microsoft.base.road. További információ: Mozaikkészlet-azonosító megjelenítése.
trafficLayer	query		TrafficTilesetId	Nem kötelező érték, amely azt jelzi, hogy a rendszerkép eredményén nincs túlterjedő forgalom. Lehetséges értékek: microsoft.traffic.relative.main és none. Az alapértelmezett érték nincs, ami azt jelzi, hogy nincs visszaadott forgalom. Ha a forgalommal kapcsolatos tilesetId meg van adva, a rendszer a megfelelő forgalmi réteggel rendelkező térképképet adja vissza. További információ: Mozaikkészlet-azonosító megjelenítése.
view	query		LocalizedMapView	A View paraméter (más néven "felhasználói régió" paraméter) lehetővé teszi egy adott ország/régió megfelelő térképeinek megjelenítését a geopolitikailag vitatott régiókhoz. A különböző országok/régiók különböző nézetekkel rendelkeznek az ilyen régiókról, és a Nézet paraméter lehetővé teszi, hogy az alkalmazás megfeleljen az alkalmazás által kiszolgálni kívánt ország/régió által megkövetelt nézetnek. Alapértelmezés szerint a View paraméter "Egyesített" értékre van állítva, még akkor is, ha még nem definiálta a kérelemben. Az Ön felelőssége, hogy meghatározza a felhasználók helyét, majd helyesen állítsa be a View paramétert az adott helyhez. Másik lehetőségként beállíthatja a "View=Auto" beállítást is, amely a kérés IP-címe alapján adja vissza a térképadatokat. Az Azure Maps View paraméterét a vonatkozó jogszabályoknak megfelelően kell használni, beleértve a leképezésre vonatkozó jogszabályokat is, azon ország/régió tekintetében, ahol a térképek, képek és egyéb adatok, valamint az Azure Mapsen keresztüli hozzáférésre jogosult harmadik féltől származó tartalmak elérhetővé válnak. Példa: view=IN. A részletekért tekintse meg a Támogatott nézetek című témakört , és tekintse meg az elérhető nézeteket.
width	query		integer int32	Az eredményként kapott kép szélessége képpontban. 80 és 2000 közötti tartomány. Az alapértelmezett érték 512. A bbox nem használható.
zoom	query		integer int32	A térkép kívánt nagyítási szintje. A 0 és 20 közötti nagyítási értéktartomány támogatása (a csempék azonosítóját is beleértve) a microsoft.base.road vagy a microsoft.base.darkgrey. A 0 és 19 közötti nagyítási értéktartomány támogatása (a 0 és 19 közötti értékeket is beleértve) a microsoft.imagery tilesetId értékhez. Az alapértelmezett érték 12. További információ: Nagyítási szintek és csemperács.

Kérelem fejléce

Name	Kötelező	Típus	Description
x-ms-client-id		string	Meghatározza, hogy melyik fiók legyen a Microsoft Entra ID biztonsági modellel együtt használva. Ez az Azure Maps-fiók egyedi azonosítóját jelöli, amely az Azure Maps felügyeleti sík fiók API-jából kérhető le. A Microsoft Entra ID security Azure Mapsben való használatához az alábbi cikkek nyújtanak útmutatást.
Accept		MediaType	Az Elfogadás fejlécmezővel megadhatja a válasz médiatípusokkal kapcsolatos beállításokat. Az engedélyezett médiatípusok közé tartozik a kép/jpeg és az image/png. Kép/png visszaadása, ha nincs megadva az Elfogadás fejléc.

Válaszok

Name	Típus	Description
200 OK	object	Ezt a képet egy sikeres Statikus kép lekérése hívás adja vissza. Media Types: "image/jpeg", "image/png" Fejlécek Content-Type: string
Other Status Codes	ErrorResponse	Váratlan hiba történt. Media Types: "image/jpeg", "image/png"

Biztonság

AADToken

Ezek a Microsoft Entra OAuth 2.0-folyamatok . Az Azure-beli szerepköralapú hozzáférés-vezérléssel párosítva szabályozható az Azure Maps REST API-khoz való hozzáférés. Az Azure szerepköralapú hozzáférés-vezérlése egy vagy több Azure Maps-erőforrásfiókhoz vagy alerőforráshoz való hozzáférés kijelölésére szolgál. Bármely felhasználó, csoport vagy szolgáltatásnév hozzáférést kaphat egy beépített szerepkörrel vagy egy vagy több Azure Maps REST API-ra vonatkozó engedélyből álló egyéni szerepkörrel.

A forgatókönyvek implementálásához javasoljuk, hogy tekintse meg a hitelesítési fogalmakat. Összefoglalva, ez a biztonsági definíció megoldást nyújt az alkalmazás(ok) adott API-k és hatókörök hozzáférés-vezérlésére képes objektumokon keresztüli modellezésére.

Jegyzetek

• Ehhez a biztonsági definícióhoz a x-ms-client-id fejléc használatával kell jelezni, hogy az alkalmazás melyik Azure Maps-erőforráshoz kér hozzáférést. Ez a Maps management API-ból szerezhető be.

A Authorization URL az Azure nyilvános felhőpéldányára vonatkozik. A szuverén felhők egyedi engedélyezési URL-címekkel és Microsoft Entra ID-konfigurációkkal rendelkeznek. * Az Azure-beli szerepköralapú hozzáférés-vezérlés az Azure felügyeleti síkjáról van konfigurálva az Azure Portalon, a PowerShellen, a parancssori felületen, az Azure SDK-kon vagy REST API-kon keresztül. * Az Azure Maps Web SDK használata lehetővé teszi egy alkalmazás konfigurációalapú beállítását több használati esetben.

• További információ a Microsoft identitásplatformról: A Microsoft identitásplatformjának áttekintése.

Típus: 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

Ez egy megosztott kulcs, amely akkor lesz kiépítve, ha Azure Maps-erőforrást hoz létre az Azure felügyeleti síkon keresztül az Azure Portalon, a PowerShellen, a parancssori felületen, az Azure SDK-kon vagy REST API-kon keresztül.

Ezzel a kulccsal bármely alkalmazás hozzáférhet az összes REST API-hoz. Más szóval ezek jelenleg főkulcsként kezelhetők ahhoz a fiókhoz, amelyhez ki vannak adva.

Nyilvánosan közzétett alkalmazások esetében azt javasoljuk, hogy az Azure Maps REST API-k kiszolgálóról kiszolgálóra történő elérését használja, ahol ez a kulcs biztonságosan tárolható.

Típus: apiKey
In: header

SAS Token

Ez egy közös hozzáférésű jogosultságkód-jogkivonat az Azure Maps-erőforrás Sas listázása műveletéből jön létre az Azure felügyeleti síkon keresztül az Azure Portalon, a PowerShellen, a parancssori felületen, az Azure SDK-kon vagy REST API-kon keresztül.

Ezzel a jogkivonattal minden alkalmazás jogosult hozzáférni az Azure szerepköralapú hozzáférés-vezérlőihez, valamint az adott jogkivonathoz használt lejárati időhöz, sebességhez és régióhoz. Más szóval az SAS-jogkivonattal az alkalmazások a megosztott kulcsnál biztonságosabb módon szabályozhatják a hozzáférést.

Nyilvánosan közzétett alkalmazások esetében javasoljuk, hogy konfiguráljon egy adott listát az engedélyezett forrásokról a térképfiók-erőforráson a leképezési visszaélések korlátozásához és az SAS-jogkivonat rendszeres megújításához.

Típus: apiKey
In: header

Példák

Successful Static Image Request

Sample request

HTTP

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

Sample response

Status code:

200

Content-Type: image/png

"{file}"

Definíciók

Name	Description
ErrorAdditionalInfo	Az erőforrás-kezelési hiba további információi.
ErrorDetail	A hiba részletei.
ErrorResponse	Hibaválasz
LocalizedMapView	A View paraméter (más néven "felhasználói régió" paraméter) lehetővé teszi egy adott ország/régió megfelelő térképeinek megjelenítését a geopolitikailag vitatott régiókhoz. A különböző országok/régiók különböző nézetekkel rendelkeznek az ilyen régiókról, és a Nézet paraméter lehetővé teszi, hogy az alkalmazás megfeleljen az alkalmazás által kiszolgálni kívánt ország/régió által megkövetelt nézetnek. Alapértelmezés szerint a View paraméter "Egyesített" értékre van állítva, még akkor is, ha még nem definiálta a kérelemben. Az Ön felelőssége, hogy meghatározza a felhasználók helyét, majd helyesen állítsa be a View paramétert az adott helyhez. Másik lehetőségként beállíthatja a "View=Auto" beállítást is, amely a kérés IP-címe alapján adja vissza a térképadatokat. Az Azure Maps View paraméterét a vonatkozó jogszabályoknak megfelelően kell használni, beleértve a leképezésre vonatkozó jogszabályokat is, azon ország/régió tekintetében, ahol a térképek, képek és egyéb adatok, valamint az Azure Mapsen keresztüli hozzáférésre jogosult harmadik féltől származó tartalmak elérhetővé válnak. Példa: view=IN. A részletekért tekintse meg a Támogatott nézetek című témakört , és tekintse meg az elérhető nézeteket.
MediaType	Az Elfogadás fejlécmezővel megadhatja a válasz médiatípusokkal kapcsolatos beállításokat. Az engedélyezett médiatípusok közé tartozik a kép/jpeg és az image/png. Kép/png visszaadása, ha nincs megadva az Elfogadás fejléc.
TilesetId	A visszaadandó leképezési stílus. Lehetséges értékek: microsoft.base.road, microsoft.base.darkgrey és microsoft.imagery. Az alapértelmezett érték a microsoft.base.road. További információ: Mozaikkészlet-azonosító megjelenítése.
TrafficTilesetId	Nem kötelező érték, amely azt jelzi, hogy a rendszerkép eredményén nincs túlterjedő forgalom. Lehetséges értékek: microsoft.traffic.relative.main és none. Az alapértelmezett érték nincs, ami azt jelzi, hogy nincs visszaadott forgalom. Ha a forgalommal kapcsolatos tilesetId meg van adva, a rendszer a megfelelő forgalmi réteggel rendelkező térképképet adja vissza. További információ: Mozaikkészlet-azonosító megjelenítése.

ErrorAdditionalInfo

Az erőforrás-kezelési hiba további információi.

Name	Típus	Description
info	object	A további információk.
type	string	A további adattípus.

ErrorDetail

A hiba részletei.

Name	Típus	Description
additionalInfo	ErrorAdditionalInfo[]	A hiba további információi.
code	string	A hibakód.
details	ErrorDetail[]	A hiba részletei.
message	string	A hibaüzenet.
target	string	A hiba célja.

ErrorResponse

Hibaválasz

Name	Típus	Description
error	ErrorDetail	A hibaobjektum.

LocalizedMapView

A View paraméter (más néven "felhasználói régió" paraméter) lehetővé teszi egy adott ország/régió megfelelő térképeinek megjelenítését a geopolitikailag vitatott régiókhoz. A különböző országok/régiók különböző nézetekkel rendelkeznek az ilyen régiókról, és a Nézet paraméter lehetővé teszi, hogy az alkalmazás megfeleljen az alkalmazás által kiszolgálni kívánt ország/régió által megkövetelt nézetnek. Alapértelmezés szerint a View paraméter "Egyesített" értékre van állítva, még akkor is, ha még nem definiálta a kérelemben. Az Ön felelőssége, hogy meghatározza a felhasználók helyét, majd helyesen állítsa be a View paramétert az adott helyhez. Másik lehetőségként beállíthatja a "View=Auto" beállítást is, amely a kérés IP-címe alapján adja vissza a térképadatokat. Az Azure Maps View paraméterét a vonatkozó jogszabályoknak megfelelően kell használni, beleértve a leképezésre vonatkozó jogszabályokat is, azon ország/régió tekintetében, ahol a térképek, képek és egyéb adatok, valamint az Azure Mapsen keresztüli hozzáférésre jogosult harmadik féltől származó tartalmak elérhetővé válnak. Példa: view=IN.

A részletekért tekintse meg a Támogatott nézetek című témakört , és tekintse meg az elérhető nézeteket.

Name	Típus	Description
AE	string	Egyesült Arab Emírségek (arab nézet)
AR	string	Argentína (argentin nézet)
Auto	string	Adja vissza a leképezési adatokat a kérelem IP-címe alapján.
BH	string	Bahrein (arab nézet)
IN	string	India (indiai nézet)
IQ	string	Irak (arab nézet)
JO	string	Jordánia (arab nézet)
KW	string	Kuvait (arab nézet)
LB	string	Libanon (arab nézet)
MA	string	Marokkó (marokkói nézet)
OM	string	Omán (arab nézet)
PK	string	Pakisztán (pakisztáni nézet)
PS	string	Palesztin Hatóság (arab nézet)
QA	string	Katar (arab nézet)
SA	string	Szaúd-Arábia (arab nézet)
SY	string	Szíria (arab nézet)
Unified	string	Egyesített nézet (egyebek)
YE	string	Jemen (arab nézet)

MediaType

Az Elfogadás fejlécmezővel megadhatja a válasz médiatípusokkal kapcsolatos beállításokat. Az engedélyezett médiatípusok közé tartozik a kép/jpeg és az image/png. Kép/png visszaadása, ha nincs megadva az Elfogadás fejléc.

Name	Típus	Description
image/jpeg	string	Visszaadott kép jpeg formátumban.
image/png	string	Kép visszaadása png formátumban.

TilesetId

A visszaadandó leképezési stílus. Lehetséges értékek: microsoft.base.road, microsoft.base.darkgrey és microsoft.imagery. Az alapértelmezett érték a microsoft.base.road. További információ: Mozaikkészlet-azonosító megjelenítése.

Name	Típus	Description
microsoft.base.darkgrey	string	A TilesetId a sötétszürke stílussal rendelkező összes réteget tartalmazza.
microsoft.base.road	string	A TilesetId a renderelési fő stílussal rendelkező összes réteget tartalmazza.
microsoft.imagery	string	A TilesetId műholdas és légi felvételek kombinációját tartalmazza.

TrafficTilesetId

Nem kötelező érték, amely azt jelzi, hogy a rendszerkép eredményén nincs túlterjedő forgalom. Lehetséges értékek: microsoft.traffic.relative.main és none. Az alapértelmezett érték nincs, ami azt jelzi, hogy nincs visszaadott forgalom. Ha a forgalommal kapcsolatos tilesetId meg van adva, a rendszer a megfelelő forgalmi réteggel rendelkező térképképet adja vissza. További információ: Mozaikkészlet-azonosító megjelenítése.

Name	Típus	Description
microsoft.traffic.relative.main	string	Támogatott forgalommal kapcsolatos tilesetId.
none	string	Alapértelmezett érték, nincs átfedő forgalom.