Delen via

Render - Get Map Attribution

Service:
Maps
API-versie:
2024-04-01

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 https://atlas.microsoft.com/map/attribution?api-version=2024-04-01&tilesetId={tilesetId}&zoom={zoom}&bounds={bounds}

URI-parameters

Name In Vereist Type Description
api-version
 query True

string

Versienummer van Azure Maps API. Huidige versie is 2024-04-01.
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

OK
Other Status Codes

ErrorResponse

Er is een onverwachte fout opgetreden.

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 servicehoofd kan toegang krijgen via een ingebouwde rol of een aangepaste rol bestaande uit één of meer permissies 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.

Aantekeningen

  • Deze beveiligingsdefinitie rees het gebruik van de header x-ms-client-id om aan te geven tot welke Azure Maps bron de applicatie toegang vraagt. Dit kan worden verkregen uit de Maps Management API-.

De Authorization URL is specifiek voor de Azure publieke cloudinstantie. Sovereign clouds hebben unieke autorisatie-URL's en Microsoft Entra ID-configuraties. * De Azure rolgebaseerde toegangscontrole wordt geconfigureerd vanaf het Azure beheersplane via Azure portaal, PowerShell, CLI, Azure SDKs of REST API's. * Het gebruik van de Azure Maps Web SDK maakt configuratie-gebaseerde opstelling van een applicatie voor meerdere gebruiksgevallen mogelijk.

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

Bereiken

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

subscription-key

Dit is een gedeelde sleutel die wordt geprovisioneerd bij het aanmaken van een Azure Maps resource via het Azure beheervlak via Azure portaal, PowerShell, CLI, Azure SDKs of REST API's.

Met deze sleutel is elke toepassing gemachtigd voor toegang tot alle REST API's. Met andere woorden, deze kunnen momenteel worden behandeld als hoofdsleutels voor het account waarvoor ze worden uitgegeven.

Voor publiek blootgestelde applicaties is onze aanbeveling om server-to-server toegang te gebruiken van Azure Maps REST API's waar deze sleutel veilig kan worden opgeslagen.

Type: apiKey
In: header

SAS Token

Dit is een shared access-handtekening die wordt aangemaakt vanuit de List SAS-operatie op de Azure Maps resource via het Azure beheervlak via Azure portaal, PowerShell, CLI, Azure SDKs of REST API's.

Met dit token is elke applicatie gemachtigd om met Azure rolgebaseerde toegangscontroles en fijnmazige controle toegang te krijgen tot de vervaldatum, snelheid en regio(s) van gebruik voor de betreffende 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

Statuscode:
200 
{
  "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

Foutreactie
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

Object

Aanvullende informatie over de resourcebeheerfout.

Name Type Description
info

object

De aanvullende informatie.
type

string

Het extra informatietype.

ErrorDetail

Object

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

Object

Foutreactie

Name Type Description
error

ErrorDetail

Het foutobject.

MapAttribution

Object

Copyrighttoeschrijving voor de aangevraagde sectie van een tegelset.

Name Type Description
copyrights

string[]

Een lijst met copyrighttekenreeksen.

TilesetID

Opsomming

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