Teilen über

Rendern von benutzerdefinierten Daten auf einer Rasterkarte

  • Artikel

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

Tipp

Häufig ist die Nutzung des Azure Maps Web SDK zum Anzeigen einer einfachen Karte auf einer Webseite kostengünstiger als die Verwendung des statischen Bilddiensts. Das Web SDK verwendet Kartenkacheln. Sofern der Benutzer oder die Benutzerin in der Karte nicht schwenkt und zoomt, wird oftmals nur der Bruchteil einer Transaktion pro Kartenladevorgang mittels Browserzwischenspeicherung generiert. Das Azure Maps-Web-SDK verfügt über Optionen zum Deaktivieren von Schwenken und Zoomen. Außerdem bietet das Azure Maps-Web-SDK umfassendere Optionen für die Datenvisualisierung als ein statischer Kartenwebdienst.

Voraussetzungen

Wichtig

Ersetzen Sie in den URL-Beispielen {Your-Azure-Maps-Subscription-key} durch Ihren Azure Maps-Abonnementschlüssel.

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

Hinweis

Die Beispiele in diesem Artikel erfordern ein Azure Maps-Konto im Tarif Gen2.

Einstellung des Azure Maps-Tarifs „Gen1”

Der Tarif Gen1 ist jetzt veraltet und wird am 15.09.2026 eingestellt. Der Tarif Gen2 ersetzt den Tarif Gen1 (S0 und S1). Wenn für Ihr Azure Maps Konto der Tarif Gen1 ausgewählt ist, können Sie vor der Einstellung zum Tarif Gen2 wechseln, andernfalls erfolgt zu diesem Zeitpunkt eine automatische Umstellung. Weitere Informationen finden Sie unter Verwalten des Tarifs Ihres Azure Maps-Kontos.

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:

    Eine benutzerdefinierte Ortsmarke mit einer Bezeichnung.

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 eines undurchsichtigen (opaken) Polygons.

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:

    Rendern eines Kreises mit benutzerdefinierten Ortsmarken.

  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:

    Rendern eines Kreises mit aktualisierten Ortsmarken.

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:

    Screenshot: Karte mit der Verkehrsebene sowie einer benutzerdefinierten Stecknadel mit der Beschriftung „Westminster Bridge“

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:

Screenshot: Karte mit dem dunkelgrauen Stil, der durch Festlegen des Parameters „TilesetID“ auf „microsoft.base.darkgrey“ erstellt wurde

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:

    Screenshot: Karte mit dem Stil „Imagery“, der durch Festlegen des Parameters „TilesetID“ auf „microsoft.imagery

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

Rendern: Get Map Static Image