Vykreslení vlastních dat na rastrové mapě

Tento článek popisuje, jak používat příkaz Získat mapový statický obrázek s funkcemi složení obrázků. Funkce složení obrázků podporuje načítání statických rastrových dlaždic, které obsahují vlastní data a různé styly.

Tady jsou příklady vlastních dat:

• Vlastní připínáky
• Popisky
• Překryvy geometrie

Tip

Pokud chcete zobrazit jednoduchou mapu na webové stránce, je často nákladově efektivnější používat sadu Azure Maps Web SDK místo použití statické služby obrázků. Webová sada SDK používá dlaždice map; a pokud uživatel mapu posune a přiblíží, často vygeneruje pouze zlomek transakce na načtení mapy pomocí ukládání do mezipaměti prohlížeče. Webová sada SDK služby Azure Maps nabízí možnosti zakázání posouvání a přiblížení. Sada Azure Maps Web SDK také poskytuje bohatší sadu možností vizualizace dat než webová služba statické mapy.

Požadavky

• Účet Azure Maps
• Klíč předplatného

Důležité

V příkladech adres URL nahraďte {Your-Azure-Maps-Subscription-key} klíčem předplatného Azure Maps.

Tento článek používá aplikaci Bruno , ale můžete použít jiné vývojové prostředí rozhraní API.

Poznámka:

Příklady v tomto článku vyžadují účet Azure Maps na cenové úrovni Gen2.

Vyřazení cenové úrovně Azure Maps Gen1 z provozu

Cenová úroveň Gen1 je teď zastaralá a bude vyřazena 15. 9. 26. Cenová úroveň Gen2 nahrazuje cenovou úroveň Gen1 (S0 i S1). Pokud má váš účet Azure Maps vybranou cenovou úroveň Gen1, můžete před vyřazením přepnout na ceny Gen2, jinak se automaticky aktualizuje. Další informace najdete v tématu Správa cenové úrovně účtu Azure Maps.

Získání statického obrázku s vlastními špendlíky a popisky

Získání statického obrázku s vlastními špendlíky a popisky:

1. V aplikaci Bruno vyberte Nový požadavek.

2. Nastavte typ na HTTP.

3. Zadejte název požadavku, například Získat statický obrázek mapy.

4. Vyberte metodu GET HTTP URL.

5. Zadejte následující adresu URL:

   https://atlas.microsoft.com/map/static?subscription-key={Your-Azure-Maps-Subscription-key}&zoom=13&tilesetId=microsoft.base.road&api-version=2024-04-01&language=en-us&center=-73.964085, 40.78477&path=lcFF0000|lw2|la0.60|ra700||-122.13230609893799 47.64599069048016&pins=custom%7Cla15+50%7Cls12%7Clc003b61%7C%7C%27Central Park%27-73.9657974+40.781971%7C%7Chttps%3A%2F%2Fsamples.azuremaps.com%2Fimages%2Ficons%2Fylw-pushpin.png
   

6. Vyberte Vytvořit.

7. Vyberte šipku Odeslat požadavek , která se zobrazí napravo od adresy URL požadavku.

   Vrátí se následující obrázek:

   

Vykreslení mnohoúhelníku barvou a neprůhledností

Vzhled mnohoúhelníku můžete upravit pomocí modifikátorů stylu s parametrem cesty .

Vykreslení mnohoúhelníku barvou a neprůhledností:

1. V aplikaci Bruno vyberte Nový požadavek.

2. Nastavte typ na HTTP.

3. Zadejte název požadavku, například GET Polygon.

4. Vyberte metodu GET HTTP URL.

5. Zadejte následující adresu URL služby Render :

   https://atlas.microsoft.com/map/static?subscription-key={Your-Azure-Maps-Subscription-key}&zoom=15&tilesetId=microsoft.base.road&api-version=2024-04-01&language=en-us&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&pins=custom%7Cla15+50%7Cls12%7Clc003b61%7C%7C%27Central Park%27-73.9657974+40.781971%7C%7Chttps%3A%2F%2Fsamples.azuremaps.com%2Fimages%2Ficons%2Fylw-pushpin.png&center=-74.040701, 40.698666&height=500&Width=500
   

   Vrátí se následující obrázek:

   

Vykreslení kruhu a připínáku s vlastními popisky

Vzhled špendlíků můžete upravit přidáním modifikátorů stylu. Pokud například chcete, aby byly připínáky a jejich popisky větší nebo menší, použijte sc modifikátor "styl měřítka". Tento modifikátor přebírá hodnotu, která je větší než nula. Hodnota 1 je standardní měřítko. Hodnoty větší než 1 zvětší špendlíky a hodnoty menší než 1 zmenší. Další informace o modifikátorech stylu naleznete v parametru Path příkazu Získat mapový statický obrázek.

Vykreslení kruhu a připnutí pomocí vlastních popisků:

1. V aplikaci Bruno vyberte Nový požadavek.

2. Nastavte typ na HTTP.

3. Zadejte název požadavku, například GET Polygon.

4. Vyberte metodu GET HTTP URL.

