Render - Get Map Static Image

Service:

Maps

API-versie:

2024-04-01

Deze rendering-API produceert statische, rasterweergaven van een door de gebruiker gedefinieerd gebied. Het is geschikt voor lichtgewicht webtoepassingen, wanneer de gewenste gebruikerservaring geen interactieve kaartbesturingselementen vereist of wanneer de bandbreedte beperkt is. Deze API is ook handig voor het insluiten van kaarten in toepassingen buiten de browser, in back-endservices, het genereren van rapporten of bureaubladtoepassingen.

Deze API bevat parameters voor eenvoudige gegevensvisualisatie:

• Gelabelde punaises in meerdere stijlen.
• De geometrietypen cirkel, pad en veelhoek weergeven.

Zie Aangepaste gegevens weergeven op een rasterkaart voor meer informatie en gedetailleerde voorbeelden.

De afmetingen van de bbox-parameter zijn beperkt, afhankelijk van het zoomniveau. Dit zorgt ervoor dat de resulterende afbeelding een geschikt detailniveau heeft.

Zoomniveau	Minimale Lon Range	Max Lon-bereik	Minimumbereik van lat	Maximumbereik van lat
0	56.25	360.0	30.1105585173	180.0
1	28.125	360.0	14.87468995	180.0
2	14.063	351.5625	7.4130741851	137.9576312246
3	7.03125	175.78125	3.7034501005	73.6354071932
4	3.515625	87.890625	1.8513375155	35.4776115315
5	1.7578125	43.9453125	0.925620264	17.4589959239
6	0.87890625	21.97265625	0.4628040687	8.6907788223
7	0.439453125	10.986328125	0.2314012764	4.3404320789
8	0.2197265625	5.4931640625	0.1157005434	2.1695927024
9	0.1098632812	2.7465820312	0.0578502599	1.0847183194
10	0.0549316406	1.3732910156	0.0289251285	0.5423494021
11	0.0274658203	0.6866455078	0.014462564	0.2711734813
12	0.0137329102	0.3433227539	0.007231282	0.1355865882
13	0.0068664551	0.171661377	0.003615641	0.067793275
14	0.0034332275	0.0858306885	0.0018078205	0.0338966351
15	0.0017166138	0.0429153442	0.0009039102	0.0169483173
16	0.0008583069	0.0214576721	0.0004519551	0.0084741586
17	0.0004291534	0.0107288361	0.0002259776	0.0042370793
18	0.0002145767	0.005364418	0.0001129888	0.0021185396
19	0.0001072884	0.002682209	5,64944E-05	0.0010592698
20	5,36442E-05	0.0013411045	2,82472E-05	0.0005296349

Opmerking : de parameter center of bbox moet worden opgegeven aan de API.

GET https://atlas.microsoft.com/map/static?api-version=2024-04-01

Met optionele parameters:

GET https://atlas.microsoft.com/map/static?api-version=2024-04-01&tilesetId={tilesetId}&trafficLayer={trafficLayer}&zoom={zoom}&center={center}&bbox={bbox}&height={height}&width={width}&language={language}&view={view}&pins={pins}&path={path}

URI-parameters

