Render - Get Map Static Image

RasterTileFormat

Gewünschtes Format der Antwort. Möglicher Wert: png.

string

Versionsnummer der Azure Maps-API. Aktuelle Version ist 2022-08-01

number[]

Begrenzungsrahmen. Projektion verwendet - EPSG:3857. Format: 'minLon, minLat, maxLon, maxLat'.

Hinweis: Entweder bbox oder center sind erforderliche Parameter. Sie schließen sich gegenseitig aus. Sie sollte nicht mit Höhe oder Breite verwendet werden.

Die maximal zulässigen Bereiche für Lat und Lon werden für jeden Zoomfaktor in der Tabelle oben auf dieser Seite definiert.

number[]

Koordinaten des Mittelpunkts. Format: 'lon,lat'. Projizierung verwendet

• EPSG:3857. Längengradbereich: -180 bis 180. Breitenbereich: -85 bis 85.

Hinweis: Entweder zentrieren oder bbox sind erforderliche Parameter. Sie schließen sich gegenseitig aus.

integer (int32)

Höhe des resultierenden Bilds in Pixeln. Der Bereich beträgt 1 bis 8192. Der Standardwert ist 512. Es sollte nicht mit bbox verwendet werden.

string

Sprache, in der Suchergebnisse zurückgegeben werden sollen. Sollte eine der unterstützten IETF-Sprachtags sein, Groß-/Kleinschreibung wird nicht beachtet. Wenn Daten in der angegebenen Sprache für ein bestimmtes Feld nicht verfügbar sind, wird die Standardsprache verwendet.

Weitere Informationen finden Sie unter unterstützten Sprachen.

StaticMapLayer

Kartenebene angefordert. Wenn die Ebene auf Beschriftungen oder Hybride festgelegt ist, sollte das Format png sein.

string[]

Pfadformat und Speicherorte. Verwenden Sie diesen Parameter, um dem Bild optional Linien, Polygone oder Kreise hinzuzufügen. Das Pfadformat beschreibt die Darstellung der Linie und Füllung. (Achten Sie darauf, dass Die WERTE dieses Parameters ordnungsgemäß urlcodiert werden, da sie reservierte Zeichen wie Pipes und Interpunktion enthalten.)

Der Pfadparameter wird ab S1 in der SKU des Azure Maps-Kontos unterstützt. Mehrere Instanzen des Pfadparameters ermöglichen das Angeben mehrerer Geometrien mit ihren Stilen. Die Anzahl der Parameter pro Anforderung ist auf 10 beschränkt, und die Anzahl der Speicherorte ist auf 100 pro Pfad begrenzt.

Um einen Kreis mit Radius 100 Metern und Mittelpunkt am Breitengrad 45°N und Längengrad 122°W mithilfe des Standardstils zu rendern, fügen Sie den Abfragezeichenfolgenparameter hinzu

path=ra100||-122 45

Beachten Sie, dass der Längengrad vor dem Breitengrad liegt. Nach der URL-Codierung sieht dies wie folgt aus:

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

Alle hier aufgeführten Beispiele zeigen den Pfadparameter ohne URL-Codierung aus Gründen der Übersichtlichkeit.

Um eine Linie zu rendern, trennen Sie jede Position durch ein Pipezeichen. Verwenden Sie z. B.

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

Zum Rendern eines Polygons muss die letzte Position der Startposition entsprechen. Verwenden Sie z. B.

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

Längengrad- und Breitengradwerte für Positionen von Linien und Polygonen können zwischen -360 und 360 liegen, um das Rendern von Geometrien zu ermöglichen, die den Anti-Meridian überschreiten.

Formatmodifizierer

Sie können die Darstellung des Pfads ändern, indem Sie Formatmodifizierer hinzufügen. Diese werden vor den Speicherorten hinzugefügt. Formatmodifizierer weisen jeweils einen Zweibuchstabennamen auf. Diese abgekürzten Namen werden verwendet, um die Länge der URL zu verringern.

Um die Farbe der Kontur zu ändern, verwenden Sie den Modifizierer "lc", und geben Sie die Farbe mit dem HTML/CSS RGB-Farbformat an, bei dem es sich um eine sechsstellige Hexadezimalzahl handelt (die dreistellige Form wird nicht unterstützt). Wenn Sie z. B. eine tiefe rosa Farbe verwenden möchten, die Sie in CSS als #FF1493 angeben würden, verwenden Sie

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

Mehrere Modifizierer können kombiniert werden, um einen komplexeren visuellen Stil zu erstellen.

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

Zusammenfassung der Formatmodifizierer

string[]

