Render - Get Map Tile

Szolgáltatás:

Maps

API-verzió:

2024-04-01

A használatával vektoros vagy raszter formátumú térképcsempéket kérhet le.

A Get Map Tiles HTTP GET-kérelem API-ja, amely lehetővé teszi, hogy a felhasználók vektoros vagy raszteres formátumban kérhessenek térképcsempéket, amelyek általában egy térképvezérlőbe vagy SDK-ba integrálhatók. Ilyenek például az Azure Maps közúti csempéi, a valós idejű Weather Radar-csempék vagy az Azure Maps Creator használatával létrehozott térképcsempék. Az Azure Maps alapértelmezés szerint vektorcsempéket használ a webtérkép-vezérléshez (Web SDK) és az Android SDK-hoz.

GET https://atlas.microsoft.com/map/tile?api-version=2024-04-01&tilesetId={tilesetId}&zoom={zoom}&x={x}&y={y}

Opcionális paraméterekkel:

GET https://atlas.microsoft.com/map/tile?api-version=2024-04-01&tilesetId={tilesetId}&zoom={zoom}&x={x}&y={y}&timeStamp={timeStamp}&tileSize={tileSize}&language={language}&view={view}

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.
tilesetId	query	True	TilesetID	A csempék egy raszter- vagy vektoradatokból álló gyűjtemények, amelyek az előre beállított nagyítási szinteken lévő négyzet alakú csempék egységes rácsára oszlanak. Minden csempekészlet rendelkezik egy tilesetId azonosítóval , amelyet a kérések során használhat. Az Azure Maps Creator használatával létrehozott csempekészletek tilesetId azonosítóját a Tileset Create API hozza létre. Az Azure Maps által biztosított használatra kész csempék alább láthatók. Például: microsoft.base.
x	query	True	integer int32	A csempe X koordinátája a nagyítási rácson. Az értéknek a(z) [0, 2zoom -1] tartományban kell lennie. Részletekért lásd: Nagyítási szintek és csemperács .
y	query	True	integer int32	A csempe Y koordinátája a nagyítási rácson. Az értéknek a(z) [0, 2zoom -1] tartományban kell lennie. Részletekért lásd: Nagyítási szintek és csemperács .
zoom	query	True	integer int32	A kívánt csempe nagyítási szintje. Részletekért lásd: Nagyítási szintek és csemperács .
language	query		string	Nyelv, amelyben a keresési eredményeket vissza kell adni. Az egyik támogatott IETF-nyelvi címke, a kis- és nagybetűk nem érzéketlenek. Ha a megadott nyelven megadott adatok nem érhetők el egy adott mezőhöz, a rendszer az alapértelmezett nyelvet használja. A részletekért tekintse meg a Támogatott nyelvek című témakört .
tileSize	query		MapTileSize	A visszaadott térképcsempék mérete képpontban.
timeStamp	query		string date-time	A kért csempe kívánt dátuma és időpontja. Ezt a paramétert az ISO 8601 által meghatározott szabványos dátum-idő formátumban kell megadni (pl. 2019-11-14T16:03:00-08:00). Ez a paraméter csak akkor támogatott, ha a tilesetId paraméter az alábbi értékek egyikére van állítva. microsoft.weather.infra.main: A múltban akár 3 óra csempéket is biztosítunk. A csempék 10 perces időközönként érhetők el. A timeStamp értéket a legközelebbi 10 perces időkeretre kerekítjük. microsoft.weather.radar.main: Az elmúlt 1,5 órában és a jövőben akár 2 órán át is biztosítunk csempéket. A csempék 5 perces időközönként érhetők el. A timeStamp értéket a legközelebbi 5 perces időkeretre kerekítjük.
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 eltérő nézetekkel rendelkeznek az ilyen régiókról, és a Nézet paraméter lehetővé teszi, hogy az alkalmazás megfeleljen annak az országnak/régiónak, amelyet az alkalmazás használni fog. Alapértelmezés szerint a Nézet paraméter "Egyesített" értékre van állítva, még akkor is, ha még nem definiálta a kérésben. Az Ön felelőssége meghatározni a felhasználók helyét, majd helyesen beállítani a View paramétert az adott helyhez. Másik lehetőségként beállíthatja a "View=Auto" beállítást, amely a kérelem 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 térképekkel kapcsolatos jogszabályokat annak az országnak/régiónak, 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ó tartalom elérhetővé válik. 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.