Name	In	Vereist	Type	Description
api-version	query	True	string	Versienummer van Azure Maps-API. Huidige versie is 2024-04-01.
bbox	query		number[]	Een begrenzingsvak wordt gedefinieerd door twee breedtegraden en twee lengtegraden die de vier zijden van een rechthoekig gebied op de aarde vertegenwoordigen. Formaat: 'minLon, minLat, maxLon, maxLat' (dubbel). Opmerking: bbox of center zijn vereiste parameters. Ze sluiten elkaar uit. bbox mag niet worden gebruikt met hoogte of breedte. De maximaal en minimaal toegestane bereiken voor Lat en Lon worden gedefinieerd voor elk zoomniveau in de tabel boven aan deze pagina.
center	query		number[]	Coördinaten van het middelpunt in het dubbele. Indeling: 'lon,lat'. Lengtegraadbereik: -180 tot 180. Breedtebereik: -90 tot 90. Opmerking: center of bbox zijn vereiste parameters. Ze sluiten elkaar uit.
height	query		integer int32	Hoogte van de resulterende afbeelding in pixels. Bereik van 80 tot 1500. De standaardwaarde is 512. Het mag niet worden gebruikt met bbox.
language	query		string	Taal waarin zoekresultaten moeten worden geretourneerd. Moet een van de ondersteunde IETF-taaltags zijn, niet hoofdlettergevoelig. Wanneer gegevens in de opgegeven taal niet beschikbaar zijn voor een specifiek veld, wordt de standaardtaal gebruikt. Raadpleeg Ondersteunde talen voor meer informatie.
path	query		string[]	Padstijl en locaties (dubbel). Gebruik deze parameter om eventueel lijnen, veelhoeken of cirkels toe te voegen aan de afbeelding. De padstijl beschrijft het uiterlijk van de lijn en opvulling. (Zorg ervoor dat u de waarden van deze parameter op de juiste URL codeert, omdat deze gereserveerde tekens bevat, zoals pipes en interpunctie.) De padparameter wordt ondersteund in de SKU van het Azure Maps-account, te beginnen met S1. Meerdere exemplaren van de padparameter maken het mogelijk om meerdere geometrieën met hun stijlen op te geven. Het aantal parameters per aanvraag is beperkt tot 10 en het aantal locaties is beperkt tot 100 per pad. Als u een cirkel wilt weergeven met een radius van 100 meter en een middelpunt op 45°N en een lengtegraad van 122°W met behulp van de standaardstijl, voegt u de parameter querytekenreeks toe path=ra100||-122 45 Houd er rekening mee dat de lengtegraad vóór de breedtegraad komt. Na URL-codering ziet dit er als volgt uit path=ra100%7C%7C-122+45 Alle voorbeelden hier tonen de padparameter zonder URL-codering, voor de duidelijkheid. Als u een lijn wilt weergeven, scheidt u elke locatie met een sluisteken. Gebruik bijvoorbeeld path=||-122 45|-119.5 43.2|-121.67 47.12 Een veelhoek wordt opgegeven met een gesloten pad, waarbij het eerste en laatste punt gelijk zijn. Gebruik bijvoorbeeld path=||-122 45|-119.5 43.2|-121.67 47.12|-122 45 Lengtegraadwaarde voor locaties van lijnen en veelhoeken kan liggen in het bereik van -360 tot 360 om weergave van geometrieën mogelijk te maken die de anti-idiaan overschrijden. Stijlaanpassingen U kunt het uiterlijk van het pad wijzigen door stijlaanpassingen toe te voegen. Deze worden toegevoegd vóór de locaties. Stijlaanpassingen hebben elk een naam van twee letters. Deze verkorte namen worden gebruikt om de lengte van de URL te verminderen. Als u de kleur van de omtrek wilt wijzigen, gebruikt u de stijl 'lc' en geeft u de kleur op met behulp van de HTML/CSS RGB-kleurindeling. Dit is een zescijferig hexadecimaal getal (de driecijferige vorm wordt niet ondersteund). Als u bijvoorbeeld een diep roze kleur wilt gebruiken die u opgeeft als #FF1493 in CSS, gebruikt u path=lcFF1493||-122 45|-119.5 43.2 Meerdere stijlaanpassingen kunnen worden gecombineerd om een complexere visuele stijl te creëren. lc0000FF|lw3|la0.60|fa0.50||-122.2 47.6|-122.2 47.7|-122.3 47.7|-122.3 47.6|-122.2 47.6 Samenvatting van stijlaanpassing Modifier Description Type Bereik Lc Lijnkleur tekenreeks 000000 naar FFFFFF Fc Opvulkleur tekenreeks 000000 naar FFFFFF la Lijn alfa (matheid) float 0 tot 1 fa Alfa doorvoeren (ondoorzichtigheid) float 0 tot 1 Lw Lijnbreedte int32 (0, 50] Ra Cirkelstraal (meters) float Groter dan 0
pins	query		string[]	Punaisestijl en -exemplaren. Gebruik deze parameter om eventueel punaises toe te voegen aan de afbeelding. De punaisestijl beschrijft het uiterlijk van de punaises en de exemplaren geven de coördinaten van de punaises (dubbel) en optionele labels voor elke speld op. (Zorg ervoor dat u de waarden van deze parameter op de juiste URL codeert, omdat deze gereserveerde tekens bevat, zoals pipes en interpunctie.) De SKU van het Azure Maps-account ondersteunt slechts één exemplaar van de parameter pins. Met andere SKU's kunnen meerdere exemplaren van de parameter pins meerdere pinstijlen opgeven. Als u een punaise wilt weergeven op 45°N-breedtegraad en 122°W-lengtegraad met behulp van de standaard ingebouwde punaisestijl, voegt u de parameter querytekenreeks toe pins=default||-122 45 Houd er rekening mee dat de lengtegraad vóór de breedtegraad komt. Na URL-codering ziet dit er als volgt uit pins=default%7C%7C-122+45 Alle voorbeelden hier tonen de parameter pins zonder URL-codering, voor de duidelijkheid. Als u een speld op meerdere locaties wilt weergeven, scheidt u elke locatie met een sluisteken. Gebruik bijvoorbeeld pins=default||-122 45|-119.5 43.2|-121.67 47.12 De S0 Azure Maps-account-SKU staat slechts vijf punaises toe. Andere account-SKU's hebben deze beperking niet. Stijlaanpassingen U kunt het uiterlijk van de pinnen wijzigen door stijlaanpassingen toe te voegen. Deze worden toegevoegd na de stijl, maar vóór de locaties en labels. Stijlaanpassingen hebben elk een naam van twee letters. Deze verkorte namen worden gebruikt om de lengte van de URL te verminderen. Als u de kleur van de punaise wilt wijzigen, gebruikt u de stijl 'co' en geeft u de kleur op met behulp van de HTML/CSS RGB-kleurindeling. Dit is een zescijferig hexadecimaal getal (de driecijferige vorm wordt niet ondersteund). Als u bijvoorbeeld een diep roze kleur wilt gebruiken die u opgeeft als #FF1493 in CSS, gebruikt u pins=default|coFF1493||-122 45 Punaiselabels Als u een label aan de pinnen wilt toevoegen, plaatst u het label tussen enkele aanhalingstekens vlak voor de coördinaten. Vermijd het gebruik van een speciaal teken, zoals | of || in het label. Als u bijvoorbeeld drie spelden wilt labelen met de waarden '1', '2' en '3', gebruikt u pins=default||'1'-122 45|'2'-119.5 43.2|'3'-121.67 47.12 Er is een ingebouwde punaisestijl met de naam 'none' die geen punaiseafbeelding weergeeft. U kunt dit gebruiken als u labels wilt weergeven zonder een afbeelding vast te maken. Bijvoorbeeld: pins=none||'A'-122 45|'B'-119.5 43.2 Als u de kleur van de punaiselabels wilt wijzigen, gebruikt u de wijzigingsfunctie voor de labelkleurstijl 'lc'. Als u bijvoorbeeld roze punaises met zwarte etiketten wilt gebruiken, gebruikt u pins=default|coFF1493|lc000000||-122 45 Als u de grootte van de etiketten wilt wijzigen, gebruikt u de wijzigingsfunctie voor de labelgrootte. De labelgrootte geeft de geschatte hoogte van de labeltekst in pixels aan. Als u bijvoorbeeld de labelgrootte wilt verhogen naar 12, gebruikt u pins=default|ls12||'A'-122 45|'B'-119 43 De labels zijn gecentreerd op de punaise 'labelanker'. De ankerlocatie is vooraf gedefinieerd voor ingebouwde punaises en bevindt zich in het midden van aangepaste punaises (zie hieronder). Als u het labelanker wilt overschrijven, gebruikt u de wijzigingsfunctie 'la' en geeft u X- en Y-pixelcoördinaten op voor het anker. Deze coördinaten zijn relatief ten opzichte van de linkerbovenhoek van de punaiseafbeelding. Positieve X-waarden verplaatsen het anker naar rechts en positieve Y-waarden verplaatsen het anker naar beneden. Als u bijvoorbeeld het labelanker 10 pixels rechts en 4 pixels boven de linkerbovenhoek van de punaise wilt plaatsen, gebruikt u pins=default|la10 -4||'A'-122 45|'B'-119 43 Aangepaste punaises Als u een aangepaste punaiseafbeelding wilt gebruiken, gebruikt u het woord 'aangepast' als de naam van de pinstijl en geeft u een URL op na de locatie- en labelgegevens. De maximaal toegestane grootte voor een aangepaste labelafbeelding is 65.536 pixels. Gebruik twee sluistekens om aan te geven dat u klaar bent met het opgeven van locaties en dat de URL wordt gestart. Bijvoorbeeld: pins=custom||-122 45||http://contoso.com/pushpins/red.png Na URL-codering ziet dit er als volgt uit pins=custom%7C%7C-122+45%7C%7Chttp%3A%2F%2Fcontoso.com%2Fpushpins%2Fred.png Standaard worden aangepaste punaiseafbeeldingen gecentreerd op de pincoördinaten. Dit is meestal niet ideaal, omdat hiermee de locatie wordt verborgen die u probeert te markeren. Als u de ankerlocatie van de speldafbeelding wilt overschrijven, gebruikt u de wijzigingsfunctie voor de stijl 'an'. Hierbij wordt dezelfde indeling gebruikt als de wijzigingsfunctie voor de labelankerstijl 'la'. Als uw aangepaste speldafbeelding bijvoorbeeld de punt van de speld in de linkerbovenhoek van de afbeelding heeft, kunt u het anker op die plek instellen met behulp van pins=custom|an0 0||-122 45||http://contoso.com/pushpins/red.png Opmerking: als u de 'co'-kleuraanpassing gebruikt met een aangepaste punaiseafbeelding, vervangt de opgegeven kleur de RGB-kanalen van de pixels in de afbeelding, maar blijft het alfakanaal (ondoorzichtigheid) ongewijzigd. Dit wordt meestal alleen gedaan met een aangepaste afbeelding met een effen kleur. Schalen, draaien en dekking U kunt punaises en de bijbehorende labels groter of kleiner maken met behulp van de aanpassingsfunctie voor de schaalstijl 'sc'. Dit is een waarde die groter is dan nul. De waarde 1 is de standaardschaal. Waarden groter dan 1 maken de pinnen groter en waarden kleiner dan 1 maken ze kleiner. Als u bijvoorbeeld de punaises wilt tekenen die 50% groter zijn dan normaal, gebruikt u pins=default|sc1.5||-122 45 U kunt punaises en hun labels draaien met behulp van de wijzigingsstijl ro. Dit is een aantal graden van draaiing met de klok mee. Gebruik een negatief getal om linksom te draaien. Als u de punaises bijvoorbeeld 90 graden rechtsom wilt draaien en hun grootte wilt verdubbelen, gebruikt u pins=default|ro90|sc2||-122 45 U kunt punaises en de bijbehorende labels gedeeltelijk transparant maken door de wijzigingsfunctie voor alfastijl 'al' op te geven. Dit is een getal tussen 0 en 1 dat de dekking van de punaises aangeeft. Nul maakt ze volledig transparant (en niet zichtbaar) en 1 maakt ze volledig ondoorzichtig (wat de standaardinstelling is). Als u bijvoorbeeld punaises en de bijbehorende labels slechts 67% ondoorzichtig wilt maken, gebruikt u pins=default|al.67||-122 45 Samenvatting van stijlaanpassing Modifier Description Type Bereik al Alfa (dekking) float 0 tot 1 an Anker vastmaken <int32, int32> * co Kleur van speld tekenreeks 000000 naar FFFFFF la Labelanker <int32, int32> * Lc Labelkleur tekenreeks 000000 naar FFFFFF ls Labelgrootte float Groter dan 0 ro Rotatie float -360 tot 360 Sc Schalen float Groter dan 0 X- en Y-coördinaten kunnen zich overal binnen de speldafbeelding of een marge eromheen bevindt. De margegrootte is het minimum van de breedte en hoogte van de speld.
tilesetId	query		TilesetId	Kaartstijl die moet worden geretourneerd. Mogelijke waarden zijn microsoft.base.road, microsoft.base.darkgrey en microsoft.imagery. De standaardwaarde is ingesteld op microsoft.base.road. Zie Render TilesetId voor meer informatie.
trafficLayer	query		TrafficTilesetId	Optionele waarde, waarmee wordt aangegeven dat er geen verkeersstroom op het resultaat van de afbeelding wordt weergegeven. Mogelijke waarden zijn microsoft.traffic.relative.main en none. De standaardwaarde is geen, wat aangeeft dat er geen verkeersstroom is geretourneerd. Als er verkeergerelateerde tilesetId wordt opgegeven, retourneert de kaartafbeelding met de bijbehorende verkeerslaag. Zie Render TilesetId voor meer informatie.
view	query		LocalizedMapView	Met de parameter Weergave (ook wel de parameter 'gebruikersregio' genoemd) kunt u de juiste kaarten weergeven voor een bepaald land of bepaalde regio voor geopolitieke betwiste regio's. Verschillende landen/regio's hebben verschillende weergaven van dergelijke regio's en met de parameter Weergave kan uw toepassing voldoen aan de weergave die vereist is voor het land/de regio die uw toepassing gaat bedienen. De parameter Weergave is standaard ingesteld op Unified, zelfs als u deze niet hebt gedefinieerd in de aanvraag. Het is uw verantwoordelijkheid om de locatie van uw gebruikers te bepalen en vervolgens de parameter Weergave correct in te stellen voor die locatie. U kunt ook 'View=Auto' instellen, waarmee de kaartgegevens worden geretourneerd op basis van het IP-adres van de aanvraag. De parameter Weergave in Azure Maps moet worden gebruikt in overeenstemming met de toepasselijke wetgeving, met inbegrip van die met betrekking tot toewijzing, van het land of de regio waar kaarten, afbeeldingen en andere gegevens en inhoud van derden beschikbaar worden gesteld waartoe u toegang hebt via Azure Maps. Voorbeeld: view=IN. Raadpleeg Ondersteunde weergaven voor meer informatie en om de beschikbare weergaven te bekijken.
width	query		integer int32	Breedte van de resulterende afbeelding in pixels. Bereik van 80 tot 2000. De standaardwaarde is 512. Het mag niet worden gebruikt met bbox.
zoom	query		integer int32	Gewenst zoomniveau van de kaart. Ondersteuning voor zoomwaardebereik van 0-20 (inclusief) voor tilesetId die microsoft.base.road of microsoft.base.darkgrey is. Ondersteuning voor zoomwaardebereik van 0-19 (inclusief) voor tilesetId die microsoft.imagery is. De standaardwaarde is 12. Zie Zoomniveaus en tegelraster voor meer informatie.

