Render - Get Map Static Image

string

Versionsnummer för Azure Maps API. Aktuell version är 2024-04-01.

number[]

En avgränsningsruta definieras av två latituder och två longituder som representerar de fyra sidorna av ett rektangulärt område på jorden. Format: "minLon, minLat, maxLon, maxLat" (i dubbel).

Obs! Antingen bbox eller center krävs parametrar. De utesluter varandra. bbox ska inte användas med höjd eller bredd.

De högsta och minsta tillåtna intervallen för Lat och Lon definieras för varje zoomnivå i tabellen överst på den här sidan.

number[]

Koordinater för mittpunkten i dubbel. Format: 'lon,lat'. Longitudintervall: -180 till 180. Latitudintervall: -90 till 90.

Obs! Antingen center eller bbox krävs parametrar. De utesluter varandra.

integer (int32)

Höjden på den resulterande bilden i bildpunkter. Mellan 80 och 1 500. Standardvärdet är 512. Det bör inte användas med bbox.

string

Språk där sökresultat ska returneras. Bör vara en av IETF-språktaggar som stöds, skiftlägesokänsliga. När data på angivet språk inte är tillgängliga för ett visst fält används standardspråket.

Mer information finns i språk som stöds.

string[]

Sökvägsformat och platser (i dubbel). Använd den här parametern om du vill lägga till linjer, polygoner eller cirklar i bilden. Sökvägsformatet beskriver utseendet på raden och fyllningen. (Se till att url-koda värden för den här parametern korrekt eftersom den innehåller reserverade tecken som rör och skiljetecken.)

Sökvägsparametern stöds i Azure Maps-kontots SKU från och med S1. Flera instanser av sökvägsparametern gör det möjligt att ange flera geometrier med sina format. Antalet parametrar per begäran är begränsat till 10 och antalet platser är begränsat till 100 per sökväg.

Om du vill återge en cirkel med radie 100 meter och mittpunkt vid latitud 45°N och longitud 122°W med standardformatet lägger du till parametern querystring

path=ra100||-122 45

Observera att longitud kommer före latitud. Efter URL-kodning kommer detta att se ut som

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

Alla exempel här visar sökvägsparametern utan URL-kodning, för tydlighetens skull.

Om du vill återge en rad separerar du varje plats med ett pipe-tecken. Använd till exempel

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

En polygon anges med en stängd sökväg, där de första och sista punkterna är lika. Använd till exempel

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

Longitudvärdet för platser för linjer och polygoner kan ligga i intervallet från -360 till 360 för att möjliggöra återgivning av geometrier som korsar anti-meridianen.

Formatmodifierare

Du kan ändra sökvägens utseende genom att lägga till formatmodifierare. Dessa läggs till före platserna. Formatmodifierare har vart och ett ett tvåbokstavsnamn. Dessa förkortade namn används för att minska längden på URL:en.

Om du vill ändra färg på konturen använder du formatmodifieraren "lc" och anger färgen med färgformatet HTML/CSS RGB som är ett sexsiffrigt hexadecimalt tal (tresiffrigt formulär stöds inte). Om du till exempel vill använda en djuprosa färg som du anger som #FF1493 i CSS använder du

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

Flera formatmodifierare kan kombineras för att skapa ett mer komplext visuellt format.

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

Sammanfattning av formatmodifierare

string[]

Pushpin-format och instanser. Använd den här parametern om du vill lägga till pushpins i avbildningen. Pushpin-stilen beskriver utseendet på pushpins och instanserna anger koordinaterna för pushpins (i dubbel) och valfria etiketter för varje stift. (Se till att url-koda värden för den här parametern korrekt eftersom den innehåller reserverade tecken som rör och skiljetecken.)

Azure Maps-kontots S0 SKU stöder endast en enda instans av pin-parametern och antalet platser är begränsat till 5 per pin-kod. Andra SKU:er tillåter att upp till 25 instanser av pins-parametern anger flera pin-format och antalet platser är begränsat till 50 per stift.

