Render - Get Map Attribution

Gebruik dit om informatie over het toewijzen van copyrights toe te wijzen.
Met de Get Map Attribution-API kunnen gebruikers informatie over copyrighttoeschrijving aanvragen voor een sectie van een tegelset.

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

URI-parameters

Name In Vereist Type Description
endpoint
path True

string (uri)

De hostnaam van de Azure Maps-service. Gebruik https://atlas.microsoft.com voor de Azure publieke cloud. Om een specifieke Azure Maps geografie of een soevereine cloud te targeten, zie Azure Maps geografische reikwijdte.

api-version
query True

string

minLength: 1

De API-versie die voor deze bewerking moet worden gebruikt.

bounds
query True

number[]

De tekenreeks die het rechthoekige gebied van een begrenzingsvak vertegenwoordigt. De parameter grenzen wordt gedefinieerd door de 4 begrenzingsvakcoƶrdinaten, met WGS84-lengtegraad en breedtegraad van de zuidwesthoek, gevolgd door WGS84-lengtegraad en breedtegraad van de noordoosthoek. De tekenreeks wordt weergegeven in de volgende indeling: [SouthwestCorner_Longitude, SouthwestCorner_Latitude, NortheastCorner_Longitude, NortheastCorner_Latitude].

tilesetId
query True

TilesetID

Een tegelset is een verzameling raster- of vectorgegevens die zijn opgesplitst in een uniform raster met vierkante tegels op vooraf ingestelde zoomniveaus. Elke tegelset heeft een tegelsetId die u kunt gebruiken bij het indienen van aanvragen. De kant-en-klare tilesets die door Azure Maps worden geleverd, worden hieronder vermeld. Bijvoorbeeld microsoft.base.

zoom
query True

integer (int32)

Zoomniveau voor de gewenste kaarttoeschrijving.

Aanvraagkoptekst

Name Vereist Type Description
x-ms-client-id

string

Geeft het account aan dat bedoeld is voor gebruik met het Microsoft Entra ID-beveiligingsmodel. Deze unieke ID voor het Azure Maps-account kan worden verkregen via de Azure Maps beheerplane Account API. Voor meer informatie over het gebruik van Microsoft Entra ID beveiliging in Azure Maps, zie Beheer authenticatie in Azure Maps.

Antwoorden

Name Type Description
200 OK

MapAttribution

De aanvraag is voltooid.

Other Status Codes

ErrorResponse

Een onverwachte foutreactie.

Beveiliging

AadToken

Dit zijn de Microsoft Entra OAuth 2.0 stromen. In combinatie met Azure rolgebaseerde toegang control kan het worden gebruikt om de toegang tot Azure Maps REST-API's te controleren. Azure rolgebaseerde toegangscontroles worden gebruikt om toegang aan een of meer Azure Maps-resourceaccounts of subresources aan te wijzen. Elke gebruiker, groep of service-principal kan toegang krijgen via een ingebouwde rol of een aangepaste rol die bestaat uit een of meer machtigingen voor Azure Maps REST API's.

Voor het implementeren van scenario's raden we u aan om verificatieconceptente bekijken. Kortom, deze beveiligingsdefinitie biedt een oplossing voor het modelleren van toepassingen via objecten die toegangsbeheer kunnen uitvoeren voor specifieke API's en bereiken.

Note

  • Deze beveiligingsdefinitie vereist het gebruik van de x-ms-client-id-header om aan te geven tot welke Azure Maps-resource de toepassing toegang aanvraagt. Dit kan worden verkregen uit de Maps Management API-.
  • De Authorization URL is specifiek voor het exemplaar van de openbare Azure-cloud. Sovereign clouds hebben unieke autorisatie-URL's en Microsoft Entra ID-configuraties.
  • Het op rollen gebaseerde toegangsbeheer van Azure wordt geconfigureerd vanuit het Azure-beheervlak via Azure Portal, PowerShell, CLI, Azure SDK's of REST API's.
  • Gebruik van de Azure Maps Web SDK maakt configuratiegebaseerde installatie van een toepassing mogelijk voor meerdere gebruiksscenario's.
  • Zie Overzicht van Microsoft Identity Platformvoor meer informatie over het Microsoft Identity Platform.

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

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

