Rendera anpassade data på en rasterkarta
I den här artikeln beskrivs hur du använder kommandot Hämta statisk avbildningskarta med funktioner för bildsammansättning. Funktioner för bildsammansättning stöder hämtning av statiska rasterpaneler som innehåller anpassade data.
Följande är exempel på anpassade data:
- Anpassade pushpins
- Etiketter
- Geometriöverlägg
Dricks
Om du vill visa en enkel karta på en webbsida är det ofta mer kostnadseffektivt att använda Azure Kartor Web SDK i stället för att använda tjänsten för statiska avbildningar. Webb-SDK använder kartpaneler; och om inte användaren panorerar och zoomar kartan genererar de ofta bara en bråkdel av en transaktion per kartinläsning. Azure Kartor Web SDK har alternativ för att inaktivera panorering och zoomning. Dessutom tillhandahåller Azure Kartor Web SDK en större uppsättning datavisualiseringsalternativ än vad en webbtjänst för statiska kartor gör.
Förutsättningar
Den här artikeln använder Postman-programmet , men du kan använda en annan API-utvecklingsmiljö.
Viktigt!
I URL-exemplen ersätter du {Your-Azure-Maps-Subscription-key}
med din Azure Kartor-prenumerationsnyckel.
Rendera pushpins med etiketter och en anpassad avbildning
Kommentar
Proceduren i det här avsnittet kräver ett Azure Kartor-konto på prisnivån Gen1 eller Gen2. Prisnivån för Azure Kartor-kontot Gen1 S0 stöder endast en enda instans av pin-parametern. Det gör att du kan rendera upp till fem pushpins, som anges i URL-begäran, med en anpassad avbildning.
Azure Kartor Gen1-prisnivån dras tillbaka
Prisnivån Gen1 är nu inaktuell och dras tillbaka den 26-09-15. Prisnivån Gen2 ersätter prisnivån Gen1 (både S0 och S1). Om ditt Azure Kartor-konto har valt prisnivån Gen1 kan du växla till Gen2-priser innan det dras tillbaka, annars uppdateras det automatiskt. Mer information finns i Hantera prisnivån för ditt Azure Kartor-konto.
Hämta statisk bild med anpassade stift och etiketter
Så här hämtar du en statisk bild med anpassade stift och etiketter:
I Postman-appen väljer du Ny.
I fönstret Skapa ny väljer du HTTP-begäran.
Ange ett begärandenamn för begäran, till exempel Hämta statisk mappningsbild.
Välj GET HTTP-metoden.
Ange följande webbadress:
https://atlas.microsoft.com/map/static/png?subscription-key={Your-Azure-Maps-Subscription-key}&api-version=2022-08-01&layer=basic&style=main&zoom=12¢er=-73.98,%2040.77&pins=custom%7Cla15+50%7Cls12%7Clc003b61%7C%7C%27CentralPark%27-73.9657974+40.781971%7C%7Chttps%3A%2F%2Fsamples.azuremaps.com%2Fimages%2Ficons%2Fylw-pushpin.png
Välj Skicka.
Tjänsten returnerar följande bild:
Rendera en polygon med färg och opacitet
Kommentar
Proceduren i det här avsnittet kräver en prisnivå för Azure Kartor-kontot Gen1 (S1) eller Gen2.
Du kan ändra utseendet på en polygon med hjälp av formatmodifierare med sökvägsparametern.
Så här renderar du en polygon med färg och opacitet:
I Postman-appen väljer du Ny.
I fönstret Skapa ny väljer du HTTP-begäran.
Ange ett begärandenamn för begäran, till exempel GET Polygon.
Välj GET HTTP-metoden.
Ange följande URL till renderningstjänsten:
https://atlas.microsoft.com/map/static/png?api-version=2022-08-01&style=main&layer=basic&sku=S1&zoom=14&height=500&Width=500¢er=-74.040701, 40.698666&path=lc0000FF|fc0000FF|lw3|la0.80|fa0.50||-74.03995513916016 40.70090237454063|-74.04082417488098 40.70028420372218|-74.04113531112671 40.70049568385827|-74.04298067092896 40.69899904076542|-74.04271245002747 40.69879568992435|-74.04367804527283 40.6980961582905|-74.04364585876465 40.698055487620714|-74.04368877410889 40.698022951066996|-74.04168248176573 40.696444909137|-74.03901100158691 40.69837271818651|-74.03824925422668 40.69837271818651|-74.03809905052185 40.69903971085914|-74.03771281242369 40.699340668780984|-74.03940796852112 40.70058515602143|-74.03948307037354 40.70052821920425|-74.03995513916016 40.70090237454063 &subscription-key={Your-Azure-Maps-Subscription-key}
Tjänsten returnerar följande bild:
Rendera en cirkel och pushpins med anpassade etiketter
Kommentar
Proceduren i det här avsnittet kräver en prisnivå för Azure Kartor-kontot Gen1 (S1) eller Gen2.
Du kan ändra utseendet på stiften genom att lägga till formatmodifierare. Om du till exempel vill göra pushpins och deras etiketter större eller mindre använder du modifieraren sc
"skalningsformat". Den här modifieraren tar 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 mindre än 1 gör dem mindre. Mer information om formatmodifierare finns i sökvägsparametern för kommandot Hämta statisk avbildning för karta.
Så här renderar du en cirkel och pushpins med anpassade etiketter:
I Postman-appen väljer du Ny.
I fönstret Skapa ny väljer du HTTP-begäran.
Ange ett begärandenamn för begäran, till exempel GET Polygon.
Välj GET HTTP-metoden.
Ange följande URL till renderningstjänsten:
https://atlas.microsoft.com/map/static/png?api-version=2022-08-01&style=main&layer=basic&zoom=14&height=700&Width=700¢er=-122.13230609893799,47.64599069048016&path=lcFF0000|lw2|la0.60|ra1000||-122.13230609893799 47.64599069048016&pins=default|la15+50|al0.66|lc003C62|co002D62||'Microsoft Corporate Headquarters'-122.14131832122801 47.64690503939462|'Microsoft Visitor Center'-122.136828 47.642224|'Microsoft Conference Center'-122.12552547454833 47.642940335653996|'Microsoft The Commons'-122.13687658309935 47.64452336193245&subscription-key={Your-Azure-Maps-Subscription-key}
Välj Skicka.
Tjänsten returnerar följande bild:
Ändra sedan färg på pushpins genom att
co
ändra formatmodifieraren. Om du tittar på värdet för parameternpins
(pins=default|la15+50|al0.66|lc003C62|co002D62|
) ser du att den aktuella färgen är#002D62
. Om du vill ändra färgen till#41d42a
ersätter du#002D62
med#41d42a
. Nu ärpins=default|la15+50|al0.66|lc003C62|co41D42A|
parameternpins
. Begäran ser ut som följande URL:https://atlas.microsoft.com/map/static/png?api-version=2022-08-01&style=main&layer=basic&zoom=14&height=700&Width=700¢er=-122.13230609893799,47.64599069048016&path=lcFF0000|lw2|la0.60|ra1000||-122.13230609893799 47.64599069048016&pins=default|la15+50|al0.66|lc003C62|co41D42A||'Microsoft Corporate Headquarters'-122.14131832122801 47.64690503939462|'Microsoft Visitor Center'-122.136828 47.642224|'Microsoft Conference Center'-122.12552547454833 47.642940335653996|'Microsoft The Commons'-122.13687658309935 47.64452336193245&subscription-key={Your-Azure-Maps-Subscription-key}
Välj Skicka.
Tjänsten returnerar följande bild:
På samma sätt kan du ändra, lägga till och ta bort andra formatmodifierare.