Om du vill återge en pushpin på latitud 45°N och longitud 122°W med den inbyggda standardstilen för pushpin lägger du till parametern querystring

pins=default||-122 45

Observera att longitud kommer före latitud. Efter URL-kodning kommer detta att se ut som

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

Alla exempel här visar pins-parametern utan URL-kodning, för tydlighetens skull.

Om du vill rendera en pin-kod på flera platser separerar du varje plats med ett pipe-tecken. Använd till exempel

pins=default||-122 45|-119.5 43.2|-121.67 47.12

S0 Azure Maps-kontots SKU tillåter bara fem pushpins. Andra konto-SKU:er har inte den här begränsningen.

Formatmodifierare

Du kan ändra utseendet på stiften genom att lägga till formatmodifierare. Dessa läggs till efter formatet men före platserna och etiketterna. Formatmodifierare har vart och ett ett tvåbokstavsnamn. Dessa förkortade namn används för att minska längden på URL:en.

Om du vill ändra färg på pushpinn använder du "co"-formatmodifieraren och anger färgen med hjälp av HTML/CSS RGB-färgformatet som är ett sexsiffrigt hexadecimalt tal (det tresiffriga formuläret stöds inte). Om du till exempel vill använda en djuprosa färg som du anger som #FF1493 i CSS använder du

pins=default|coFF1493||-122 45

Pushpin-etiketter

Om du vill lägga till en etikett i stiften placerar du etiketten inom enkla citattecken precis före koordinaterna. Undvik att använda specialtecken som | eller || i etiketten. Om du till exempel vill märka tre stift med värdena "1", "2" och "3" använder du

pins=default||'1'-122 45|'2'-119.5 43.2|'3'-121.67 47.12

Det finns en inbyggd pushpin-stil med namnet "none" som inte visar en pushpin-bild. Du kan använda detta om du vill visa etiketter utan någon fästbild. Ett exempel:

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

Om du vill ändra färg på pushpin-etiketterna använder du "lc"-etikettfärgformatmodifieraren. Om du till exempel vill använda rosa pushpins med svarta etiketter använder du

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

Om du vill ändra storleken på etiketterna använder du formatmallen "ls" för etikettstorlek. Etikettstorleken representerar den ungefärliga höjden på etiketttexten i bildpunkter. Om du till exempel vill öka etikettstorleken till 12 använder du

pins=default|ls12||'A'-122 45|'B'-119 43

Etiketterna centreras vid pushpin-fästpunkten "etikettankare". Fästpunktsplatsen är fördefinierad för inbyggda pushpins och ligger längst upp i mitten av anpassade pushpins (se nedan). Om du vill åsidosätta etikettankaret använder du "la"-formatmodifieraren och anger X- och Y-pixelkoordinater för fästpunkten. Dessa koordinater är relativa till det övre vänstra hörnet i pushpin-bilden. Positiva X-värden flyttar fästpunkten åt höger och positiva Y-värden flyttar ned fästpunkten. Om du till exempel vill placera etikettens fästpunkt 10 bildpunkter åt höger och 4 bildpunkter ovanför det övre vänstra hörnet i pushpin-bilden använder du

pins=default|la10 -4||'A'-122 45|'B'-119 43

Anpassade pushpins

Om du vill använda en anpassad pushpin-bild använder du ordet "anpassad" som pin-formatmallsnamn och anger sedan en URL efter plats- och etikettinformationen. Den maximala tillåtna storleken för en anpassad etikettbild är 65 536 bildpunkter. Använd två pipe-tecken för att ange att du är klar med att ange platser och startar URL:en. Ett exempel:

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

Efter URL-kodning skulle detta se ut som

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

Som standard ritas anpassade pushpin-bilder centrerad på stiftkoordinaterna. Detta är vanligtvis inte idealiskt eftersom det döljer den plats som du försöker markera. Om du vill åsidosätta fästpunktsbildens fästpunkt använder du modifieraren "an". Detta använder samma format som "la" etikett fästpunkt stil modifierare. Om din anpassade pin-bild till exempel har stiftspetsen i det övre vänstra hörnet av bilden kan du ställa in fästpunkten på den platsen med hjälp av

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

Obs! Om du använder färgmodifieraren "co" med en anpassad pushpinbild ersätter den angivna färgen RGB-kanalerna för bildpunkterna i bilden, men lämnar alfakanalen (opacitet) oförändrad. Detta görs vanligtvis bara med en anpassad bild med en solid färg.

Skala, rotera och ogenomskinlighet

Du kan göra pushpins och deras etiketter större eller mindre med hjälp av skalningsformatmodifieraren "sc". Det här är ett värde som är större än noll. Värdet 1 är standardskalan. Värden som är större än 1 gör stiften större och värden som är mindre än 1 gör dem mindre. Om du till exempel vill rita pushpins 50% större än normalt använder du

pins=default|sc1.5||-122 45

Du kan rotera pushpins och deras etiketter med hjälp av rotationsformatmodifieraren "ro". Det här är ett antal grader av rotation medsols. Använd ett negativt tal för att rotera motsols. Om du till exempel vill rotera pushpins 90 grader medsols och dubbla storleken använder du

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

Du kan göra pushpins och deras etiketter delvis transparenta genom att ange "al"-alfaformatmodifieraren. Det här är ett tal mellan 0 och 1 som anger pushpins opacitet. Noll gör dem helt transparenta (och inte synliga) och 1 gör dem helt ogenomskinliga (vilket är standard). Om du till exempel bara vill göra pushpins och deras etiketter 67% ogenomskinliga använder du

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

Sammanfattning av formatmodifierare

• X- och Y-koordinater kan finnas var som helst inom fästbild eller en marginal runt den. Marginalstorleken är det minsta av stiftets bredd och höjd.

TilesetId

Kartformat som ska returneras. Möjliga värden är microsoft.base.road, microsoft.base.darkgrey och microsoft.imagery. Standardvärdet är microsoft.base.road. Mer information finns i Render TilesetId.

TrafficTilesetId

Valfritt värde som anger att inget trafikflöde har överlagras på bildresultatet. Möjliga värden är microsoft.traffic.relative.main och ingen. Standardvärdet är inget, vilket anger att inget trafikflöde returneras. Om trafikrelaterade tilesetId tillhandahålls returnerar kartbilden med motsvarande trafikskikt. Mer information finns i Render TilesetId.

LocalizedMapView

Med parametern Visa (kallas även parametern "användarregion" kan du visa rätt kartor för ett visst land/en viss region för geopolitiskt omtvistade regioner. Olika länder/regioner har olika vyer över sådana regioner, och med parametern Visa kan ditt program uppfylla den vy som krävs av det land/den region som programmet kommer att betjäna. Som standard är view-parametern inställd på "Unified" även om du inte har definierat den i begäran. Det är ditt ansvar att fastställa platsen för dina användare och ange sedan view-parametern korrekt för den platsen. Du kan också ange "View=Auto", som returnerar kartdata baserat på IP-adressen för begäran. Parametern Visa i Azure Maps måste användas i enlighet med tillämpliga lagar, inklusive de som gäller mappning, för det land/den region där kartor, bilder och andra data och innehåll från tredje part som du har behörighet att komma åt via Azure Maps görs tillgängligt. Exempel: view=IN.

Mer information finns i vyer som stöds och för att se tillgängliga vyer.

integer (int32)

Bredd på den resulterande bilden i bildpunkter. Mellan 80 och 2000. Standardvärdet är 512. Den ska inte användas med bbox.

integer (int32)

Önskad zoomnivå för kartan. Stöd för zoomvärdesintervall från 0–20 (inklusive) för tilesetId är microsoft.base.road eller microsoft.base.darkgrey. Stöd för zoomvärdesintervall från 0–19 (inklusive) för tilesetId är microsoft.imagery. Standardvärdet är 12.

Mer information finns i Zoomnivåer och Panelrutnät.