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 |
|
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: |
|
tileset
|
query | True |
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 |
De aanvraag is voltooid. |
|
| Other Status Codes |
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 URLis 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\">©2022 TomTom</a>"
]
}
Definities
| Name | Description |
|---|---|
|
Error |
Aanvullende informatie over de resourcebeheerfout. |
|
Error |
De foutdetails. |
|
Error |
Veelvoorkomende foutrespons voor alle Azure Resource Manager API's om foutdetails terug te geven bij mislukte bewerkingen. (Dit volgt ook de OData-foutreactieindeling.) |
|
Map |
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 |
De fout bevat aanvullende informatie. |
|
| code |
string |
De foutcode. |
| details |
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 |
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 |