Heftenart und Instanzen. Verwenden Sie diesen Parameter, um dem Bild optional Pins hinzuzufügen. Die Heftenart beschreibt das Erscheinungsbild der Hefter, und die Instanzen geben die Koordinaten der Hefter und optionalen Beschriftungen für jeden Pin an. (Achten Sie darauf, dass Die WERTE dieses Parameters ordnungsgemäß urlcodiert werden, da sie reservierte Zeichen wie Pipes und Interpunktion enthalten.)

Das Azure Maps-Konto S0 SKU unterstützt nur eine einzelne Instanz des Pins-Parameters. Andere SKUs ermöglichen es mehreren Instanzen des Pins-Parameters, mehrere Pinformatvorlagen anzugeben.

Fügen Sie den Abfragezeichenfolgenparameter hinzu, um eine Stecknadel am Breitengrad 45°N und Längengrad 122°W mithilfe der integrierten Standard-Pin-Formatvorlage zu rendern.

pins=default||-122 45

Beachten Sie, dass der Längengrad vor dem Breitengrad liegt. Nach der URL-Codierung sieht dies wie folgt aus:

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

Alle hier aufgeführten Beispiele zeigen den Pins-Parameter ohne URL-Codierung, um Klarheit zu erhalten.

Um eine Pin an mehreren Stellen zu rendern, trennen Sie jede Position durch ein Pipezeichen. Verwenden Sie z. B.

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

Die S0 Azure Maps-Konto-SKU lässt nur fünf Pins zu. Andere Konto-SKUs haben diese Einschränkung nicht.

Formatmodifizierer

Sie können die Darstellung der Pins ändern, indem Sie Formatmodifizierer hinzufügen. Diese werden nach der Formatvorlage, aber vor den Speicherorten und Beschriftungen hinzugefügt. Formatmodifizierer weisen jeweils einen Zweibuchstabennamen auf. Diese abgekürzten Namen werden verwendet, um die Länge der URL zu verringern.

Um die Farbe der Pin zu ändern, verwenden Sie den Modifizierer "co", und geben Sie die Farbe mit dem HTML/CSS RGB-Farbformat an, bei dem es sich um eine sechsstellige Hexadezimalzahl handelt (die dreistellige Form wird nicht unterstützt). Wenn Sie z. B. eine tiefe rosa Farbe verwenden möchten, die Sie in CSS als #FF1493 angeben würden, verwenden Sie

pins=default|coFF1493||-122 45

Stecknadelbeschriftungen

Wenn Sie den Pins eine Beschriftung hinzufügen möchten, platzieren Sie die Beschriftung direkt vor den Koordinaten in einfache Anführungszeichen. Wenn Sie beispielsweise drei Pins mit den Werten "1", "2" und "3" beschriften möchten, verwenden Sie

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

Es gibt eine integrierte Pinformatvorlage namens "none", die kein Heftenbild anzeigt. Sie können dies verwenden, wenn Sie Beschriftungen ohne Pinbild anzeigen möchten. Zum Beispiel

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

Um die Farbe der Heftbeschriftungen zu ändern, verwenden Sie den Modifizierer "lc". Wenn Sie z. B. rosa Hefter mit schwarzen Etiketten verwenden möchten, verwenden Sie

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

Verwenden Sie den Modifizierer für die Beschriftungsformatvorlage "ls", um die Größe der Beschriftungen zu ändern. Die Beschriftungsgröße stellt die ungefähre Höhe des Beschriftungstexts in Pixel dar. Wenn Sie beispielsweise die Beschriftungsgröße auf 12 erhöhen möchten, verwenden Sie

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

Die Etiketten werden an der Stecknadel "Etikettenanker" zentriert. Die Verankerungsposition ist für integrierte Stecknadeln vordefiniert und befindet sich in der oberen Mitte von benutzerdefinierten Stecknadeln (siehe unten). Um den Bezeichnungsanker außer Kraft zu setzen, verwenden Sie den Modifizierer "la" und stellen X- und Y-Pixelkoordinaten für den Anker bereit. Diese Koordinaten sind relativ zur oberen linken Ecke des Hefterbilds. Positive X-Werte verschieben den Anker nach rechts, und positive Y-Werte verschieben den Anker nach unten. Um z. B. die Beschriftungsanker 10 Pixel rechts und 4 Pixel über der oberen linken Ecke des Heftbilds zu positionieren, verwenden Sie

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

Benutzerdefinierte Pins

Um ein benutzerdefiniertes Pin-Bild zu verwenden, verwenden Sie das Wort "benutzerdefiniert" als Namen der Pinformatvorlage, und geben Sie dann eine URL nach den Standort- und Bezeichnungsinformationen an. Verwenden Sie zwei Pipezeichen, um anzugeben, dass Sie mit der Angabe von Speicherorten fertig sind und die URL starten. Zum Beispiel

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

Nach der URL-Codierung würde dies wie folgt aussehen:

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