Aanvraagkoptekst

Name	Vereist	Type	Description
x-ms-client-id		string	Hiermee geeft u op welk account is bedoeld voor gebruik in combinatie met het Microsoft Entra ID-beveiligingsmodel. Het vertegenwoordigt een unieke id voor het Azure Maps-account en kan worden opgehaald uit de Azure Maps-beheervlak Account-API. Als u Microsoft Entra ID-beveiliging in Azure Maps wilt gebruiken, raadpleegt u de volgende artikelen voor hulp.
Accept		MediaType	Het veld Koptekst accepteren kan worden gebruikt om voorkeuren voor antwoordmediatypen op te geven. Toegestane mediatypen zijn afbeelding/jpeg en afbeelding/png. Retourneer afbeelding in afbeelding/png als koptekst Accepteren niet is opgegeven.

Antwoorden

Name	Type	Description
200 OK	object	Deze afbeelding wordt geretourneerd na een geslaagde aanroep Get Map Static Image. Media Types: "image/jpeg", "image/png" Kopteksten Content-Type: string
Other Status Codes	ErrorResponse	Er is een onverwachte fout opgetreden. Media Types: "image/jpeg", "image/png"

Beveiliging

AADToken

Dit zijn de Microsoft Entra OAuth 2.0-stromen . Wanneer het wordt gekoppeld met op rollen gebaseerd toegangsbeheer van Azure , kan het worden gebruikt om de toegang tot Azure Maps REST API's te beheren. Op rollen gebaseerd toegangsbeheer van Azure wordt gebruikt om toegang tot 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 verificatieconcepten te bekijken. Samengevat biedt deze beveiligingsdefinitie een oplossing voor het modelleren van toepassingen via objecten die toegangsbeheer kunnen hebben voor specifieke API's en bereiken.

