Render - Get Map Attribution

Služba:
Maps
Verze rozhraní API:
2024-04-01

Slouží k získání informací o přiřazení autorských práv k mapě.
Rozhraní API Get Map Attribution umožňuje uživatelům požadovat informace o přiřazení autorských práv k mapě pro oddíl sady dlaždic.

GET {endpoint}/map/attribution?api-version=2024-04-01&tilesetId={tilesetId}&zoom={zoom}&bounds={bounds}

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
endpoint
 path True

string (uri)

Hostname služby Azure Maps. Použijte https://atlas.microsoft.com pro Azure veřejný cloud. Pro cílení na konkrétní Azure Maps geografii nebo suverénní cloud viz Azure Maps geografický rozsah.
api-version
 query True

string

minLength: 1

Verze rozhraní API, která se má použít pro tuto operaci.
bounds
 query True

number[]

Řetězec, který představuje obdélníkovou oblast ohraničujícího rámečku. Parametr hranic je definován souřadnicemi ohraničujícího rámečku se 4 souřadnicemi ohraničujícího rámečku s délkou WGS84 a zeměpisnou šířkou jihozápadového rohu následovanou délkou WGS84 a zeměpisnou šířkou severovýchodního rohu. Řetězec je uveden v následujícím formátu: [SouthwestCorner_Longitude, SouthwestCorner_Latitude, NortheastCorner_Longitude, NortheastCorner_Latitude].
tilesetId
 query True

TilesetID

Sada dlaždic je kolekce rastrových nebo vektorových dat rozdělených do jednotné mřížky čtvercových dlaždic na přednastavených úrovních přiblížení. Každá sada dlaždic má tilesetId použít při provádění požadavků. Připravené tilesety dodané Azure Maps jsou uvedeny níže. Například microsoft.base.
zoom
 query True

integer (int32)

Úroveň přiblížení požadovaného přiřazení mapy

Hlavička požadavku

Name Vyžadováno Typ Description
x-ms-client-id

string

Označuje účet určený pro použití s bezpečnostním modelem Microsoft Entra ID. Toto jedinečné ID pro účet Azure Maps lze získat z API účtu Azure Maps management plane. Pro více informací o používání Microsoft Entra ID bezpečnosti v Azure Maps viz Spravovat autentizaci v Azure Maps.

Odpovědi

Name Typ Description
200 OK

MapAttribution

Požadavek byl úspěšný.
Other Status Codes

ErrorResponse

Neočekávaná chybová odpověď

Zabezpečení

AadToken

Jsou to Microsoft Entra OAuth 2.0 Flows. V kombinaci s Azure řízením přístupu založeného na rolích lze použít k řízení přístupu k Azure Maps REST API. Role Azure kontroly přístupu se používají k určení přístupu k jednomu nebo více účtům nebo podzdrojům Azure Maps. Každému uživateli, skupině nebo instančnímu objektu je možné udělit přístup prostřednictvím předdefinované role nebo vlastní role složené z jednoho nebo více oprávnění k rozhraním REST API služby Azure Maps.

Pokud chcete implementovat scénáře, doporučujeme zobrazit koncepty ověřování . Stručně řečeno, tato definice zabezpečení poskytuje řešení pro modelování aplikací prostřednictvím objektů schopných řízení přístupu pro konkrétní rozhraní API a rozsahy.

Note

  • Tato definice zabezpečení vyžaduje použití hlavičky x-ms-client-id k označení, ke kterému prostředku Azure Maps aplikace žádá o přístup. To lze získat z rozhraní API pro správu Maps.
  • Authorization URL je specifická pro instanci veřejného cloudu Azure. Suverénní cloudy mají unikátní autorizační URL a konfigurace Microsoft Entra ID.
  • Řízení přístupu na základě role Azure se konfiguruje z roviny správy Azure prostřednictvím webu Azure Portal, PowerShellu, rozhraní příkazového řádku, sad AZURE SDK nebo rozhraní REST API.
  • Použití webové sady SDK služby Azure Maps umožňuje nastavení aplikace na základě konfigurace pro více případů použití.
  • Další informace o platformě Microsoft Identity Platform najdete v tématu Přehled platformy Microsoft Identity Platform.

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/authorize