Kérelem fejléce

Name	Kötelező	Típus	Description
x-ms-client-id		string	Meghatározza, hogy melyik fiók legyen használatban a Microsoft Entra ID biztonsági modellel együtt. Az Azure Maps-fiók egyedi azonosítóját jelöli, és lekérhető az Azure Maps felügyeleti síkjának Fiók API-jából. A Microsoft Entra ID-biztonság Azure Mapsben való használatához tekintse meg az alábbi cikkeket .

Válaszok

Name	Típus	Description
200 OK	object	A csempe egy sikeres API-hívásból tért vissza. Media Types: "application/json", "image/jpeg", "image/png", "image/pbf", "application/vnd.mapbox-vector-tile" Fejlécek Content-Type: string
Other Status Codes	ErrorResponse	Váratlan hiba történt. Media Types: "application/json", "image/jpeg", "image/png", "image/pbf", "application/vnd.mapbox-vector-tile"

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ői egy vagy több Azure Maps-erőforrásfiókhoz vagy alerőforrásokhoz való hozzáférés kijelölésére szolgálnak. 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ások modellezésére olyan objektumokon keresztül, amelyek hozzáférés-vezérlésre képesek adott API-kon és hatókörökön.

Jegyzetek

• Ez a biztonsági definíció megköveteli a fejléc használatát x-ms-client-id annak jelzéséhez, hogy az alkalmazás melyik Azure Maps-erőforráshoz kér hozzáférést. Ez a Térképek felügyeleti API-ból szerezhető be.

Ez Authorization URL az Azure nyilvános felhőpéldányára jellemző. A szuverén felhők egyedi engedélyezési URL-címekkel és Microsoft Entra ID-konfigurációkkal rendelkeznek. * Az Azure 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 a 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.

• A Microsoft identitásplatformról további információt a Microsoft identitásplatform áttekintése című témakörben talál.

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 van kiépítve, amikor 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 a 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 javasoljuk, hogy az Azure Maps REST API-k kiszolgálóról kiszolgálóra történő hozzáfé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ási 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 a 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 jogkivonat lejáratához, sebességéhez és régiójához. Más szóval az SAS-jogkivonattal az alkalmazások biztonságosabb módon szabályozhatják a hozzáférést, mint a megosztott kulcs.

Nyilvánosan közzétett alkalmazások esetében azt javasoljuk, hogy konfigurálja az engedélyezett források adott listáját a Térképfiók erőforráson a megjelenítési visszaélések korlátozása és az SAS-jogkivonat rendszeres megújítása érdekében.

Típus: apiKey
In: header

Példák

Successful Tile Request

Sample request

HTTP

GET https://atlas.microsoft.com/map/tile?api-version=2024-04-01&tilesetId=microsoft.base&zoom=6&x=10&y=22

Sample response

Status code:

200

Content-Type: application/vnd.mapbox-vector-tile

"binary image string"

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.
MapTileSize	A visszaadott térképcsempék mérete képpontban.
TilesetID	A csempekészletek raszter- vagy vektoradatok gyűjteményei, amelyek az előre beállított nagyítási szinteken lévő négyzetes csempék egységes rácsára oszlanak. Minden csempekészlet rendelkezik egy tilesetId azonosítóval , amelyet a kérések során használhat. Az Azure Maps Creator használatával létrehozott csempekészletek tilesetId azonosítója a Tileset Create API-val jön létre. Az Azure Maps által biztosított használatra kész csempék alább láthatók. Például: microsoft.base.

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 információtí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)

MapTileSize

A visszaadott térképcsempék mérete képpontban.

Name	Típus	Description
256	string	Egy 256 és 256 képpontos csempe visszaadása.
512	string	Egy 512 és 512 képpont méretű csempe visszaadása.

TilesetID

A csempekészletek raszter- vagy vektoradatok gyűjteményei, amelyek az előre beállított nagyítási szinteken lévő négyzetes csempék egységes rácsára oszlanak. Minden csempekészlet rendelkezik egy tilesetId azonosítóval , amelyet a kérések során használhat. Az Azure Maps Creator használatával létrehozott csempekészletek tilesetId azonosítója a Tileset Create API-val jön létre. Az Azure Maps által biztosított használatra kész csempék alább láthatók. Például: microsoft.base.

