Render - Get Map Static Image

string

string

Die API-Version, die für diesen Vorgang verwendet werden soll.

number[]

Ein umgebendes Feld wird durch zwei Breiten und zwei Längengrade definiert, die die vier Seiten eines rechteckigen Bereichs auf der Erde darstellen. Format: 'minLon, minLat, maxLon, maxLat' (in Double).

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

Die maximalen und minimal 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 in doppelter Zahl. Format: 'lon, lat'. Längengradbereich: -180 bis 180. Breitenbereich: -90 bis 90.

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

integer (int32)

Höhe des resultierenden Bilds in Pixeln. Reichen von 80 bis 1500. 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.

string[]

Pfadformat und Speicherorte (in double). 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 in der Azure Maps-Konto-SKU ab S1 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

Ein Polygon wird mit einem geschlossenen Pfad angegeben, wobei die ersten und letzten Punkte gleich sind. Verwenden Sie z. B.

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

Der Längengradwert für Positionen von Linien und Polygonen kann 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 Pins (in Doppel) und optionale 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.)

Die Azure Maps-Account S0 SKU unterstützt nur eine einzelne Instanz des Pins-Parameters und die Anzahl der Standorte ist auf 5 pro Pin begrenzt. Andere SKUs ermöglichen bis zu 25 Instanzen des Pins-Parameters, mehrere Pinformatvorlagen anzugeben, und die Anzahl der Speicherorte ist auf 50 pro Pin beschränkt.

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 erlaubt nur fünf Pushpins. Andere Konto-SKUs haben diese Einschränkung nicht.

Formatmodifizierer

Sie können die Darstellung der Ortsmarken durch Hinzufügen von Stilmodifizierern ändern. 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. Vermeiden Sie die Verwendung von Sonderzeichen wie | oder || in der Beschriftung. 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 Pin-Formatvorlage namens "none", die kein Hefterbild anzeigt. Sie können dies verwenden, wenn Sie Beschriftungen ohne Pinbild anzeigen möchten. 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. Die maximale zulässige Größe für ein angepasstes Etikettenbild beträgt 65.536 Pixel. Verwenden Sie zwei Pipezeichen, um anzugeben, dass Sie mit der Angabe von Speicherorten fertig sind und die URL starten. 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. Der Wert 1 ist die Standardskalierung. 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.

Tileset

Die zurückgegebene Kartenformatvorlage. Mögliche Werte sind "microsoft.base.road", "microsoft.base.darkgrey" und "microsoft.imagery". Der Standardwert ist auf "microsoft.base.road" festgelegt. Weitere Informationen finden Sie unter Render-KachelnetId-.

TrafficTilesetId

Optionaler Wert, der angibt, dass kein Datenverkehrsfluss für das Bildergebnis überlagert ist. Mögliche Werte sind "microsoft.traffic.relative.main" und "none". Der Standardwert ist keine, der angibt, dass kein Datenverkehrsfluss zurückgegeben wird. Wenn datenverkehrsbezogene KachelnetId bereitgestellt wird, wird das Kartenbild mit entsprechender Datenverkehrsebene zurückgegeben. Weitere Informationen finden Sie unter Render-KachelnetId-.

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 View-Parameter in Azure Maps muss gemäß den geltenden Gesetzen, einschließlich der Kartierung, des Landes/der Region verwendet werden, in der Karten, Bilder und andere Daten sowie Drittanbieter-Inhalte, auf die Sie über Azure Maps zugreifen dürfen, zugänglich 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. Reichen von 80 bis 2000. Der Standardwert ist 512. Es sollte nicht mit bbox verwendet werden.

integer (int32)

Gewünschter Zoomfaktor der Karte. Unterstützen Sie den Zoomwertbereich von 0 bis 20 (einschließlich) für KachelnetId, die "microsoft.base.road" oder "microsoft.base.darkgrey" ist. Unterstützen Sie den Zoomwertbereich von 0 bis 19 (einschließlich) für kacheletId, die "microsoft.imagery" ist. Der Standardwert ist 12.

Weitere Informationen finden Sie unter Zoomstufen und Kachelraster-.