5. Zadejte následující adresu URL služby Render :

   https://atlas.microsoft.com/map/static?subscription-key={Your-Azure-Maps-Subscription-key}&zoom=14&tilesetId=microsoft.base.road&api-version=2024-04-01&language=en-us&center=-122.13230609893799,47.64599069048016&path=lcFF0000|lw2|la0.60|ra1000||-122.13230609893799 47.64599069048016&pins=default|la15+50|sc1|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&height=700&Width=700
   

6. Vyberte Vytvořit.

7. Vyberte šipku Odeslat požadavek , která se zobrazí napravo od adresy URL požadavku.

   Vrátí se následující obrázek:

   

8. Dále změňte barvu připínáku úpravou modifikátoru co stylu. Pokud se podíváte na hodnotu parametru pins (pins=default|la15+50|al0.66|lc003C62|co002D62|), všimněte si, že aktuální barva je #002D62. Chcete-li změnit barvu na #41d42a, nahraďte #002D62 .#41d42a pins Nyní je pins=default|la15+50|al0.66|lc003C62|co41D42A|parametr . Požadavek vypadá jako následující adresa URL:

   https://atlas.microsoft.com/map/static?subscription-key={Your-Azure-Maps-Subscription-key}&zoom=14&tilesetId=microsoft.base.road&api-version=2024-04-01&language=en-us&center=-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&height=700&Width=700 
   

9. Vyberte Vytvořit.

10. Vyberte šipku Odeslat požadavek , která se zobrazí napravo od adresy URL požadavku.

    Vrátí se následující obrázek:

    

Podobně můžete změnit, přidat a odebrat další modifikátory stylu.

Přidání vrstvy provozu

Pokud chcete získat statický obrázek s vrstvou provozu vykreslenou na základní mapě silnic, použijte trafficLayer parametr. Následující příklad ukazuje mapu s vrstvou provozu a špendlíkem s popiskem:

1. V aplikaci Bruno vyberte Nový požadavek.

2. Nastavte typ na HTTP.

3. Zadejte název požadavku, například Get Map Static Image – vrstva provozu.

4. Vyberte metodu GET HTTP URL.

5. Zadejte následující adresu URL:

   https://atlas.microsoft.com/map/static?subscription-key={Your-Azure-Maps-Subscription-key}&zoom=14&tilesetId=microsoft.base.road&api-version=2024-04-01&language=en-us&center= -0.122427, 51.500867&pins=custom%7Cla15+50%7Cls12%7Clc003b61%7C%7C%27Westminster Bridge%27-0.122427+51.500867%7C%7Chttps%3A%2F%2Fsamples.azuremaps.com%2Fimages%2Ficons%2Fylw-pushpin.png&height=700&Width=700&trafficLayer=microsoft.traffic.relative.main 
   

6. Vyberte Vytvořit.

7. Vyberte šipku Odeslat požadavek , která se zobrazí napravo od adresy URL požadavku.

   Vrátí se následující obrázek:

   

Vytvoření mapy pomocí tmavě šedého stylu

Pokud chcete získat statický obrázek s použitým tmavě šedým stylem, nastavte parametr na TilesetId microsoft.base.darkgrey:

1. V aplikaci Bruno vyberte Nový požadavek.

2. Nastavte typ na HTTP.

3. Zadejte název požadavku, například Získat statický obrázek mapy – tmavě šedý styl.

4. Vyberte metodu GET HTTP URL.

5. Zadejte následující adresu URL:

   https://atlas.microsoft.com/map/static?subscription-key={Your-Azure-Maps-Subscription-key}&zoom=16&tilesetId=microsoft.base.darkgrey&api-version=2024-04-01&language=en-us&center=-95.360200,29.753452&pins=custom%7Cla15+50%7Cls12%7Clc003b61%7C%7C%27Westminster Bridge%27-0.122427+51.500867%7C%7Chttps%3A%2F%2Fsamples.azuremaps.com%2Fimages%2Ficons%2Fylw-pushpin.png&height=700&Width=700 
   

6. Vyberte Vytvořit.

7. Vyberte šipku Odeslat požadavek , která se zobrazí napravo od adresy URL požadavku.

Vrátí se následující obrázek:

Další informace o různých stylech dostupných pomocí parametru TilesetId najdete v tématu TilesetId v dokumentaci k rozhraní REST API sady dlaždic map.

Vytvoření mapy pomocí stylu obrázků

Pokud chcete získat statický obrázek s použitým stylem obrázku, nastavte TilesetId parametr na microsoft.imagery:

1. V aplikaci Bruno vyberte Nový požadavek.

2. Nastavte typ na HTTP.

3. Zadejte název požadavku, například Získat statický obrázek mapy – styl obrázku.

4. Vyberte metodu GET HTTP URL.

5. Zadejte následující adresu URL:

   https://atlas.microsoft.com/map/static?subscription-key={Your-Azure-Maps-Subscription-key}&zoom=16&tilesetId=microsoft.imagery&api-version=2024-04-01&language=en-us&center=-43.176141,-22.965458&height=700&Width=700
   

6. Vyberte Vytvořit.

7. Vyberte šipku Odeslat požadavek , která se zobrazí napravo od adresy URL požadavku.

   Vrátí se následující obrázek:

   

Další informace o různých stylech dostupných pomocí parametru TilesetId najdete v tématu TilesetId v dokumentaci k rozhraní REST API sady dlaždic map.

Další kroky

Vykreslení – získání statického obrázku mapy