subscription-key

Dit is een gedeelde sleutel die wordt ingericht wanneer u Een Azure Maps-account maken in Azure Portal of met behulp van PowerShell, CLI, Azure SDK's of REST API.

Met deze sleutel heeft elke toepassing toegang tot alle REST API's. Met andere woorden, deze sleutel kan worden gebruikt als een hoofdsleutel in het account waarin ze worden uitgegeven.

Voor openbaar blootgestelde toepassingen is het raadzaam om de vertrouwelijke clienttoepassingen te gebruiken benadering voor toegang tot Azure Maps REST API's, zodat uw sleutel veilig kan worden opgeslagen.

Type: apiKey
In: header

SAS Token

Dit is een shared access Signature-token dat wordt gemaakt op basis van de bewerking List SAS op de Azure Maps-resource via het Azure-beheervlak via Azure Portal, PowerShell, CLI, Azure SDK's of REST API's.

Met dit token is elke toepassing gemachtigd voor toegang met op rollen gebaseerd toegangsbeheer van Azure en gedetailleerd beheer tot de vervaldatum, snelheid en regio(s) van gebruik voor het specifieke token. Met andere woorden, het SAS-token kan worden gebruikt om toepassingen toe te staan toegang op een veiligere manier te beheren dan de gedeelde sleutel.

Voor openbaar blootgestelde toepassingen wordt aangeraden een specifieke lijst met toegestane origins te configureren voor de resource van het Account toewijzen om het genereren van misbruik te beperken en het SAS-token regelmatig te vernieuwen.

Type: apiKey
In: header

Voorbeelden

Successful Attribution Request

Voorbeeldaanvraag

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

Voorbeeldrespons

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

Definities

Name Description
ErrorAdditionalInfo

Aanvullende informatie over de resourcebeheerfout.

ErrorDetail

De foutdetails.

ErrorResponse

Veelvoorkomende foutrespons voor alle Azure Resource Manager API's om foutdetails terug te geven bij mislukte bewerkingen. (Dit volgt ook de OData-foutreactieindeling.)

MapAttribution

Copyrighttoeschrijving voor de aangevraagde sectie van een tegelset.

TilesetID

Een tegelset is een verzameling raster- of vectorgegevens die zijn opgesplitst in een uniform raster met vierkante tegels op vooraf ingestelde zoomniveaus. Elke tegelset heeft een tegelsetId die u kunt gebruiken bij het indienen van aanvragen. De kant-en-klare tilesets die door Azure Maps worden geleverd, worden hieronder vermeld. Bijvoorbeeld microsoft.base.

ErrorAdditionalInfo

Aanvullende informatie over de resourcebeheerfout.

Name Type Description
info

De aanvullende informatie.

type

string

Het extra informatietype.

ErrorDetail

De foutdetails.

Name Type Description
additionalInfo

ErrorAdditionalInfo[]

De fout bevat aanvullende informatie.

code

string

De foutcode.

details

ErrorDetail[]

De foutdetails.

message

string

Het foutbericht.

target

string

Het foutdoel.

ErrorResponse

Veelvoorkomende foutrespons voor alle Azure Resource Manager API's om foutdetails terug te geven bij mislukte bewerkingen. (Dit volgt ook de OData-foutreactieindeling.)

Name Type Description
error

ErrorDetail

Het foutobject.

MapAttribution

Copyrighttoeschrijving voor de aangevraagde sectie van een tegelset.

Name Type Description
copyrights

string[]

Een lijst met copyrighttekenreeksen.

TilesetID

Een tegelset is een verzameling raster- of vectorgegevens die zijn opgesplitst in een uniform raster met vierkante tegels op vooraf ingestelde zoomniveaus. Elke tegelset heeft een tegelsetId die u kunt gebruiken bij het indienen van aanvragen. De kant-en-klare tilesets die door Azure Maps worden geleverd, worden hieronder vermeld. Bijvoorbeeld microsoft.base.

