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


Render - Get Map Tileset

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.

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

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

Mintaválasz

{
  "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).