Rendern von benutzerdefinierten Daten auf einer Rasterkarte

In diesem Artikel wird beschrieben, wie Sie den Befehl Get Map Static Image mit der Bildkompositionsfunktion verwenden. Die Bildkompositionsfunktion unterstützt das Abrufen von statischen Rasterkacheln, die benutzerdefinierte Daten und verschiedene Stile enthalten.

Nachfolgend finden Sie Beispiele für benutzerdefinierte Daten:

• Benutzerdefinierte Ortsmarken
• Bezeichnungen
• Geometrieüberlagerungen

Voraussetzungen

• Azure Maps-Konto
• Abonnementschlüssel

In diesem Artikel wird die Anwendung Bruno verwendet. Sie können aber auch eine andere API-Entwicklungsumgebung verwenden.

Abrufen eines statischen Bilds mit benutzerdefinierten Ortsmarken und Bezeichnungen

So rufen Sie ein statisches Bild mit benutzerdefinierten Ortsmarken und Bezeichnungen ab

1. Wählen Sie in der Bruno-App New Request aus.

2. Legen Sie den Typ auf HTTP fest.

3. Geben Sie in Name einen Namen für die Anforderung ein, beispielsweise Get Map Static Image.

4. Wählen Sie die HTTP-URL-Methode GET aus.

5. Geben Sie die folgende URL ein:

   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. Klicken Sie auf Erstellen.

7. Wählen Sie den Pfeil Anforderung senden aus, der rechts neben der Anforderungs-URL angezeigt wird.

   Das folgende Bild wird zurückgegeben:

   

Rendern eines Polygons mit Farbe und Transparenz

Sie können das Aussehen eines Polygons ändern, indem Sie Stilmodifikatoren mit dem Parameter path verwenden.

So rendern Sie ein Polygon mit Farbe und Deckkraft

1. Wählen Sie in der Bruno-App New Request aus.

2. Legen Sie den Typ auf HTTP fest.

3. Geben Sie in Name einen Namen für die Anforderung ein, z. B. GET Polygon.

4. Wählen Sie die HTTP-URL-Methode GET aus.

5. Geben Sie die folgende URL für den Renderingdienst ein:

   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
   

   Das folgende Bild wird zurückgegeben:

   

Rendern von Kreisen und Ortsmarken mit benutzerdefinierten Bezeichnungen

Sie können die Darstellung der Ortsmarken durch Hinzufügen von Stilmodifizierern ändern. Sie können Ortsmarken und ihre Bezeichnungen beispielsweise vergrößern oder verkleinern, indem Sie den „Skalierungsstil“-Modifizierer sc verwenden. Dieser Modifizierer akzeptiert Werte über 0 (null). Der Wert 1 ist die Standardskalierung. Werte größer als 1 machen die Ortsmarken größer, und Werte kleiner als 1 machen sie kleiner. Weitere Informationen zu Stilmodifizierern finden Sie unter dem Parameter path des Befehls Get Map Static Image.

So rendern Sie einen Kreis und Ortsmarken mit benutzerdefinierten Bezeichnungen

1. Wählen Sie in der Bruno-App New Request aus.

2. Legen Sie den Typ auf HTTP fest.

3. Geben Sie in Name einen Namen für die Anforderung ein, z. B. GET Polygon.

4. Wählen Sie die HTTP-URL-Methode GET aus.

5. Geben Sie die folgende URL für den Renderingdienst ein:

   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. Klicken Sie auf Erstellen.

7. Wählen Sie den Pfeil Anforderung senden aus, der rechts neben der Anforderungs-URL angezeigt wird.

   Das folgende Bild wird zurückgegeben:

   

8. Ändern Sie als Nächstes die Farbe der Ortsmarken, indem Sie den Formatmodifizierer co ändern. Wenn Sie den Wert des pins-Parameters (pins=default|la15+50|al0.66|lc003C62|co002D62|) betrachten, sehen Sie, dass die aktuelle Farbe #002D62 ist. Um die Farbe in #41d42a zu ändern, ersetzen Sie #002D62 durch #41d42a. Der Parameter pins lautet nun pins=default|la15+50|al0.66|lc003C62|co41D42A|. Die Anforderung sieht wie die folgende URL aus:

   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. Klicken Sie auf Erstellen.

10. Wählen Sie den Pfeil Anforderung senden aus, der rechts neben der Anforderungs-URL angezeigt wird.

    Das folgende Bild wird zurückgegeben:

    

Auf ähnliche Weise können Sie andere Stilmodifiziererer ändern, hinzufügen und entfernen.

Hinzufügen einer Verkehrsebene

Um ein statisches Bild mit einer Verkehrsschicht abzurufen, die auf einer Straßenkarte gerendert wird, verwenden Sie den Parameter trafficLayer. Das folgende Beispiel zeigt eine Karte mit einer Verkehrsebene und einer Stecknadel mit einer Beschriftung:

1. Wählen Sie in der Bruno-App New Request aus.

2. Legen Sie den Typ auf HTTP fest.

3. Geben Sie einen Namen für die Anforderung ein, z. B. Get Map Static Image – Traffic Layer.

4. Wählen Sie die HTTP-URL-Methode GET aus.

5. Geben Sie die folgende URL ein:

   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. Klicken Sie auf Erstellen.

7. Wählen Sie den Pfeil Anforderung senden aus, der rechts neben der Anforderungs-URL angezeigt wird.

   Das folgende Bild wird zurückgegeben:

   

Erstellen einer Karte mit dem dunkelgrauen Stil

Um ein statisches Bild zu erhalten, auf das der dunkelgraue Stil angewendet wird, legen Sie den Parameter TilesetId auf microsoft.base.darkgrey fest.

1. Wählen Sie in der Bruno-App New Request aus.

2. Legen Sie den Typ auf HTTP fest.

3. Geben Sie in Name einen Namen für die Anforderung ein, z. B. Get Map Static Image –dark gray.

4. Wählen Sie die HTTP-URL-Methode GET aus.

5. Geben Sie die folgende URL ein:

   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. Klicken Sie auf Erstellen.

7. Wählen Sie den Pfeil Anforderung senden aus, der rechts neben der Anforderungs-URL angezeigt wird.

Das folgende Bild wird zurückgegeben:

Weitere Informationen zu den verschiedenen Stilen, die durch Verwendung des Parameters TilesetId verfügbar sind, finden Sie unter „TilesetId“ in der REST-API-Dokumentation Render – Get Map Tileset.

Erstellen einer Karte mit dem Stil „imagery“

Um ein statisches Bild zu erhalten, auf das der Stil „imagery“ angewendet wird, legen Sie den Parameter TilesetId auf microsoft.imagery fest.

1. Wählen Sie in der Bruno-App New Request aus.

2. Legen Sie den Typ auf HTTP fest.

3. Geben Sie in Name einen Namen für die Anforderung ein, z. B. Get Map Static Image – Imagery Style.

4. Wählen Sie die HTTP-URL-Methode GET aus.

5. Geben Sie die folgende URL ein:

   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. Klicken Sie auf Erstellen.

7. Wählen Sie den Pfeil Anforderung senden aus, der rechts neben der Anforderungs-URL angezeigt wird.

   Das folgende Bild wird zurückgegeben:

   

Weitere Informationen zu den verschiedenen Stilen, die durch Verwendung des Parameters TilesetId verfügbar sind, finden Sie unter „TilesetId“ in der REST-API-Dokumentation Render – Get Map Tileset.

Nächste Schritte