Notities

• Voor deze beveiligingsdefinitie is het gebruik van de x-ms-client-id header vereist om aan te geven tot welke Azure Maps-resource de toepassing toegang aanvraagt. Dit kan worden verkregen via de Kaarten-beheer-API.

De Authorization URL is specifiek voor het azure-exemplaar van de openbare cloud. Onafhankelijke clouds hebben unieke autorisatie-URL's en Microsoft Entra ID-configuraties. * Op rollen gebaseerd 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 het mogelijk om een toepassing op basis van configuraties in te stellen voor meerdere gebruiksvoorbeelden.

• Zie Overzicht van Microsoft Identity Platform voor meer informatie over Microsoft Identity Platform.

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 ingericht bij het maken van een Azure Maps-resource via het Azure-beheervlak via Azure Portal, PowerShell, CLI, Azure SDK's 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 zijn uitgegeven.

Voor openbaar beschikbare toepassingen wordt aanbevolen om server-naar-servertoegang van Azure Maps REST API's te gebruiken, waar deze sleutel veilig kan worden opgeslagen.

Type: apiKey
In: header

SAS Token

Dit is een Shared Access Signature-token dat is gemaakt op basis van de SAS-bewerking List 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 om toegang te krijgen met op rollen gebaseerd toegangsbeheer van Azure en fijnmazige controle tot de vervaldatum, frequentie en gebruiksregio(s) voor het specifieke token. Met andere woorden, het SAS-token kan worden gebruikt om toepassingen in staat te stellen toegang op een veiligere manier te beheren dan de gedeelde sleutel.