Standardmäßig werden benutzerdefinierte Pin-Bilder zentriert an den Pinkoordinaten gezeichnet. Dies ist in der Regel nicht ideal, da sie den Speicherort verdeckt, den Sie hervorheben möchten. Um die Verankerungsposition des Pinbilds außer Kraft zu setzen, verwenden Sie den Modifizierer "an". Dies verwendet das gleiche Format wie der Modifizierer "la"-Bezeichnungsanker. Wenn ihr benutzerdefiniertes Pinbild z. B. die Spitze der Stecknadel in der oberen linken Ecke des Bilds aufweist, können Sie den Anker mithilfe dieser Stelle festlegen.

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

Hinweis: Wenn Sie den Farbmodifizierer "co" mit einem benutzerdefinierten Pinbild verwenden, ersetzt die angegebene Farbe die RGB-Kanäle der Pixel im Bild, lässt aber den Alphakanal (Deckkraft) unverändert. Dies wäre in der Regel nur mit einem benutzerdefinierten Volltonbild möglich.

Skalierung, Drehung und Deckkraft

Mithilfe des Modifizierers "sc" können Sie Heftmarken und deren Beschriftungen vergrößern oder verkleinern. Dies ist ein Wert größer als Null. Ein Wert von 1 ist die Standardskala. Werte, die größer als 1 sind, machen die Pins größer, und werte kleiner als 1 machen sie kleiner. Wenn Sie beispielsweise die Hefter 50% größer als normal zeichnen möchten, verwenden Sie

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

Sie können Hefter und deren Beschriftungen mithilfe des Modifizierers "ro" drehen. Dies ist eine Reihe von Grad der Drehung im Uhrzeigersinn. Verwenden Sie eine negative Zahl, um gegen den Uhrzeigersinn zu drehen. Um beispielsweise die Hefter um 90 Grad im Uhrzeigersinn zu drehen und ihre Größe zu verdoppeln, verwenden Sie

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

Sie können Pins und ihre Beschriftungen teilweise transparent machen, indem Sie den Modifizierer "al" im Alphastil angeben. Dies ist eine Zahl zwischen 0 und 1, die die Deckkraft der Hefter angibt. Null macht sie vollständig transparent (und nicht sichtbar) und 1 macht sie vollständig undurchsichtig (die Standardeinstellung). Verwenden Sie z. B. 67% undurchsichtig, um Pins und deren Etiketten zu machen.

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

Zusammenfassung der Formatmodifizierer

• X- und Y-Koordinaten können an einer beliebigen Stelle innerhalb des Pinbilds oder eines Rands um sie herum liegen. Die Randgröße ist das Minimum der Pinbreite und -höhe.

MapImageStyle

Die zurückgegebene Kartenformatvorlage. Mögliche Werte sind Haupt- und Dunkelwerte.

LocalizedMapView

Mit dem Parameter "View" (auch als Parameter "Benutzerregion" bezeichnet) können Sie die richtigen Karten für ein bestimmtes Land/eine bestimmte Region für geopolitische umstrittene Regionen anzeigen. Unterschiedliche Länder/Regionen haben unterschiedliche Ansichten solcher Regionen, und der Parameter "View" ermöglicht Ihrer Anwendung die Einhaltung der vom Land/der Region benötigten Ansicht, die Ihre Anwendung bedient. Der Parameter "View" ist standardmäßig auf "Unified" festgelegt, auch wenn Sie ihn in der Anforderung nicht definiert haben. Es liegt in Ihrer Verantwortung, den Standort Ihrer Benutzer zu bestimmen und dann den Parameter "View" für diesen Speicherort korrekt festzulegen. Alternativ können Sie "View=Auto" festlegen, wodurch die Kartendaten basierend auf der IP-Adresse der Anforderung zurückgegeben werden. Der Parameter "View" in Azure Maps muss in Übereinstimmung mit den geltenden Gesetzen verwendet werden, einschließlich derjenigen bezüglich der Zuordnung des Landes/der Region, in dem Karten, Bilder und andere Daten und Inhalte von Drittanbietern, die Sie für den Zugriff über Azure Maps autorisiert haben, verfügbar gemacht werden. Beispiel: view=IN.

Weitere Informationen finden Sie unter Unterstützten Ansichten und die verfügbaren Ansichten.

integer (int32)

Breite des resultierenden Bilds in Pixeln. Der Bereich beträgt 1 bis 8192. Der Standardwert ist 512. Es sollte nicht mit bbox verwendet werden.

integer (int32)

Gewünschter Zoomfaktor der Karte. Der Zoomwert muss im Bereich 0–20 liegen. Der Standardwert ist 12.

Weitere Informationen finden Sie unter Zoomstufen und kachelraster-.