Render - Get Map Attribution

Referencia

Szolgáltatás:: Maps

API-verzió:: 2024-04-01

A használatával lekérheti a térkép szerzői jogi forrásadatait.

Az Get Map Attribution API lehetővé teszi a felhasználók számára, hogy lekérjék a csempekészletek egy szakaszára vonatkozó szerzői jogi hozzárendelési információkat.

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

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.
bounds	query	True	number[]	A határolókeret téglalap alakú területét jelölő sztring. A bounds paramétert a 4 határolókeret koordinátái határozzák meg, A WGS84 hosszúsága és szélessége a délnyugati sarokban, majd a WGS84 hosszúsága és az északkeleti sarok szélessége. A sztring a következő formátumban jelenik meg: `[SouthwestCorner_Longitude, SouthwestCorner_Latitude, NortheastCorner_Longitude, NortheastCorner_Latitude]`.
tilesetId	query	True	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.
zoom	query	True	integer int32	A kívánt térkép-hozzárendelés nagyítási szintje.

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	MapAttribution	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
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 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 Attribution Request

Sample request

HTTP

GET https://atlas.microsoft.com/map/attribution?api-version=2024-04-01&tilesetId=microsoft.base&zoom=6&bounds=-122.414162,47.57949,-122.247157,47.668372

Sample response

Status code:: 200

{
  "copyrights": [
    "<a data-azure-maps-attribution-tileset=\"microsoft.base\">&copy;2022 TomTom</a>"
  ]
}

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
MapAttribution	A csempekészlet kért szakaszának szerzői jogi hozzárendelése.
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.

MapAttribution

A csempekészlet kért szakaszának szerzői jogi hozzárendelése.

Name	Típus	Description
copyrights	string[]	A szerzői jogi sztringek listája.

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: