Render - Get Map Attribution
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: |
tileset
|
query | True |
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 |
OK |
|
Other Status Codes |
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 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
Mintakérelem
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
Mintaválasz
{
"copyrights": [
"<a data-azure-maps-attribution-tileset=\"microsoft.base\">©2022 TomTom</a>"
]
}
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 |
Map |
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 |
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 hibacél. |
ErrorResponse
Hibaválasz
Name | Típus | Description |
---|---|---|
error |
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). |