Render - Get Map Image

Service:

Maps

API-versie:

1.0

Gebruik deze indeling om een door de gebruiker gedefinieerde, rechthoekige afbeelding weer te geven met een kaartsectie met een zoomniveau tussen 0 en 20.

Notitie

buitengebruikstelling van Azure Maps Render v1-service

De Azure Maps Render v1-service is nu afgeschaft en wordt op 17-9-26 buiten gebruik gesteld. Om serviceonderbrekingen te voorkomen, moeten alle aanroepen van de Render v1-API worden bijgewerkt om render v2 API te gebruiken voor 17-9-26.

Het ondersteunde resolutiebereik voor de kaartafbeelding is van 1x1 tot 8192x8192. Als u besluit wanneer u de statische afbeeldingsservice wilt gebruiken in plaats van de kaarttegelservice, kunt u overwegen hoe u wilt communiceren met de weergegeven kaart. Als de inhoud van de kaart relatief ongewijzigd blijft, is een statische kaart een goede keuze. Als u veel zoomen, pannen en wijzigen van de kaartinhoud wilt ondersteunen, is de kaarttegelservice een betere keuze.

Service biedt ook image composition-functionaliteit om een statische afbeelding terug te krijgen met aanvullende gegevens, zoals; punaises en geometrie-overlays met de volgende Gen1 S0-, S1- en Gen2-mogelijkheden.

In Gen1 S0 kunt u het volgende doen:

• Maximaal 5 punaises weergeven die in de aanvraag zijn opgegeven
• Geef één aangepaste afbeelding op voor de pinnen waarnaar wordt verwezen in de aanvraag
• Labels toevoegen aan de punaises

In Gen1 S1 en Gen2 kunt u het volgende doen:

• Pushpins weergeven via Azure Maps Data Service
• Meerdere punaisestijlen opgeven
• Typen cirkel-, polylijn- en veelhoekgeometrie weergeven.
• Weergave van ondersteunde GeoJSON-geometrietypen die zijn geüpload via Azure Maps Data Service

Zie de handleiding Aangepaste gegevens weergeven op een rasterkaart voor gedetailleerde voorbeelden.

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

De ondersteunde Lat- en Lon-bereiken bij gebruik van de parameter bbox zijn als volgt:

Zoomniveau	Max Lon-bereik	Maximaal latbereik
0	360.0	170.0
1	360.0	170.0
2	360.0	170.0
3	360.0	170.0
4	360.0	170.0
5	180.0	85,0
6	90.0	42.5
7	45.0	21,25
8	22.5	10.625
9	11.25	5.3125
10	5.625	2.62625
11	2.8125	1.328125
12	1.40625	0.6640625
13	0.703125	0.33203125
14	0.3515625	0.166015625
15	0.17578125	0.0830078125
16	0.087890625	0.0415039063
17	0.0439453125	0.0207519531
18	0.0219726563	0.0103759766
19	0.0109863281	0.0051879883
20	0.0054931641	0.0025939941

GET https://atlas.microsoft.com/map/static/png?api-version=1.0

Met optionele parameters:

GET https://atlas.microsoft.com/map/static/png?api-version=1.0&layer={layer}&style={style}&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
format	path	True	RasterTileFormat	Gewenste indeling van het antwoord. Mogelijke waarde: png.
api-version	query	True	string	Versienummer van Azure Maps API.
bbox	query		number[]	Selectiekader. Gebruikte projectie - EPSG:3857. Indeling: 'minLon, minLat, maxLon, maxLat'. Opmerking: bbox of center zijn vereiste parameters. Ze sluiten elkaar uit. Het mag niet worden gebruikt met hoogte of breedte. De maximaal toegestane bereiken voor Lat en Lon worden gedefinieerd voor elk zoomniveau in de tabel bovenaan deze pagina.
center	query		number[]	Coördinaten van het middelpunt. Indeling: 'lon,lat'. Gebruikte projectie EPSG:3857. Lengtegraadbereik: -180 tot 180. Breedtebereik: -85 tot 85. Opmerking: center of bbox zijn vereiste parameters. Ze sluiten elkaar uit.
height	query		integer int32	Hoogte van de resulterende afbeelding in pixels. Het bereik is 1 tot en met 8192. 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.
layer	query		StaticMapLayer	Toewijzingslaag aangevraagd. Als laag is ingesteld op labels of hybride, moet de indeling png zijn.
path	query		string[]	Padstijl en locaties. 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 Azure Maps account-SKU vanaf 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 Als u een veelhoek wilt weergeven, moet de laatste locatie gelijk zijn aan de beginlocatie. Gebruik bijvoorbeeld path=||-122 45|-119.5 43.2|-121.67 47.12|-122 45 Lengte- en breedtegraadwaarden voor locaties van lijnen en veelhoeken kunnen tussen -360 en 360 liggen 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 Padlocaties ophalen uit Azure Maps Data Storage Voor alle andere Azure Maps account-SKU's dan S0 kunt u de locatiegegevens van het pad ophalen uit Azure Maps Data Storage. Na het uploaden van een GeoJSON-document met padlocaties, retourneert de Data Storage-service een unieke gegevens-id (UDID) die u kunt gebruiken om te verwijzen naar de gegevens in de padparameter. Als u de puntgeometrie uit een geüpload GeoJSON-document wilt gebruiken als padlocaties, geeft u de UDID op in de sectie locaties van de padparameter. Bijvoorbeeld: path=||udid-29dc105a-dee7-409f-a3f9-22b066ae4713 Houd er rekening mee dat het niet is toegestaan om padlocaties van Gegevensopslag te combineren met locaties die zijn opgegeven in de padparameter. Samenvatting van stijlaanpassing Modifier Description Bereik Lc Lijnkleur 000000 naar FFFFFF Fc Opvulkleur 000000 naar FFFFFF La Lijn alfa (matheid) 0 tot 1 fa Vul alfa (matheid) 0 tot 1 Lw Lijnbreedte Groter dan 0 Ra Cirkelstraal (meters) Groter dan 0
pins	query		string[]	Punaisestijl en -exemplaren. Gebruik deze parameter om optioneel 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 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 Azure Maps account S0 SKU ondersteunt slechts één exemplaar van de parameter pins. Andere SKU's staan meerdere exemplaren van de parameter pins toe om meerdere pincodestijlen op te geven. 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 querystring 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 In alle voorbeelden hier ziet u 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 spelden 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 RGB-kleurindeling HTML/CSS. Dit is een zescijferig hexadecimaal getal (de driecijferige vorm wordt niet ondersteund). Als u bijvoorbeeld een dieproze 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. 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 pincodeafbeelding. 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 stijl '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 het labelanker bijvoorbeeld 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. Gebruik twee pipe-tekens om aan te geven dat u klaar bent met het opgeven van locaties en dat u de URL start. 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 wijziging van de labelankerstijl 'la'. Als uw aangepaste pinafbeelding 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 kleuraanpassing 'co' 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. Punaises ophalen uit Azure Maps Data Storage Voor alle Azure Maps account-SKU's, met uitzondering van S0, kan de locatie-informatie over de punaise worden verkregen van Azure Maps Data Storage. Na het uploaden van een GeoJSON-document met pinlocaties, retourneert de Data Storage-service een unieke gegevens-id (UDID) die u kunt gebruiken om te verwijzen naar de gegevens in de parameter pins. Als u de puntgeometrie uit een geüpload GeoJSON-document wilt gebruiken als de pinlocaties, geeft u de UDID op in de sectie locaties van de parameter pins. Bijvoorbeeld: pins=default||udid-29dc105a-dee7-409f-a3f9-22b066ae4713 Houd er rekening mee dat alleen punt- en multipuntgeometrie, punten en multipunten uit geometrieverzamelingen en puntgeometrie van functies worden gebruikt. De geometrie van lijnen en veelhoeken wordt genegeerd. Als het punt afkomstig is van een functie en de functie een tekenreekseigenschap heeft met de naam 'label', wordt de waarde van die eigenschap gebruikt als het label voor de pincode. U kunt pinlocaties uit Gegevensopslag combineren met vastgemaakte locaties die zijn opgegeven in de parameter pins. Een van de door pijpen gescheiden pinlocaties kan een lengtegraad en breedtegraad of een UDID zijn. Bijvoorbeeld: pins=default||-122 45|udid-29dc105a-dee7-409f-a3f9-22b066ae4713|-119 43 Schaal, draaiing en matheid U kunt punaises en hun labels groter of kleiner maken met behulp van de aanpassingsfunctie voor de schaalstijl 'sc'. Dit is een waarde die groter is dan nul. Een waarde van 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 de bijbehorende labels draaien met behulp van de wijzigingsstijl ro. Dit is een aantal graden van rechtsom draaien. Gebruik een negatief getal om linksom te draaien. Als u de punaises bijvoorbeeld 90 graden met de klok mee 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 ondoorzichtigheid 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 hun etiketten slechts 67% ondoorzichtig wilt maken, gebruikt u pins=default|al.67||-122 45 Samenvatting van stijlaanpassing Modifier Description Bereik Al Alfa (ondoorzichtigheid) 0 tot 1 an Anker vastmaken * co Speldkleur 000000 naar FFFFFF La Labelanker * Lc Labelkleur 000000 naar FFFFFF ls Labelgrootte Groter dan 0 ro Rotatie -360 tot 360 Sc Schalen 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.
style	query		MapImageStyle	Kaartstijl die moet worden geretourneerd. Mogelijke waarden zijn main en dark.
view	query		LocalizedMapView	Met de parameter View (ook wel de parameter 'gebruikersregio' genoemd) kunt u de juiste kaarten voor een bepaald land/regio weergeven voor geopolitiek betwiste regio's. Verschillende landen/regio's hebben verschillende weergaven van dergelijke regio's en met de weergaveparameter kan uw toepassing voldoen aan de weergave die is vereist voor het land/de regio die uw toepassing gaat bedienen. De parameter View 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 weergaveparameter 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 View 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 waartoe u toegang hebt via Azure Maps beschikbaar wordt gesteld. 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. Het bereik is 1 tot en met 8192. De standaardwaarde is 512. Het mag niet worden gebruikt met bbox.
zoom	query		integer int32	Gewenst zoomniveau van de kaart. De zoomwaarde moet binnen het bereik liggen: 0-20 (inclusief). 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 wilt gebruiken in Azure Maps raadpleegt u de volgende artikelen voor hulp.

