Render - Get Map Tileset

Referencia

Szolgáltatás:: Maps

API-verzió:: 2024-04-01

A használatával lekérheti a csempék metaadatait.

A Térképcsempék lekérése API lehetővé teszi a felhasználók számára a csempék metaadatainak lekérését.

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

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.

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	MapTileset	OK
Other Status Codes	ErrorResponse	Váratlan hiba történt.

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 Tileset Request

Mintakérelem

HTTP

GET https://atlas.microsoft.com/map/tileset?api-version=2024-04-01&tilesetId=microsoft.base

Mintaválasz

Állapotkód:: 200

{
  "tilejson": "2.2.0",
  "version": "1.0.0",
  "attribution": "<a data-azure-maps-attribution-tileset=\"microsoft.base\">&copy;2022 TomTom</a>",
  "scheme": "xyz",
  "tiles": [
    "https://atlas.microsoft.com/map/tile?api-version=2024-04-01&tilesetId={tilesetId}&zoom={zoom}&x={x}&y={y}"
  ],
  "minzoom": 0,
  "maxzoom": 22,
  "bounds": [
    -180,
    -90,
    180,
    90
  ]
}

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
MapTileset	Csempekészlet metaadatai TileJSON formátumban.
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.

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 hibacél.

ErrorResponse

Hibaválasz

Name	Típus	Description
error	ErrorDetail	A hibaobjektum.

MapTileset

Csempekészlet metaadatai TileJSON formátumban.

Name	Típus	Description
attribution	string	A térképen megjelenítendő szerzői jogi forrás. Az implementációk dönthetnek úgy, hogy EZT HTML-ként vagy literális szövegként kezelik. Biztonsági okokból győződjön meg arról, hogy ez a mező nem használható az XSS vagy a jelzők nyomon követésének vektoraként.
bounds	number[]	A rendelkezésre álló térképcsempék maximális mértéke. A korlátoknak meg kell határozniuk az összes nagyítási szint által lefedett területet. A korlátok a WGS:84 szélességi és hosszúsági értékeiben jelennek meg, bal, alsó, jobb és felső sorrendben. Az értékek lehetnek egész számok vagy lebegőpontos számok.
center	number[]	A csempekészlet alapértelmezett helye a következő formában: [hosszúság, szélesség, nagyítás]. A nagyítási szintnek minzoom és maxzoom között kell lennie. Az implementációk ezt az értéket használhatják az alapértelmezett hely beállításához.
data	string[]	Adatfájlok tömbje GeoJSON formátumban.
description	string	A csempekészlet szöveges leírása. A leírás bármilyen jogi karaktert tartalmazhat. Az implementációk nem értelmezik a leírást HTML-ként.
grids	string[]	Interaktivitási végpontok tömbje.
legend	string	A térképen megjelenítendő jelmagyarázat. Az implementációk dönthetnek úgy, hogy EZT HTML-ként vagy literális szövegként kezelik. Biztonsági okokból győződjön meg arról, hogy ez a mező nem használható az XSS vagy a jelzők nyomon követésének vektoraként.
maxzoom	integer	A maximális nagyítási szint.
minzoom	integer	A minimális nagyítási szint.
name	string	A csempekészletet leíró név. A név bármilyen jogi karaktert tartalmazhat. Az implementációk nem értelmezik a nevet HTML-ként.
scheme	string	Alapértelmezett: "xyz". Vagy "xyz" vagy "tms". Befolyásolja a csempe koordinátáinak y irányát. A globális mercator (más néven spherical Mercator) profilt feltételezzük.
template	string	Egy bajuszsablon, amely a rácsokból származó adatok interakcióhoz való formázására szolgál.
tilejson	string	A CsempeJSON-specifikáció ezen JSON-objektum által implementált verzióját ismerteti.
tiles	string[]	Csempevégpontok tömbje. Ha több végpont van megadva, az ügyfelek a végpontok tetszőleges kombinációját használhatják. Minden végpontnak ugyanazt az URL-címet kell visszaadnia. A tömbNEK legalább egy végpontot tartalmaznia kell.
version	string	A csempekészletben található csempék semver.org stílusverziószáma. A csempék közötti módosítások bevezetésekor az alverziónak meg kell változnia.

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.

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, valamint a vektorcsempe ezen funkcióinak címkéivel együtt jeleníti meg. Támogatja a 0–22. 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–22. nagyítási szinteket. Formátum: raszter (png).
microsoft.base.hybrid	string	Út, határ és címkeadatokat jelenít meg egy vektorcsempében. Támogatja a 0–22. 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–22. 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–22. nagyítási szinteket. Formátum: raszter (png).
microsoft.base.labels	string	Az utak címkéi, a vektorcsempék természetes és mesterséges jellemzői. Támogatja a 0–22. 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–22. 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–22. nagyítási szinteket. Formátum: raszter (png).
microsoft.base.road	string	Minden réteg a fő stílusunkkal. Támogatja a 0–22. nagyítási szinteket. Formátum: raszter (png).
microsoft.imagery	string	Műholdas és légi felvételek kombinációja. Csak az S1 tarifacsomagban é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 a 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 raster a mi 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ás infravörös csempék. A legújabb infravörös műholdképek a felhőket a hőmérsékletük alapján jelenítik meg. További információ: Az Azure Maps időjárás-szolgáltatási lefedettsége. A visszaadott műholdas adatokkal kapcsolatos további információkért lásd: Időjárás-szolgáltatások az Azure Mapsben. Támogatja a 0–15. nagyítási szinteket. Formátum: raszter (png).
microsoft.weather.radar.main	string	Időjárási radarcsempék. A legújabb időjárási radarképek, beleértve az esőt, a hót, a jéget és a vegyes körülményeket. Az Azure Maps weather service lefedettségével kapcsolatos további információkért lásd: Az Azure Maps időjárás-szolgáltatási 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–15. nagyítási szinteket. Formátum: raszter (png).

Megosztás a következőn keresztül: