Render - Get Map Static Image

string

Versienummer van Azure Maps-API. Huidige versie is 2024-04-01.

number[]

Een begrenzingsvak wordt gedefinieerd door twee breedtegraden en twee lengtegraden die de vier zijden van een rechthoekig gebied op de aarde vertegenwoordigen. Notatie: 'minLon, minLat, maxLon, maxLat' (in dubbel).

Opmerking: bbox of center zijn vereiste parameters. Ze sluiten elkaar wederzijds uit. bbox mag niet worden gebruikt met hoogte of breedte.

De maximaal toegestane bereiken voor Lat en Lon worden gedefinieerd voor elk zoomniveau in de tabel boven aan deze pagina.

number[]

Coördinaten van het middelpunt in dubbel. Indeling: 'lon,lat'. Lengtegraadsbereik: -180 tot 180. Breedtegraad: -90 tot 90.

Opmerking: Center of bbox zijn vereiste parameters. Ze sluiten elkaar wederzijds uit.

integer (int32)

Hoogte van de resulterende afbeelding in pixels. Varieer van 80 tot 1500. De standaardwaarde is 512. Het mag niet worden gebruikt met bbox.

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.

string[]

Padstijl en -locaties (in dubbel). Gebruik deze parameter om eventueel lijnen, veelhoeken of cirkels toe te voegen aan de afbeelding. In de padstijl wordt het uiterlijk van de lijn en opvulling beschreven. (Zorg ervoor dat u waarden voor URL-codering van deze parameter correct codeert, omdat deze gereserveerde tekens bevat, zoals pipes en interpunctie.)

Padparameter wordt ondersteund in azure Maps-account-SKU die begint 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 met straal van 100 meter en middelpunt op breedtegraad 45°N en lengtegraad 122°W wilt weergeven 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. Nadat de URL is gecodeerd, ziet dit er ongeveer als volgt uit

path=ra100%7C%7C-122+45

In alle voorbeelden hier ziet u de padparameter zonder URL-codering, voor de duidelijkheid.

Als u een regel 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 de eerste en laatste punten gelijk zijn. Gebruik bijvoorbeeld

path=||-122 45|-119.5 43.2|-121.67 47.12|-122 45

De lengtegraad voor locaties van lijnen en veelhoeken kan zich in het bereik van -360 tot 360 bevinden om het weergeven van geometrieën die de anti-idiaan kruisen mogelijk te maken.

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 stijlaanpassing 'lc' en geeft u de kleur op met behulp van de HTML-/CSS RGB-kleurindeling. Dit is een hexadecimaal getal van zes cijfers (het formulier met drie cijfers wordt niet ondersteund). Als u bijvoorbeeld een diep roze kleur wilt gebruiken die u zou opgeven als #FF1493 in CSS, gebruikt u

path=lcFF1493||-122 45|-119.5 43.2

Er kunnen meerdere stijlaanpassingen worden gecombineerd om een complexere visuele stijl te maken.

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

string[]

Punaisestijl en exemplaren. Gebruik deze parameter om optioneel punaises aan de afbeelding toe te voegen. De punaisestijl beschrijft het uiterlijk van de punaises en de exemplaren geven de coördinaten van de punaises (in dubbel) en optionele labels voor elke pin op. (Zorg ervoor dat u waarden voor URL-codering van deze parameter correct codeert, omdat deze gereserveerde tekens bevat, zoals pipes en interpunctie.)

De S0-SKU van het Azure Maps-account ondersteunt slechts één exemplaar van de pincodeparameter en het aantal locaties is beperkt tot 5 per pincode. Met andere SKU's kunnen maximaal 25 exemplaren van de pincodeparameter meerdere speldstijlen worden opgegeven en is het aantal locaties beperkt tot 50 per speld.

Als u een punaise op breedtegraad 45°N en lengtegraad 122°W wilt weergeven met behulp van de standaard ingebouwde punaisestijl, voegt u de querytekenreeksparameter toe

pins=default||-122 45

Houd er rekening mee dat de lengtegraad vóór de breedtegraad komt. Nadat de URL is gecodeerd, ziet dit er ongeveer als volgt uit

pins=default%7C%7C-122+45

In alle voorbeelden hier ziet u de parameter pinnen zonder URL-codering, voor de duidelijkheid.

Als u een speld op meerdere locaties wilt weergeven, scheidt u elke locatie met een pijpteken. 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 stijlaanpassing 'co' en geeft u de kleur op met behulp van de HTML-/CSS RGB-kleurindeling. Dit is een hexadecimaal getal van zes cijfers (het formulier met drie cijfers wordt niet ondersteund). Als u bijvoorbeeld een diep roze kleur wilt gebruiken die u zou opgeven als #FF1493 in CSS, gebruikt u

pins=default|coFF1493||-122 45

Punaiselabels

Als u een label wilt toevoegen aan de spelden, plaatst u het label tussen enkele aanhalingstekens vlak voor de coördinaten. Vermijd het gebruik van speciale tekens, 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 genaamd 'none' die geen punaiseafbeelding weergeeft. U kunt dit gebruiken als u labels wilt weergeven zonder een speldafbeelding. Bijvoorbeeld

pins=none||'A'-122 45|'B'-119.5 43.2

Als u de kleur van de punaiselabels wilt wijzigen, gebruikt u de labelkleurstijlaanpassing. Als u bijvoorbeeld roze punaises met zwarte etiketten wilt gebruiken, gebruikt u

pins=default|coFF1493|lc000000||-122 45

Als u de grootte van de labels wilt wijzigen, gebruikt u de stijlaanpassing voor de labelgrootte 'ls'. De labelgrootte vertegenwoordigt de geschatte hoogte van de labeltekst in pixels. Als u bijvoorbeeld de labelgrootte wilt vergroten 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 bovenaan het midden van aangepaste punaises (zie hieronder). Als u het labelanker wilt overschrijven, gebruikt u de stijlaanpassing 'la' en geeft u X- en Y-pixelcoördinaten voor het anker op. 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 omlaag. Als u bijvoorbeeld het labelanker van 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 speldstijl 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 pipe-tekens om aan te geven dat u klaar bent met het opgeven van locaties en de URL start. Bijvoorbeeld

pins=custom||-122 45||http://contoso.com/pushpins/red.png

Na url-codering ziet dit er ongeveer als volgt uit

pins=custom%7C%7C-122+45%7C%7Chttp%3A%2F%2Fcontoso.com%2Fpushpins%2Fred.png

Aangepaste punaiseafbeeldingen worden standaard gecentreerd op de pincoördinaten. Dit is meestal niet ideaal omdat de locatie die u probeert te markeren, wordt verborgen. Als u de ankerlocatie van de vastgemaakte afbeelding wilt overschrijven, gebruikt u de stijlaanpassing 'an'. Hierbij wordt dezelfde indeling gebruikt als de wijzigingswijze van de labelanker. Als uw aangepaste pincodeafbeelding 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 (ondoorzichtig) ongewijzigd. Dit zou meestal alleen worden gedaan met een aangepaste afbeelding met een effen kleur.

Schaal, draaiing en dekking

U kunt punaises en de bijbehorende labels groter of kleiner maken met behulp van de modifier voor 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 50% groter dan normaal wilt tekenen, 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 draaiing met de klok mee. Gebruik een negatief getal om linksom te draaien. Als u bijvoorbeeld de punaises 90 graden rechtsom wilt draaien en hun grootte wilt verdubbelen, gebruikt u

pins=default|ro90|sc2||-122 45

U kunt punaises en hun labels gedeeltelijk transparant maken door de 'al' alfastijlaanpassing op te geven. Dit is een getal tussen 0 en 1 dat de dekking van de punaises aangeeft. Zero maakt ze volledig transparant (en niet zichtbaar) en 1 maakt ze volledig ondoorzichtig (wat de standaardinstelling is). Als u bijvoorbeeld punaises en hun labels slechts 67% ondoorzichtig wilt maken, gebruikt u

pins=default|al.67||-122 45

Samenvatting van stijlaanpassing

• X- en Y-coördinaten kunnen zich overal in een speldafbeelding of marge eromheen bevindt. De margegrootte is het minimum van de breedte en hoogte van de speld.

TilesetId

De 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 TegelsetId weergevenvoor meer informatie.

TrafficTilesetId

Optionele waarde, die aangeeft dat er geen verkeersstroom over het resultaat van de afbeelding wordt weergegeven. Mogelijke waarden zijn microsoft.traffic.relative.main en geen. De standaardwaarde is geen, wat aangeeft dat er geen verkeersstroom wordt geretourneerd. Als verkeer gerelateerde tegelsetId is opgegeven, retourneert u een kaartafbeelding met de bijbehorende verkeerslaag. Zie TegelsetId weergevenvoor meer informatie.

LocalizedMapView

Met de parameter Weergave (ook wel de parameter 'gebruikersregio' genoemd) kunt u de juiste kaarten weergeven voor een bepaald land/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 levert. Standaard is de weergaveparameter 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 View in Azure Maps moet worden gebruikt in overeenstemming met toepasselijke wetten, waaronder die met betrekking tot toewijzing, van het land/de regio waar kaarten, afbeeldingen en andere gegevens en inhoud van derden die u gemachtigd bent om toegang te krijgen via Azure Maps beschikbaar worden gesteld. Voorbeeld: view=IN.

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

integer (int32)

Breedte van de resulterende afbeelding in pixels. Varieer van 80 tot 2000. De standaardwaarde is 512. Het mag niet worden gebruikt met bbox.

integer (int32)

Gewenst zoomniveau van de kaart. Ondersteuning voor zoomwaardebereik van 0-20 (inclusief) voor tilesetId als microsoft.base.road of microsoft.base.darkgrey. Ondersteuning voor zoomwaardebereik van 0-19 (inclusief) voor tilesetId als microsoft.imagery. De standaardwaarde is 12.

Zie zoomniveaus en tegelrastervoor meer informatie.