Rozsahy

Name Description
https://atlas.microsoft.com/.default

subscription-key

Jedná se o sdílený klíč, který se zřídí při vytvoření účtu Azure Maps na webu Azure Portal nebo pomocí PowerShellu, rozhraní příkazového řádku, sad Azure SDK nebo rozhraní REST API.

Díky tomuto klíči má každá aplikace přístup ke všem rozhraní REST API. Jinými slovy, tento klíč lze použít jako hlavní klíč v účtu, ve který jsou vydány.

U veřejně vystavených aplikací doporučujeme používat důvěrných klientských aplikací přístup k rozhraním REST API služby Azure Maps, aby bylo možné klíč bezpečně uložit.

Typ: apiKey
V: header

SAS Token

Jedná se o token sdíleného přístupového podpisu, který se vytvoří z operace Vypsat SAS v prostředku Azure Maps prostřednictvím roviny správy Azure prostřednictvím webu Azure Portal, PowerShellu, rozhraní příkazového řádku, sad SDK Azure nebo rozhraní REST API.

S tímto tokenem má každá aplikace oprávnění k přístupu pomocí řízení přístupu na základě role Azure a jemně odstupňované řízení vypršení platnosti, rychlosti a oblastí použití pro konkrétní token. Jinými slovy, token SAS lze použít k tomu, aby aplikace mohly řídit přístup bezpečnějším způsobem než sdílený klíč.

U veřejně vystavených aplikací doporučujeme nakonfigurovat konkrétní seznam povolených zdrojů na prostředku účtu Map omezit zneužití vykreslování a pravidelně obnovovat token SAS.

Typ: apiKey
V: header

Příklady

Successful Attribution Request

Ukázkový požadavek

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

Ukázková odpověď

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

Definice

Name Description
ErrorAdditionalInfo

Další informace o chybě správy prostředků
ErrorDetail

Podrobnosti o chybě.
ErrorResponse

Běžná chybová odpověď pro všechna API Azure Resource Manager pro vrácení chybových údajů o neúspěšných operacích. (To se také řídí formátem odpovědi na chybu OData.)
MapAttribution

Připisování autorských práv pro požadovanou část sady dlaždic.
TilesetID

Sada dlaždic je kolekce rastrových nebo vektorových dat rozdělených do jednotné mřížky čtvercových dlaždic na přednastavených úrovních přiblížení. Každá sada dlaždic má tilesetId použít při provádění požadavků. Připravené tilesety dodané Azure Maps jsou uvedeny níže. Například microsoft.base.

ErrorAdditionalInfo

Objekt

Další informace o chybě správy prostředků

Name Typ Description
info

Další informace.
type

string

Další typ informací.

ErrorDetail

Objekt

Podrobnosti o chybě.

Name Typ Description
additionalInfo

ErrorAdditionalInfo[]

Další informace o chybě.
code

string

Kód chyby.
details

ErrorDetail[]

Podrobnosti o chybě.
message

string

Chybová zpráva.
target

string

Cíl chyby.

ErrorResponse

Objekt

Běžná chybová odpověď pro všechna API Azure Resource Manager pro vrácení chybových údajů o neúspěšných operacích. (To se také řídí formátem odpovědi na chybu OData.)

Name Typ Description
error

ErrorDetail

Objekt chyby.

MapAttribution

Objekt

Připisování autorských práv pro požadovanou část sady dlaždic.

Name Typ Description
copyrights

string[]

Seznamřetězcůch

TilesetID

Výčet

