Render - Get Map Tile
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}
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. |
tileset
|
query | True |
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, 2 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, 2 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 . |
|
tile
|
query |
A visszaadott térképcsempék mérete képpontban. |
||
time
|
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.
|
|
view
|
query |
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 |
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
Folyamat:
implicit
Engedélyezési URL:
https://login.microsoftonline.com/common/oauth2/authorize
Hatókörök
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
Mintakérelem
GET https://atlas.microsoft.com/map/tile?api-version=2024-04-01&tilesetId=microsoft.base&zoom=6&x=10&y=22
Mintaválasz
Content-Type: application/vnd.mapbox-vector-tile
"binary image string"
Definíciók
Name | Description |
---|---|
Error |
Az erőforrás-kezelési hiba további információi. |
Error |
A hiba részletei. |
Error |
Hibaválasz |
Localized |
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. |
Map |
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 |
A hiba további információi. |
|
code |
string |
A hibakód. |
details |
A hiba részletei. |
|
message |
string |
A hibaüzenet. |
target |
string |
A hiba célja. |
ErrorResponse
Hibaválasz
Name | Típus | Description |
---|---|---|
error |
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). |