Render - Get Copyright Caption

Platí pro: zobrazení cenových úrovní.

Rozhraní API pro copyrighty je navržené tak, aby sloužilo k poskytování informací o autorských právech pro službu Render Tile. Kromě základních autorských práv pro celou mapu rozhraní API obsluhuje konkrétní skupiny autorských práv pro některé země.

Jako alternativu k autorským právům pro žádost o mapu může jeden získat titulky pro zobrazení informací o poskytovateli mapy na mapě.

GET https://atlas.microsoft.com/map/copyright/caption/{format}?api-version=1.0

Parametry identifikátoru URI

Name In Required Type Description
format
path True

Požadovaný formát odpovědi. Hodnota může být json nebo xml.

api-version
query True
  • string

Číslo verze rozhraní API Azure Maps

Hlavička požadavku

Name Required Type Description
x-ms-client-id
  • string

Určuje, který účet je určený pro použití ve spojení s modelem zabezpečení Azure AD. Představuje jedinečné ID účtu Azure Maps a lze ho načíst z rozhraní API Azure Maps roviny správy. Pokud chcete v Azure Maps používat zabezpečení Azure AD, přečtěte si následující články s pokyny.

Odpovědi

Name Type Description
200 OK

OK

Other Status Codes

Došlo k neočekávané chybě.

Zabezpečení

AADToken

Jedná se o toky Azure Active Directory OAuth2 . Při spárování s řízením přístupu na základě role Azure se dá použít k řízení přístupu k rozhraním REST API Azure Maps. Řízení přístupu na základě role Azure slouží k určení přístupu k jednomu nebo několika Azure Maps účtu prostředku nebo dílčím prostředkům. 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 s jednou nebo více oprávněními k Azure Maps rozhraní REST API.

Pokud chcete implementovat scénáře, doporučujeme zobrazit koncepty ověřování. V souhrnu 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 obory.

Poznámky

  • Tato definice zabezpečení vyžaduje použití x-ms-client-id hlavičky k označení, ke kterému Azure Maps prostředku, ke kterému aplikace požaduje přístup. Můžete ho získat z rozhraní API pro správu map.

To Authorization URL je specifické pro instanci veřejného cloudu Azure. Suverénní cloudy mají jedinečné adresy URL autorizace a konfigurace Azure Active Directory. * Řízení přístupu na základě role Azure se konfiguruje z roviny správy Azure prostřednictvím Azure Portal, PowerShellu, rozhraní příkazového řádku, sad SDK Azure nebo rozhraní REST API. * Použití sady Azure Maps Web SDK umožňuje konfiguraci nastavení aplikace pro více případů použití.

  • Azure Active Directory verze 1.0 nebo v2.0 v současné době podporuje pracovní, školní a hosty, ale nepodporuje osobní účty.

Type: 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

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

S tímto klíčem 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 vystaveny.

U veřejně vystavených aplikací doporučujeme použít důvěrný klientský přístup k přístupu k rozhraním REST API Azure Maps, aby se váš klíč mohl bezpečně uložit.

Type: apiKey
In: query

SAS Token

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

S tímto tokenem má každá aplikace oprávnění pro přístup 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ů v prostředku účtu Map , aby se omezilo zneužití vykreslování a pravidelně obnovte token SAS.

Type: apiKey
In: header

Příklady

Sample Request

GET https://atlas.microsoft.com/map/copyright/caption/json?api-version=1.0

Sample Response

{
  "formatVersion": "0.0.1",
  "copyrightsCaption": "© 1992 - 2017 TomTom."
}

Definice

CopyrightCaption

Tento objekt se vrátí z úspěšného volání autorských práv.

ErrorAdditionalInfo

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

ErrorDetail

Podrobnosti o chybě.

ErrorResponse

Chybová odpověď

ResponseFormat

Požadovaný formát odpovědi. Hodnota může být json nebo xml.

CopyrightCaption

Tento objekt se vrátí z úspěšného volání autorských práv.

Name Type Description
copyrightsCaption
  • string

Vlastnost Titulky autorských práv

formatVersion
  • string

Vlastnost Format Version

ErrorAdditionalInfo

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

Name Type Description
info
  • object

Další informace.

type
  • string

Další typ informací.

ErrorDetail

Podrobnosti o chybě.

Name Type Description
additionalInfo

Další informace o chybě.

code
  • string

Kód chyby

details

Podrobnosti o chybě.

message
  • string

Chybová zpráva

target
  • string

Cíl chyby.

ErrorResponse

Chybová odpověď

Name Type Description
error

Objekt chyby.

ResponseFormat

Požadovaný formát odpovědi. Hodnota může být json nebo xml.

Name Type Description
json
  • string

Formát zaměnit data zápisu objektů JavaScriptu

xml
  • string

Rozšiřitelný jazyk značek