Voor openbaar beschikbaar gemaakte toepassingen wordt aanbevolen om een specifieke lijst met toegestane origins te configureren voor de resource van het kaartaccount om misbruik van rendering te beperken en het SAS-token regelmatig te vernieuwen.

Type: apiKey
In: header

Voorbeelden

Successful Static Image Request

Voorbeeldaanvraag

HTTP

GET https://atlas.microsoft.com/map/static?api-version=2024-04-01&tilesetId=microsoft.base.road&zoom=10&center=-122.177621,47.613079

Voorbeeldrespons

Statuscode:

200

Content-Type: image/png

"{file}"

Definities

Name	Description
ErrorAdditionalInfo	Aanvullende informatie over de resourcebeheerfout.
ErrorDetail	De foutdetails.
ErrorResponse	Foutreactie
LocalizedMapView	Met de parameter Weergave (ook wel de parameter 'gebruikersregio' genoemd) kunt u de juiste kaarten weergeven voor een bepaald land of bepaalde regio voor geopolitieke betwiste regio's. Verschillende landen/regio's hebben verschillende weergaven van dergelijke regio's en met de parameter Weergave kan uw toepassing voldoen aan de weergave die vereist is voor het land/de regio die uw toepassing gaat bedienen. De parameter Weergave is standaard ingesteld op Unified, zelfs als u deze niet hebt gedefinieerd in de aanvraag. Het is uw verantwoordelijkheid om de locatie van uw gebruikers te bepalen en vervolgens de parameter Weergave correct in te stellen voor die locatie. U kunt ook 'View=Auto' instellen, waarmee de kaartgegevens worden geretourneerd op basis van het IP-adres van de aanvraag. De parameter Weergave in Azure Maps moet worden gebruikt in overeenstemming met de toepasselijke wetgeving, met inbegrip van die met betrekking tot toewijzing, van het land of de regio waar kaarten, afbeeldingen en andere gegevens en inhoud van derden beschikbaar worden gesteld waartoe u toegang hebt via Azure Maps. Voorbeeld: view=IN. Raadpleeg Ondersteunde weergaven voor meer informatie en om de beschikbare weergaven te bekijken.
MediaType	Het veld Koptekst accepteren kan worden gebruikt om voorkeuren voor antwoordmediatypen op te geven. Toegestane mediatypen zijn afbeelding/jpeg en afbeelding/png. Retourneer afbeelding in afbeelding/png als koptekst Accepteren niet is opgegeven.
TilesetId	Kaartstijl die moet worden geretourneerd. Mogelijke waarden zijn microsoft.base.road, microsoft.base.darkgrey en microsoft.imagery. De standaardwaarde is ingesteld op microsoft.base.road. Zie Render TilesetId voor meer informatie.
TrafficTilesetId	Optionele waarde, waarmee wordt aangegeven dat er geen verkeersstroom op het resultaat van de afbeelding wordt weergegeven. Mogelijke waarden zijn microsoft.traffic.relative.main en none. De standaardwaarde is geen, wat aangeeft dat er geen verkeersstroom is geretourneerd. Als er verkeergerelateerde tilesetId wordt opgegeven, retourneert de kaartafbeelding met de bijbehorende verkeerslaag. Zie Render TilesetId voor meer informatie.