Waarde Description
microsoft.base

Een basiskaart is een standaardkaart die wegen, natuurlijke en kunstmatige kenmerken weergeeft, samen met de labels voor deze kenmerken in een vectortegel.

Ondersteunt zoomniveaus 0 tot en met 22. Indeling: vector (pbf).

microsoft.base.labels

Geeft labels weer voor wegen, natuurlijke en kunstmatige kenmerken in een vectortegel.

Ondersteunt zoomniveaus 0 tot en met 22. Indeling: vector (pbf).

microsoft.base.hybrid

Geeft weg-, grens- en labelgegevens weer in een vectortegel.

Ondersteunt zoomniveaus 0 tot en met 22. Indeling: vector (pbf).

microsoft.terra.main

Gearceerde opluchting en terralagen.

Ondersteunt zoomniveaus 0 tot en met 6. Indeling: raster (png).

microsoft.base.road

Alle lagen met onze hoofdstijl.

Ondersteunt zoomniveaus 0 tot en met 22. Indeling: raster (png).

microsoft.base.darkgrey

Alle lagen met onze donkergrijze stijl.

Ondersteunt zoomniveaus 0 tot en met 22. Indeling: raster (png).

microsoft.base.labels.road

Label gegevens in onze hoofdstijl.

Ondersteunt zoomniveaus 0 tot en met 22. Indeling: raster (png).

microsoft.base.labels.darkgrey

Labelgegevens in onze donkergrijze stijl.

Ondersteunt zoomniveaus 0 tot en met 22. Indeling: raster (png).

microsoft.base.hybrid.road

Weg-, grens- en labelgegevens in onze hoofdstijl.

Ondersteunt zoomniveaus 0 tot en met 22. Indeling: raster (png).

microsoft.base.hybrid.darkgrey

Weg-, grens- en labelgegevens in onze donkergrijze stijl.

Ondersteunt zoomniveaus 0 tot en met 22. Indeling: raster (png).

microsoft.imagery

Een combinatie van satelliet- of luchtfoto's. Alleen beschikbaar in S1- en G2-prijs-SKU.

Ondersteunt zoomniveaus 1 tot en met 19. Indeling: raster (png).

microsoft.weather.radar.main

Weerradartegels. Nieuwste weerradarbeelden, waaronder regengebieden, sneeuw, ijs en gemengde omstandigheden. Voor meer informatie over de dekking van de Azure Maps Weather Service, zie Azure Maps weerdiensten verslaggeving. Voor meer informatie over radargegevens, zie Weerdiensten in Azure Maps.

Ondersteunt zoomniveaus 0 tot en met 15. Indeling: raster (png).

microsoft.weather.infrared.main

Weer infraroodtegels. Nieuwste infrarood satellietbeelden tonen wolken op hun temperatuur. Voor meer informatie, zie Azure Maps weerdienst verslaggeving. Voor meer informatie over de teruggegeven satellietgegevens, zie Weerdiensten in Azure Maps.

Ondersteunt zoomniveaus 0 tot en met 15. Indeling: raster (png).

microsoft.traffic.absolute

absolute verkeerstegels in vector

microsoft.traffic.absolute.main

absolute verkeerstegels in raster in onze hoofdstijl.

microsoft.traffic.relative

relatieve verkeerstegels in vector

microsoft.traffic.relative.main

relatieve verkeerstegels in raster in onze hoofdstijl.

microsoft.traffic.relative.dark

relatieve verkeerstegels in raster in onze donkere stijl.

microsoft.traffic.delay

verkeerstegels in vector

microsoft.traffic.delay.main

verkeerstegels in raster in onze hoofdstijl

microsoft.traffic.reduced.main

minder verkeerstegels in raster in onze hoofdstijl

microsoft.traffic.incident

incidenttegels in vector