Render - Get Map Tileset

Hiermee haalt u metagegevens op voor een tegelset.
Met de GET Map Tileset-API kunnen gebruikers metagegevens voor een tegelset aanvragen.

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

URI-parameters

Aanvraagkoptekst

Antwoorden

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 om REST-API's te Azure Maps.\n\nOm scenario's te implementeren raden we aan om authenticatieconcepten te bekijken. Samengevat biedt deze beveiligingsdefinitie een oplossing voor het modelleren van applicatie(s) via objecten die toegang hebben tot specifieke API's en scopes.\n\n#### Notities\n* Deze beveiligingsdefinitie ree het gebruik van de x-ms-client-id header om aan te geven tot welke Azure Maps resource de applicatie toegang vraagt. Dit kan worden verkregen via de Maps management API.\n* \nDe Authorization URL is specifiek voor de Azure publieke cloud-instantie. Sovereign clouds hebben unieke autorisatie-URL's en Microsoft Entra ID-configuraties. \n* \nDe Azure rolgebaseerde toegangscontrole wordt geconfigureerd vanaf het Azure beheerplane via Azure portaal, PowerShell, CLI, Azure-SDK's of REST API's.\n* \nGebruik van de Azure Maps Web SDK maakt configuratie-gebaseerde opstelling van een applicatie voor meerdere gebruikssituaties mogelijk.\n* Voor meer informatie over Microsoft identity platform, zie Microsoft identity platform overzicht.

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

Bereiken

subscription-key

Dit is een gedeelde sleutel die wordt ingesteld wanneer je > aanmaakt in het Azure portaal of met PowerShell, CLI, Azure-SDK's of REST API.\n\n Met deze sleutel kan elke applicatie toegang krijgen tot alle REST API's. Met andere woorden, deze sleutel kan worden gebruikt als een hoofdsleutel in de rekening waarin ze worden uitgegeven.\n\n Voor publiek blootgestelde applicaties is onze aanbeveling om de confidential client applications benadering te gebruiken om toegang te krijgen tot Azure Maps REST-API's, zodat je sleutel veilig kan worden opgeslagen.

Type: apiKey
In: header

SAS Token

Dit is een shared access signature token dat wordt aangemaakt vanuit de List SAS-operatie op de Azure Maps resource via het Azure beheervlak via Azure portaal, PowerShell, CLI, Azure-SDK's of REST API's.\n\n Met dit token is elke applicatie gemachtigd om toegang te krijgen met Azure rolgebaseerde toegangscontroles en fijnmazige controle over de vervaldatum, snelheid en regio(s) van gebruik voor de betreffende token. Met andere woorden, de SAS Token kan worden gebruikt om applicaties toegang op een veiligere manier te laten beheren dan de gedeelde sleutel.\n\n Voor publiek blootgestelde applicaties is onze aanbeveling om een specifieke lijst van toegestane oorsprongen in de Map-accountresource te configureren om rendermisbruik te beperken en de SAS-token regelmatig te vernieuwen.

Type: apiKey
In: header

Voorbeelden

Successful Tileset Request

GET {endpoint}/map/tileset?api-version=2024-04-01&tilesetId=microsoft.base

{
  "attribution": "<a data-azure-maps-attribution-tileset=\"microsoft.base\">&copy;2022 TomTom</a>",
  "bounds": [
    -180,
    -90,
    180,
    90
  ],
  "maxzoom": 22,
  "minzoom": 0,
  "scheme": "xyz",
  "tilejson": "2.2.0",
  "tiles": [
    "https://atlas.microsoft.com/map/tile?api-version=2024-04-01&tilesetId={tilesetId}&zoom={zoom}&x={x}&y={y}"
  ],
  "version": "1.0.0"
}

Definities

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.)

MapTileset

Metagegevens voor een tegelset in de TileJSON-indeling.

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.