ErrorAdditionalInfo

Aanvullende informatie over de resourcebeheerfout.

Name	Type	Description
info	object	De aanvullende informatie.
type	string	Het type aanvullende informatie.

ErrorDetail

De foutdetails.

Name	Type	Description
additionalInfo	ErrorAdditionalInfo[]	Aanvullende informatie over de fout.
code	string	De foutcode.
details	ErrorDetail[]	De foutdetails.
message	string	Het foutbericht.
target	string	Het foutdoel.

ErrorResponse

Foutreactie

Name	Type	Description
error	ErrorDetail	Het foutobject.

LocalizedMapView

Met de parameter Weergave (ook wel de parameter 'gebruikersregio' genoemd) kunt u de juiste kaarten weergeven voor een bepaald land of bepaalde regio voor geopolitieke betwiste regio's. Verschillende landen/regio's hebben verschillende weergaven van dergelijke regio's en met de parameter Weergave kan uw toepassing voldoen aan de weergave die vereist is voor het land/de regio die uw toepassing gaat bedienen. De parameter Weergave is standaard ingesteld op Unified, zelfs als u deze niet hebt gedefinieerd in de aanvraag. Het is uw verantwoordelijkheid om de locatie van uw gebruikers te bepalen en vervolgens de parameter Weergave correct in te stellen voor die locatie. U kunt ook 'View=Auto' instellen, waarmee de kaartgegevens worden geretourneerd op basis van het IP-adres van de aanvraag. De parameter Weergave in Azure Maps moet worden gebruikt in overeenstemming met de toepasselijke wetgeving, met inbegrip van die met betrekking tot toewijzing, van het land of de regio waar kaarten, afbeeldingen en andere gegevens en inhoud van derden beschikbaar worden gesteld waartoe u toegang hebt via Azure Maps. Voorbeeld: view=IN.