Antwoorden

Name	Type	Description
200 OK	object	Deze afbeelding wordt geretourneerd na een geslaagde aanroep Voor kaart statische afbeelding ophalen Media Types: "application/json", "image/jpeg", "image/png", "image/pbf", "application/vnd.mapbox-vector-tile" Kopteksten Content-Type: string
Other Status Codes	ErrorResponse	Er is een onverwachte fout opgetreden. Media Types: "application/json", "image/jpeg", "image/png", "image/pbf", "application/vnd.mapbox-vector-tile"

Beveiliging

AADToken

Dit zijn de Microsoft Entra OAuth 2.0-stromen. Wanneer het is gekoppeld aan 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 resourceaccount 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 configuratie van een toepassing mogelijk 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 wanneer u een Azure Maps-account maakt in de 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 zijn uitgegeven.

Voor openbaar beschikbare toepassingen wordt aanbevolen om de benadering van vertrouwelijke clienttoepassingen te gebruiken voor toegang tot Azure Maps REST API's, zodat uw sleutel veilig kan worden opgeslagen.

Type: apiKey
In: query

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/png?api-version=1.0&layer=basic&style=main&zoom=2&bbox=1.355233,42.982261,24.980233,56.526017

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 waartoe u toegang hebt via Azure Maps beschikbaar wordt gesteld. Voorbeeld: view=IN. Raadpleeg Ondersteunde weergaven voor meer informatie en om de beschikbare weergaven te bekijken.
MapImageStyle	Kaartstijl die moet worden geretourneerd. Mogelijke waarden zijn main en dark.
RasterTileFormat	Gewenste indeling van het antwoord. Mogelijke waarde: png.
StaticMapLayer	Toewijzingslaag aangevraagd. Als laag is ingesteld op labels of hybride, moet de indeling png zijn.

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 waartoe u toegang hebt via Azure Maps beschikbaar wordt gesteld. 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)

MapImageStyle

Kaartstijl die moet worden geretourneerd. Mogelijke waarden zijn main en dark.

Name	Type	Description
dark	string	Donkergrijze versie van de Azure Maps hoofdstijl
main	string	Azure Maps hoofdstijl

RasterTileFormat

Gewenste indeling van het antwoord. Mogelijke waarde: png.

Name	Type	Description
png	string	Een afbeelding in de png-indeling. Ondersteunt zoomniveaus 0 tot en met 18.

StaticMapLayer

Toewijzingslaag aangevraagd. Als laag is ingesteld op labels of hybride, moet de indeling png zijn.

Name	Type	Description
basic	string	Retourneert een afbeelding met alle kaartfuncties, waaronder veelhoeken, randen, wegen en labels.
hybrid	string	Retourneert een afbeelding met randen, wegen en labels en kan worden bedekt op andere tegels (zoals satellietbeelden) om hybride tegels te produceren.
labels	string	Retourneert een afbeelding van alleen de labelgegevens van de kaart.