Name	Típus	Description
microsoft.base	string	Az alaptérkép egy szabványos térkép, amely utakat, természetes és mesterséges jellemzőket jelenít meg, valamint a vektorcsempe ezen jellemzőinek címkéivel együtt. Támogatja a 0 és 22 közötti nagyítási szinteket. Formátum: vektor (pbf).
microsoft.base.darkgrey	string	Minden réteg sötétszürke stílussal. Támogatja a 0 és 22 közötti nagyítási szinteket. Formátum: raszter (png).
microsoft.base.hybrid	string	Egy vektorcsempe út-, határ- és címkeadatait jeleníti meg. Támogatja a 0 és 22 közötti nagyítási szinteket. Formátum: vektor (pbf).
microsoft.base.hybrid.darkgrey	string	Út, határ és címkeadatok sötétszürke stílusban. Támogatja a 0 és 22 közötti nagyítási szinteket. Formátum: raszter (png).
microsoft.base.hybrid.road	string	Út, határ és címkeadatok a fő stílusban. Támogatja a 0 és 22 közötti nagyítási szinteket. Formátum: raszter (png).
microsoft.base.labels	string	Utak címkéinek megjelenítése a vektorcsempe természetes és mesterséges jellemzőivel. Támogatja a 0 és 22 közötti nagyítási szinteket. Formátum: vektor (pbf).
microsoft.base.labels.darkgrey	string	Adatok címkézése sötétszürke stílusban. Támogatja a 0 és 22 közötti nagyítási szinteket. Formátum: raszter (png).
microsoft.base.labels.road	string	Az adatok címkézése a fő stílusban. Támogatja a 0 és 22 közötti nagyítási szinteket. Formátum: raszter (png).
microsoft.base.road	string	Minden réteg a fő stílusunkkal. Támogatja a 0 és 22 közötti nagyítási szinteket. Formátum: raszter (png).
microsoft.imagery	string	Műholdas és légi felvételek kombinációja. Csak az S1 díjszabási termékváltozatban érhető el. Támogatja az 1–19. nagyítási szinteket. Formátum: raszter (jpeg).
microsoft.terra.main	string	Árnyékolt domborzat és terra rétegek. Támogatja a 0–6. nagyítási szinteket. Formátum: raszter (png).
microsoft.traffic.absolute	string	abszolút forgalmi csempék vektorban
microsoft.traffic.absolute.main	string	abszolút forgalmi csempék raszterben a fő stílusban.
microsoft.traffic.delay	string	forgalomcsempék vektorban
microsoft.traffic.delay.main	string	traffic tiles in raster in our main style
microsoft.traffic.incident	string	incidenscsempék vektorban
microsoft.traffic.reduced.main	string	csökkentett forgalmi csempék raszterben a fő stílusban
microsoft.traffic.relative	string	relatív forgalmi csempék vektorban
microsoft.traffic.relative.dark	string	relatív forgalmi csempék raszterben sötét stílusban.
microsoft.traffic.relative.main	string	relatív forgalmi csempék raszterben a fő stílusban.
microsoft.weather.infrared.main	string	Időjárási infravörös csempék. A legújabb infravörös műholdképek a hőmérsékletük alapján jelenítik meg a felhőket. További információ: Az Azure Maps időjárási szolgáltatásainak lefedettsége. A visszaadott műholdas adatokról további információt az Időjárás-szolgáltatások az Azure Mapsben című témakörben talál. Támogatja a 0 és 15 közötti nagyítási szinteket. Formátum: raszter (png).
microsoft.weather.radar.main	string	Időjárási radarcsempék. Legfrissebb időjárási radarképek, beleértve az eső, hó, jég és vegyes körülményeket. Az Azure Maps Weather szolgáltatás lefedettségével kapcsolatos további információkért lásd: Az Azure Maps időjárási szolgáltatásainak lefedettsége. A Radaradatokkal kapcsolatos további információkért lásd: Időjárás-szolgáltatások az Azure Mapsben. Támogatja a 0 és 15 közötti nagyítási szinteket. Formátum: raszter (png).