Raadpleeg Ondersteunde weergaven voor meer informatie en om de beschikbare weergaven te bekijken.

Name	Type	Description
AE	string	Verenigde Arabische Emiraten (Arabische weergave)
AR	string	Argentinië (Argentijnse weergave)
Auto	string	Retourneer de kaartgegevens op basis van het IP-adres van de aanvraag.
BH	string	Bahrein (Arabische weergave)
IN	string	India (Indiase weergave)
IQ	string	Irak (Arabische weergave)
JO	string	Jordanië (Arabische weergave)
KW	string	Koeweit (Arabische weergave)
LB	string	Libanon (Arabische weergave)
MA	string	Marokko (Marokkaanse weergave)
OM	string	Oman (Arabische weergave)
PK	string	Pakistan (Pakistaanse weergave)
PS	string	Palestijnse Autoriteit (Arabische weergave)
QA	string	Qatar (Arabische weergave)
SA	string	Saoedi-Arabië (Arabische weergave)
SY	string	Syrië (Arabische weergave)
Unified	string	Geïntegreerde weergave (overige)
YE	string	Jemen (Arabische weergave)

MediaType

Het veld Koptekst accepteren kan worden gebruikt om voorkeuren voor antwoordmediatypen op te geven. Toegestane mediatypen zijn afbeelding/jpeg en afbeelding/png. Retourneer afbeelding in afbeelding/png als koptekst Accepteren niet is opgegeven.

Name	Type	Description
image/jpeg	string	Retourneer afbeelding in jpeg-indeling.
image/png	string	Retourneer de afbeelding in png-indeling.

TilesetId

Kaartstijl die moet worden geretourneerd. Mogelijke waarden zijn microsoft.base.road, microsoft.base.darkgrey en microsoft.imagery. De standaardwaarde is ingesteld op microsoft.base.road. Zie Render TilesetId voor meer informatie.

Name	Type	Description
microsoft.base.darkgrey	string	TilesetId bevat alle lagen met onze donkergrijze stijl.
microsoft.base.road	string	TilesetId bevat alle lagen met de hoofdstijl rendering.
microsoft.imagery	string	TilesetId bevat een combinatie van satelliet- en luchtfoto's.

TrafficTilesetId

Optionele waarde, waarmee wordt aangegeven dat er geen verkeersstroom op het resultaat van de afbeelding wordt weergegeven. Mogelijke waarden zijn microsoft.traffic.relative.main en none. De standaardwaarde is geen, wat aangeeft dat er geen verkeersstroom is geretourneerd. Als er verkeergerelateerde tilesetId wordt opgegeven, retourneert de kaartafbeelding met de bijbehorende verkeerslaag. Zie Render TilesetId voor meer informatie.

Name	Type	Description
microsoft.traffic.relative.main	string	Ondersteunde verkeersgerelateerde tegelsetId.
none	string	Standaardwaarde, geen verkeersstroomoverlay.