Sada dlaždic je kolekce rastrových nebo vektorových dat rozdělených do jednotné mřížky čtvercových dlaždic na přednastavených úrovních přiblížení. Každá sada dlaždic má tilesetId použít při provádění požadavků. Připravené tilesety dodané Azure Maps jsou uvedeny níže. Například microsoft.base.

Hodnota Description
microsoft.base

Základní mapa je standardní mapa, která zobrazuje cesty, přirozené a umělé funkce spolu s popisky těchto funkcí ve vektorové dlaždici.

Podporuje úrovně přiblížení 0 až 22. Formát: vector (pbf).
microsoft.base.labels

Zobrazí popisky pro silnice, přirozené a umělé funkce v dlaždici vektoru.

Podporuje úrovně přiblížení 0 až 22. Formát: vector (pbf).
microsoft.base.hybrid

Zobrazí data cest, hranic a popisků v dlaždici vektoru.

Podporuje úrovně přiblížení 0 až 22. Formát: vector (pbf).
microsoft.terra.main

Stínované vrstvy a vrstvy terra.

Podporuje úrovně přiblížení 0 až 6. Formát: rastr (png).
microsoft.base.road

Všechny vrstvy s naším hlavním stylem.

Podporuje úrovně přiblížení 0 až 22. Formát: rastr (png).
microsoft.base.darkgrey

Všechny vrstvy s naším tmavě šedým stylem.

Podporuje úrovně přiblížení 0 až 22. Formát: rastr (png).
microsoft.base.labels.road

Označení dat v našem hlavním stylu

Podporuje úrovně přiblížení 0 až 22. Formát: rastr (png).
microsoft.base.labels.darkgrey

Označte data v našem tmavě šedém stylu.

Podporuje úrovně přiblížení 0 až 22. Formát: rastr (png).
microsoft.base.hybrid.road

Data cest, hranic a popisků v našem hlavním stylu.

Podporuje úrovně přiblížení 0 až 22. Formát: rastr (png).
microsoft.base.hybrid.darkgrey

Údaje o silnicích, hranicích a značkách v našem tmavě šedém stylu.

Podporuje úrovně přiblížení 0 až 22. Formát: rastr (png).
microsoft.imagery

Kombinace satelitních nebo leteckých snímků. K dispozici pouze v cenových cenách S1 a G2.

Podporuje úrovně přiblížení 1 až 19. Formát: rastr (png).
microsoft.weather.radar.main

Radarové dlaždice počasí. Nejnovější snímky radaru počasí včetně oblastí deště, sněhu, ledu a smíšených podmínek. Pro více informací o pokrytí meteorologických služeb Azure Maps viz Azure Maps pokrytí meteorologických služeb. Pro více informací o radarových datech viz Meteorologické služby v Azure Maps.

Podporuje úrovně přiblížení 0 až 15. Formát: rastr (png).
microsoft.weather.infrared.main

Infračervené dlaždice počasí. Nejnovější infračervené satelitní snímky ukazují mraky podle jejich teploty. Pro více informací viz Azure Maps pokrytí meteorologických služeb. Pro více informací o satelitních datech viz Meteorologické služby v Azure Maps.

Podporuje úrovně přiblížení 0 až 15. Formát: rastr (png).
microsoft.traffic.absolute

dlaždice absolutního provozu ve vektoru
microsoft.traffic.absolute.main

dlaždice s absolutním provozem v našem hlavním stylu.
microsoft.traffic.relative

dlaždice relativního provozu ve vektoru
microsoft.traffic.relative.main

dlaždice relativního provozu v rasteru v našem hlavním stylu.
microsoft.traffic.relative.dark

dlaždice relativního provozu v rastru v našem tmavém stylu.
microsoft.traffic.delay

dlaždice provozu ve vektoru
microsoft.traffic.delay.main

dlaždice provozu v rasteru v našem hlavním stylu
microsoft.traffic.reduced.main

zmenšené dlaždice provozu v rasteru v našem hlavním stylu
microsoft.traffic.incident

Dlaždice incidentů ve vektoru