RenderGetMapImageOptionalParams interface
Optionale Parameter.
- Extends
-
RequestOptionsBase
Eigenschaften
| bbox | Begrenzungsrahmen. Verwendete Projektion – EPSG:3857. Format: 'minLon, minLat, maxLon, maxLat'. Hinweis: Entweder bbox oder center sind erforderliche Parameter. Sie schließen sich gegenseitig aus. Es sollte nicht mit Höhe oder Breite verwendet werden. Die maximal zulässigen Bereiche für Lat und Lon werden für jede Zoomstufe in der Tabelle oben auf dieser Seite definiert. |
|||||||||||||||||||||||||||
| center | Koordinaten des Mittelpunkts. Format: 'lon,lat'. Verwendete Projektion
|
|||||||||||||||||||||||||||
| height | Höhe des resultierenden Bilds in Pixel. Der Bereich ist 1 bis 8192. Der Standardwert ist 512. Es sollte nicht mit bbox verwendet werden. |
|||||||||||||||||||||||||||
| language | Sprache, in der Suchergebnisse zurückgegeben werden sollen. Sollte eines der unterstützten IETF-Sprachtags sein, wobei die Groß-/Kleinschreibung nicht beachtet wird. 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ützte Sprachen . |
|||||||||||||||||||||||||||
| layer | Kartenebene angefordert. Wenn die Ebene auf Bezeichnungen oder Hybride festgelegt ist, sollte das Format png sein. Mögliche Werte: "basic", "hybrid", "labels" |
|||||||||||||||||||||||||||
| path | Pfadstil und Speicherorte. Verwenden Sie diesen Parameter, um dem Bild optional Linien, Polygone oder Kreise hinzuzufügen. Der Pfadstil beschreibt die Darstellung der Zeile und der Füllung. (Stellen Sie sicher, dass Die Werte dieses Parameters ordnungsgemäß URL codiert werden, da er reservierte Zeichen wie Pipes und Interpunktion enthält.) Der Pfadparameter wird in Azure Maps Konto-SKU ab S1 unterstützt. Mehrere Instanzen des Pfadparameters ermöglichen es, mehrere Geometrien mit ihren Stilen anzugeben. Die Anzahl der Parameter pro Anforderung ist auf 10 und die Anzahl der Speicherorte auf 100 pro Pfad beschränkt. Um einen Kreis mit Einem Radius von 100 Metern und Einem Mittelpunkt bei breiten 45°N und 122°W Längengrad im Standardformat zu rendern, fügen Sie den Parameter querystring hinzu.
Beachten Sie, dass der Längengrad vor dem Breitengrad liegt. Nach der URL-Codierung sieht dies wie folgt aus.
Alle hier aufgeführten Beispiele zeigen den Pfadparameter ohne URL-Codierung zur Übersichtlichkeit. Um eine Linie zu rendern, trennen Sie jede Position durch ein Pipezeichen. Verwenden Sie beispielsweise
Zum Rendern eines Polygons muss die letzte Position gleich dem Startort sein. Verwenden Sie beispielsweise
Längen- und Breitenwerte für Positionen von Linien und Polygonen können im Bereich von -360 bis 360 liegen, um das Rendern von Geometrien zu ermöglichen, die den Antimeridian überschreiten. StilmodifiziererSie können die Darstellung des Pfads ändern, indem Sie Formatmodifizierer hinzufügen. Diese werden vor den Speicherorten hinzugefügt. Stilmodifizierer haben jeweils einen Namen aus zwei Buchstaben. Diese abgekürzten Namen werden verwendet, um die Länge der URL zu verringern. Um die Farbe der Gliederung zu ändern, verwenden Sie den Formatmodifizierer "lc", und geben Sie die Farbe mit dem HTML/CSS-RGB-Farbformat an, das eine sechsstellige hexadezimale Zahl ist (die dreistellige Form wird nicht unterstützt). Um beispielsweise eine tief rosa Farbe zu verwenden, die Sie als #FF1493 in CSS angeben würden, verwenden Sie
Mehrere Stilmodifizierer können kombiniert werden, um einen komplexeren visuellen Stil zu erstellen.
Abrufen von Pfadspeicherorten aus Azure Maps DatenspeicherFür alle Azure Maps Konto-SKUs außer S0 können die Pfadspeicherortinformationen aus Azure Maps Datenspeicher abgerufen werden. Nach dem Hochladen eines GeoJSON-Dokuments mit Pfadspeicherorten gibt der Datenspeicherdienst eine eindeutige Daten-ID (UDID) zurück, die Sie verwenden können, um auf die Daten im Pfadparameter zu verweisen. Um die Punktgeometrie aus einem hochgeladenen GeoJSON-Dokument als Pfadpositionen zu verwenden, geben Sie die UDID im Abschnitt speicherorte des Pfadparameters an. Beispiel:
Beachten Sie, dass es nicht zulässig ist, Pfadspeicherorte aus Data Storage mit im Pfadparameter angegebenen Speicherorten zu mischen. Zusammenfassung des Formatmodifizierers
|
|||||||||||||||||||||||||||
| pins | Pushpin-Stil und -Instanzen. Verwenden Sie diesen Parameter, um dem Bild optional Pushpins hinzuzufügen. Der Druckstiftstil beschreibt das Aussehen der Druckstifte, und die Instanzen geben die Koordinaten der Druckstifte und optionale Bezeichnungen für jeden Pin an. (Stellen Sie sicher, dass Die Werte dieses Parameters ordnungsgemäß URL codiert werden, da er reservierte Zeichen wie Pipes und Interpunktion enthält.) Die S0-SKU des Azure Maps-Kontos unterstützt nur eine einzelne instance des Pins-Parameters. Andere SKUs ermöglichen es mehreren Instanzen des Pins-Parameters, mehrere Pinstile anzugeben. Fügen Sie den Querystring-Parameter hinzu, um einen Pushpin-Wert im Breitengrad 45°N und einem Längengrad von 122°W mithilfe des integrierten Standard-Pushpin-Stils zu rendern.
Beachten Sie, dass der Längengrad vor dem Breitengrad liegt. Nach der URL-Codierung sieht dies wie folgt aus.
Alle hier aufgeführten Beispiele zeigen den Pins-Parameter ohne URL-Codierung zur Übersichtlichkeit. Um einen Pin an mehreren Stellen zu rendern, trennen Sie jede Position mit einem Pipezeichen. Verwenden Sie beispielsweise
Die S0 Azure Maps Konto-SKU lässt nur fünf Pushpins zu. Für andere Konto-SKUs gilt diese Einschränkung nicht. StilmodifiziererSie können die Darstellung der Ortsmarken durch Hinzufügen von Stilmodifizierern ändern. Diese werden nach dem Format, aber vor den Speicherorten und Bezeichnungen hinzugefügt. Stilmodifizierer haben jeweils einen Namen aus zwei Buchstaben. Diese abgekürzten Namen werden verwendet, um die Länge der URL zu verringern. Um die Farbe der Drucknadel zu ändern, verwenden Sie den Formatmodifizierer "co", und geben Sie die Farbe mit dem HTML/CSS-RGB-Farbformat an, das eine sechsstellige hexadezimale Zahl ist (die dreistellige Form wird nicht unterstützt). Um beispielsweise eine tief rosa Farbe zu verwenden, die Sie als #FF1493 in CSS angeben würden, verwenden Sie
DrucknadelbeschriftungenUm den Pins eine Bezeichnung hinzuzufügen, setzen Sie die Bezeichnung in einzelne Anführungszeichen direkt vor den Koordinaten. Um beispielsweise drei Pins mit den Werten "1", "2" und "3" zu kennzeichnen, verwenden Sie
Es gibt einen integrierten Pushpin-Stil namens "none", der kein Pushpin-Image anzeigt. Sie können dies verwenden, wenn Sie Bezeichnungen ohne Anheften anzeigen möchten. Beispiel:
Um die Farbe der Druckpinbeschriftungen zu ändern, verwenden Sie den Farbformatmodifizierer "lc". Um z. B. rosa Druckpins mit schwarzen Etiketten zu verwenden, verwenden Sie
Um die Größe der Bezeichnungen zu ändern, verwenden Sie den Beschriftungsformatmodifizierer "ls". Die Bezeichnungsgröße stellt die ungefähre Höhe des Bezeichnungstexts in Pixel dar. Verwenden Sie beispielsweise, um die Bezeichnungsgröße auf 12 zu erhöhen.
Die Bezeichnungen werden am Drucknadel "Bezeichnungsanker" zentriert. Der Ankerstandort ist für integrierte Druckpins vordefiniert und befindet sich in der oberen Mitte der benutzerdefinierten Stecknadeln (siehe unten). Zum Überschreiben des Bezeichnungsankers verwenden Sie den Modifizierer "la" und geben X- und Y-Pixelkoordinaten für den Anker an. Diese Koordinaten sind relativ zur oberen linken Ecke des Drucknadelbilds. Positive X-Werte verschieben den Anker nach rechts, und positive Y-Werte verschieben den Anker nach unten. Verwenden Sie beispielsweise, um den Bezeichnungsanker 10 Pixel rechts und 4 Pixel über der oberen linken Ecke des Drucknadelbilds zu positionieren.
Benutzerdefinierte PushpinsUm ein benutzerdefiniertes Pushpin-Bild zu verwenden, verwenden Sie das Wort "custom" als Namen der Anheftformatvorlage, und geben Sie dann eine URL nach den Informationen zu Speicherort und Bezeichnung an. Verwenden Sie zwei Pipezeichen, um anzugeben, dass Sie mit der Angabe von Speicherorten fertig sind und die URL starten. Beispiel:
Nach der URL-Codierung würde dies wie folgt aussehen:
Standardmäßig werden benutzerdefinierte Druckstiftbilder zentriert an den Pinkoordinaten gezeichnet. Dies ist in der Regel nicht ideal, da es den Speicherort verschleiert, den Sie hervorheben möchten. Um die Ankerposition des Anheftbilds zu überschreiben, verwenden Sie den Formatmodifizierer "an". Dabei wird das gleiche Format wie der Ankermodifizierer "la" verwendet. Wenn Ihr benutzerdefiniertes Pinbild beispielsweise die Spitze der Pin in der oberen linken Ecke des Bilds aufweist, können Sie den Anker auf diese Stelle festlegen, indem Sie
Hinweis: Wenn Sie den Farbmodifizierer "co" mit einem benutzerdefinierten Pushpin-Bild verwenden, ersetzt die angegebene Farbe die RGB-Kanäle der Pixel im Bild, lässt jedoch den Alphakanal (Deckkraft) unverändert. Dies würde normalerweise nur mit einem benutzerdefinierten Einfarbig-Bild erfolgen. Abrufen von Pushpins aus Azure Maps DatenspeicherFür alle Azure Maps Konto-SKUs außer S0 können das Pushpin-Image und die Standortinformationen aus Azure Maps Datenspeicher abgerufen werden. Nach dem Hochladen eines Pushpin-Images oder eines GeoJSON-Dokuments mit Anheftungsspeicherorten gibt der Datenspeicherdienst eine eindeutige Daten-ID (UDID) zurück, die Sie verwenden können, um auf die Daten im Pins-Parameter zu verweisen. Um ein benutzerdefiniertes Pushpin-Image aus Azure Maps Data Storage zu verwenden, geben Sie das UDID-Präfix "udid-" als Namen des Pushpin-Stils an. Beispiel:
Um die Punktgeometrie aus einem hochgeladenen GeoJSON-Dokument als Pinpositionen zu verwenden, geben Sie die UDID im Abschnitt locations des Pins-Parameters an. Beispiel:
Beachten Sie, dass nur Punkt- und Mehrpunktgeometrie, Punkte und Mehrpunkte aus Geometrieauflistungen und Punktgeometrie aus Features verwendet werden. Linienzeichenfolgen- und Polygongeometrie werden ignoriert. Wenn der Punkt von einem Feature stammt und das Feature über eine Zeichenfolgeneigenschaft namens "label" verfügt, wird der Wert dieser Eigenschaft als Bezeichnung für den Pin verwendet. Sie können Pinspeicherorte aus datenspeicher- und anheften, die im Pins-Parameter angegeben sind. Jeder der durch Pipe getrennten Pin-Standorte kann längen- und breitengrad oder eine UDID sein. Beispiel:
Skalieren, Drehen und DeckkraftSie können Ortsmarken und ihre Bezeichnungen vergrößern oder verkleinern, indem Sie den Skalierungsmodifikator „sc“ verwenden. Dies ist ein Wert größer als 0. Der Wert 1 ist die Standardskalierung. Werte größer als 1 machen die Ortsmarken größer, und Werte kleiner als 1 machen sie kleiner. Verwenden Sie beispielsweise, um die Druckpins 50 % größer als normal zu zeichnen.
Sie können Pushpins und deren Bezeichnungen mithilfe des Modifizierers "ro" drehen. Dies ist eine Reihe von Graden der Drehung im Uhrzeigersinn. Verwenden Sie eine negative Zahl, um gegen den Uhrzeigersinn zu drehen. Verwenden Sie beispielsweise, um die Druckpins im Uhrzeigersinn um 90 Grad zu drehen und ihre Größe zu verdoppeln.
Sie können Pushpins und ihre Bezeichnungen teilweise transparent machen, indem Sie den Alpha-Modifizierer "al" angeben. Dies ist eine Zahl zwischen 0 und 1, die die Deckkraft der Stecknadeln angibt. Null macht sie vollständig transparent (und nicht sichtbar) und 1 macht sie vollständig undurchsichtig (die Standardeinstellung). Verwenden Sie beispielsweise, um Drucknadeln und ihre Bezeichnungen nur zu 67 % undurchsichtig zu machen.
Zusammenfassung des Formatmodifizierers
|
|||||||||||||||||||||||||||
| style | Zurückzugebende Kartenformatvorlage. Derzeit ist nur der verfügbare Stil Standard. Mögliche Werte: "Standard" |
|||||||||||||||||||||||||||
| view | Der View-Parameter gibt an, welcher Satz geopolitisch umstrittener Inhalte über Azure Maps-Dienste zurückgegeben wird, einschließlich Rahmen und Bezeichnungen, die auf der Karte angezeigt werden. Der View-Parameter (auch als "Benutzerregionsparameter" bezeichnet) zeigt die richtigen Karten für dieses Land/diese Region an. Standardmäßig ist der View-Parameter 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 „View“-Parameter für diesen Standort entsprechend festzulegen. Alternativ haben Sie die Möglichkeit, „View=Auto“ festzulegen, wodurch die Kartendaten basierend auf der IP-Adresse der Anforderung zurückgibt. Der Parameter View in Azure Maps muss in Übereinstimmung mit den geltenden Gesetzen des Landes verwendet werden, in dem Karten, Bilder und andere Daten sowie Inhalte dritter Parteien, auf die Sie über Azure Maps zugreifen dürfen, verfügbar gemacht werden. Beispiel: view=IN. Weitere Informationen und die verfügbaren Ansichten finden Sie unter Unterstützte Ansichten . |
|||||||||||||||||||||||||||
| width | Breite des resultierenden Bilds in Pixel. Der Bereich beträgt 1 bis 8192. Der Standardwert ist 512. Es sollte nicht mit bbox verwendet werden. |
|||||||||||||||||||||||||||
| zoom | Gewünschter Zoomfaktor der Karte. Der Zoomwert muss sich im Bereich von 0 bis 20 (einschließlich) bewegen. Der Standardwert ist 12. |
Geerbte Eigenschaften
| abort |
Das Signal, das zum Abbrechen von Anforderungen verwendet werden kann. |
| custom |
{object} [customHeaders] Benutzerdefinierte benutzerdefinierte Anforderungsheader, die angewendet werden, bevor die Anforderung gesendet wird. |
| on |
Rückruf, der beim Downloadfortschritt ausgelöst wird. |
| on |
Rückruf, der beim Hochladen des Fortschritts ausgelöst wird. |
| timeout | Die Anzahl von Millisekunden, die eine Anforderung dauern kann, bevor sie automatisch beendet wird. |
Details zur Eigenschaft
bbox
Begrenzungsrahmen. Verwendete Projektion – EPSG:3857. Format: 'minLon, minLat, maxLon, maxLat'. Hinweis: Entweder bbox oder center sind erforderliche Parameter. Sie schließen sich gegenseitig aus. Es sollte nicht mit Höhe oder Breite verwendet werden.
Die maximal zulässigen Bereiche für Lat und Lon werden für jede Zoomstufe in der Tabelle oben auf dieser Seite definiert.
bbox?: stringEigenschaftswert
string
center
Koordinaten des Mittelpunkts. Format: 'lon,lat'. Verwendete Projektion
- EPSG:3857. Längengrad: -180 bis 180. Breitenbereich: -85 bis 85. Hinweis: Entweder center oder bbox sind erforderliche Parameter. Sie schließen sich gegenseitig aus.
center?: stringEigenschaftswert
string
height
Höhe des resultierenden Bilds in Pixel. Der Bereich ist 1 bis 8192. Der Standardwert ist 512. Es sollte nicht mit bbox verwendet werden.
height?: numberEigenschaftswert
number
language
Sprache, in der Suchergebnisse zurückgegeben werden sollen. Sollte eines der unterstützten IETF-Sprachtags sein, wobei die Groß-/Kleinschreibung nicht beachtet wird. 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ützte Sprachen .
language?: stringEigenschaftswert
string
layer
Kartenebene angefordert. Wenn die Ebene auf Bezeichnungen oder Hybride festgelegt ist, sollte das Format png sein. Mögliche Werte: "basic", "hybrid", "labels"
layer?: StaticMapLayerEigenschaftswert
path
Pfadstil und Speicherorte. Verwenden Sie diesen Parameter, um dem Bild optional Linien, Polygone oder Kreise hinzuzufügen. Der Pfadstil beschreibt die Darstellung der Zeile und der Füllung. (Stellen Sie sicher, dass Die Werte dieses Parameters ordnungsgemäß URL codiert werden, da er reservierte Zeichen wie Pipes und Interpunktion enthält.) Der Pfadparameter wird in Azure Maps Konto-SKU ab S1 unterstützt. Mehrere Instanzen des Pfadparameters ermöglichen es, mehrere Geometrien mit ihren Stilen anzugeben. Die Anzahl der Parameter pro Anforderung ist auf 10 und die Anzahl der Speicherorte auf 100 pro Pfad beschränkt.
Um einen Kreis mit Einem Radius von 100 Metern und Einem Mittelpunkt bei breiten 45°N und 122°W Längengrad im Standardformat zu rendern, fügen Sie den Parameter querystring 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 zur Übersichtlichkeit.
Um eine Linie zu rendern, trennen Sie jede Position durch ein Pipezeichen. Verwenden Sie beispielsweise
path=||-122 45|-119.5 43.2|-121.67 47.12
Zum Rendern eines Polygons muss die letzte Position gleich dem Startort sein. Verwenden Sie beispielsweise
path=||-122 45|-119.5 43.2|-121.67 47.12|-122 45
Längen- und Breitenwerte für Positionen von Linien und Polygonen können im Bereich von -360 bis 360 liegen, um das Rendern von Geometrien zu ermöglichen, die den Antimeridian überschreiten.
Stilmodifizierer
Sie können die Darstellung des Pfads ändern, indem Sie Formatmodifizierer hinzufügen. Diese werden vor den Speicherorten hinzugefügt. Stilmodifizierer haben jeweils einen Namen aus zwei Buchstaben. Diese abgekürzten Namen werden verwendet, um die Länge der URL zu verringern.
Um die Farbe der Gliederung zu ändern, verwenden Sie den Formatmodifizierer "lc", und geben Sie die Farbe mit dem HTML/CSS-RGB-Farbformat an, das eine sechsstellige hexadezimale Zahl ist (die dreistellige Form wird nicht unterstützt). Um beispielsweise eine tief rosa Farbe zu verwenden, die Sie als #FF1493 in CSS angeben würden, verwenden Sie
path=lcFF1493||-122 45|-119.5 43.2
Mehrere Stilmodifizierer 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
Abrufen von Pfadspeicherorten aus Azure Maps Datenspeicher
Für alle Azure Maps Konto-SKUs außer S0 können die Pfadspeicherortinformationen aus Azure Maps Datenspeicher abgerufen werden. Nach dem Hochladen eines GeoJSON-Dokuments mit Pfadspeicherorten gibt der Datenspeicherdienst eine eindeutige Daten-ID (UDID) zurück, die Sie verwenden können, um auf die Daten im Pfadparameter zu verweisen.
Um die Punktgeometrie aus einem hochgeladenen GeoJSON-Dokument als Pfadpositionen zu verwenden, geben Sie die UDID im Abschnitt speicherorte des Pfadparameters an. Beispiel:
path=||udid-29dc105a-dee7-409f-a3f9-22b066ae4713
Beachten Sie, dass es nicht zulässig ist, Pfadspeicherorte aus Data Storage mit im Pfadparameter angegebenen Speicherorten zu mischen.
Zusammenfassung des Formatmodifizierers
| Modifizierer | BESCHREIBUNG | Range |
|---|---|---|
| Lc | Linienfarbe | 000000 bis FFFFFF |
| fc | Füllfarbe | 000000 bis FFFFFF |
| la | Linien alpha (Deckkraft) | 0 bis 1 |
| fa | Alpha ausfüllen (Deckkraft) | 0 bis 1 |
| Lw | Linienstärke | Größer als 0 |
| Ra | Kreisradius (Meter) | Größer als 0 |
path?: string[]Eigenschaftswert
string[]
pins
Pushpin-Stil und -Instanzen. Verwenden Sie diesen Parameter, um dem Bild optional Pushpins hinzuzufügen. Der Druckstiftstil beschreibt das Aussehen der Druckstifte, und die Instanzen geben die Koordinaten der Druckstifte und optionale Bezeichnungen für jeden Pin an. (Stellen Sie sicher, dass Die Werte dieses Parameters ordnungsgemäß URL codiert werden, da er reservierte Zeichen wie Pipes und Interpunktion enthält.) Die S0-SKU des Azure Maps-Kontos unterstützt nur eine einzelne instance des Pins-Parameters. Andere SKUs ermöglichen es mehreren Instanzen des Pins-Parameters, mehrere Pinstile anzugeben.
Fügen Sie den Querystring-Parameter hinzu, um einen Pushpin-Wert im Breitengrad 45°N und einem Längengrad von 122°W mithilfe des integrierten Standard-Pushpin-Stils 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 zur Übersichtlichkeit.
Um einen Pin an mehreren Stellen zu rendern, trennen Sie jede Position mit einem Pipezeichen. Verwenden Sie beispielsweise
pins=default||-122 45|-119.5 43.2|-121.67 47.12
Die S0 Azure Maps Konto-SKU lässt nur fünf Pushpins zu. Für andere Konto-SKUs gilt diese Einschränkung nicht.
Stilmodifizierer
Sie können die Darstellung der Ortsmarken durch Hinzufügen von Stilmodifizierern ändern. Diese werden nach dem Format, aber vor den Speicherorten und Bezeichnungen hinzugefügt. Stilmodifizierer haben jeweils einen Namen aus zwei Buchstaben. Diese abgekürzten Namen werden verwendet, um die Länge der URL zu verringern.
Um die Farbe der Drucknadel zu ändern, verwenden Sie den Formatmodifizierer "co", und geben Sie die Farbe mit dem HTML/CSS-RGB-Farbformat an, das eine sechsstellige hexadezimale Zahl ist (die dreistellige Form wird nicht unterstützt). Um beispielsweise eine tief rosa Farbe zu verwenden, die Sie als #FF1493 in CSS angeben würden, verwenden Sie
pins=default|coFF1493||-122 45
Drucknadelbeschriftungen
Um den Pins eine Bezeichnung hinzuzufügen, setzen Sie die Bezeichnung in einzelne Anführungszeichen direkt vor den Koordinaten. Um beispielsweise drei Pins mit den Werten "1", "2" und "3" zu kennzeichnen, verwenden Sie
pins=default||'1'-122 45|'2'-119.5 43.2|'3'-121.67 47.12
Es gibt einen integrierten Pushpin-Stil namens "none", der kein Pushpin-Image anzeigt. Sie können dies verwenden, wenn Sie Bezeichnungen ohne Anheften anzeigen möchten. Beispiel:
pins=none||'A'-122 45|'B'-119.5 43.2
Um die Farbe der Druckpinbeschriftungen zu ändern, verwenden Sie den Farbformatmodifizierer "lc". Um z. B. rosa Druckpins mit schwarzen Etiketten zu verwenden, verwenden Sie
pins=default|coFF1493|lc000000||-122 45
Um die Größe der Bezeichnungen zu ändern, verwenden Sie den Beschriftungsformatmodifizierer "ls". Die Bezeichnungsgröße stellt die ungefähre Höhe des Bezeichnungstexts in Pixel dar. Verwenden Sie beispielsweise, um die Bezeichnungsgröße auf 12 zu erhöhen.
pins=default|ls12||'A'-122 45|'B'-119 43
Die Bezeichnungen werden am Drucknadel "Bezeichnungsanker" zentriert. Der Ankerstandort ist für integrierte Druckpins vordefiniert und befindet sich in der oberen Mitte der benutzerdefinierten Stecknadeln (siehe unten). Zum Überschreiben des Bezeichnungsankers verwenden Sie den Modifizierer "la" und geben X- und Y-Pixelkoordinaten für den Anker an. Diese Koordinaten sind relativ zur oberen linken Ecke des Drucknadelbilds. Positive X-Werte verschieben den Anker nach rechts, und positive Y-Werte verschieben den Anker nach unten. Verwenden Sie beispielsweise, um den Bezeichnungsanker 10 Pixel rechts und 4 Pixel über der oberen linken Ecke des Drucknadelbilds zu positionieren.
pins=default|la10 -4||'A'-122 45|'B'-119 43
Benutzerdefinierte Pushpins
Um ein benutzerdefiniertes Pushpin-Bild zu verwenden, verwenden Sie das Wort "custom" als Namen der Anheftformatvorlage, und geben Sie dann eine URL nach den Informationen zu Speicherort und Bezeichnung an. 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 Druckstiftbilder zentriert an den Pinkoordinaten gezeichnet. Dies ist in der Regel nicht ideal, da es den Speicherort verschleiert, den Sie hervorheben möchten. Um die Ankerposition des Anheftbilds zu überschreiben, verwenden Sie den Formatmodifizierer "an". Dabei wird das gleiche Format wie der Ankermodifizierer "la" verwendet. Wenn Ihr benutzerdefiniertes Pinbild beispielsweise die Spitze der Pin in der oberen linken Ecke des Bilds aufweist, können Sie den Anker auf diese Stelle festlegen, indem Sie
pins=custom|an0 0||-122 45||http://contoso.com/pushpins/red.png
Hinweis: Wenn Sie den Farbmodifizierer "co" mit einem benutzerdefinierten Pushpin-Bild verwenden, ersetzt die angegebene Farbe die RGB-Kanäle der Pixel im Bild, lässt jedoch den Alphakanal (Deckkraft) unverändert. Dies würde normalerweise nur mit einem benutzerdefinierten Einfarbig-Bild erfolgen.
Abrufen von Pushpins aus Azure Maps Datenspeicher
Für alle Azure Maps Konto-SKUs außer S0 können das Pushpin-Image und die Standortinformationen aus Azure Maps Datenspeicher abgerufen werden. Nach dem Hochladen eines Pushpin-Images oder eines GeoJSON-Dokuments mit Anheftungsspeicherorten gibt der Datenspeicherdienst eine eindeutige Daten-ID (UDID) zurück, die Sie verwenden können, um auf die Daten im Pins-Parameter zu verweisen.
Um ein benutzerdefiniertes Pushpin-Image aus Azure Maps Data Storage zu verwenden, geben Sie das UDID-Präfix "udid-" als Namen des Pushpin-Stils an. Beispiel:
pins=udid-fe22c504-3a81-4fcd-adc6-a3507ce866c1||-122 45
Um die Punktgeometrie aus einem hochgeladenen GeoJSON-Dokument als Pinpositionen zu verwenden, geben Sie die UDID im Abschnitt locations des Pins-Parameters an. Beispiel:
pins=default||udid-29dc105a-dee7-409f-a3f9-22b066ae4713
Beachten Sie, dass nur Punkt- und Mehrpunktgeometrie, Punkte und Mehrpunkte aus Geometrieauflistungen und Punktgeometrie aus Features verwendet werden. Linienzeichenfolgen- und Polygongeometrie werden ignoriert. Wenn der Punkt von einem Feature stammt und das Feature über eine Zeichenfolgeneigenschaft namens "label" verfügt, wird der Wert dieser Eigenschaft als Bezeichnung für den Pin verwendet.
Sie können Pinspeicherorte aus datenspeicher- und anheften, die im Pins-Parameter angegeben sind. Jeder der durch Pipe getrennten Pin-Standorte kann längen- und breitengrad oder eine UDID sein. Beispiel:
pins=default||-122 45|udid-29dc105a-dee7-409f-a3f9-22b066ae4713|-119 43
Skalieren, Drehen und Deckkraft
Sie können Ortsmarken und ihre Bezeichnungen vergrößern oder verkleinern, indem Sie den Skalierungsmodifikator „sc“ verwenden. Dies ist ein Wert größer als 0. Der Wert 1 ist die Standardskalierung. Werte größer als 1 machen die Ortsmarken größer, und Werte kleiner als 1 machen sie kleiner. Verwenden Sie beispielsweise, um die Druckpins 50 % größer als normal zu zeichnen.
pins=default|sc1.5||-122 45
Sie können Pushpins und deren Bezeichnungen mithilfe des Modifizierers "ro" drehen. Dies ist eine Reihe von Graden der Drehung im Uhrzeigersinn. Verwenden Sie eine negative Zahl, um gegen den Uhrzeigersinn zu drehen. Verwenden Sie beispielsweise, um die Druckpins im Uhrzeigersinn um 90 Grad zu drehen und ihre Größe zu verdoppeln.
pins=default|ro90|sc2||-122 45
Sie können Pushpins und ihre Bezeichnungen teilweise transparent machen, indem Sie den Alpha-Modifizierer "al" angeben. Dies ist eine Zahl zwischen 0 und 1, die die Deckkraft der Stecknadeln angibt. Null macht sie vollständig transparent (und nicht sichtbar) und 1 macht sie vollständig undurchsichtig (die Standardeinstellung). Verwenden Sie beispielsweise, um Drucknadeln und ihre Bezeichnungen nur zu 67 % undurchsichtig zu machen.
pins=default|al.67||-122 45
Zusammenfassung des Formatmodifizierers
| Modifizierer | BESCHREIBUNG | Range |
|---|---|---|
| al | Alpha (Deckkraft) | 0 bis 1 |
| ein | Anker anheften | * |
| co | Farbe anheften | 000000 bis FFFFFF |
| la | Bezeichnungsanker | * |
| Lc | Beschriftungsfarbe | 000000 bis FFFFFF |
| ls | Bezeichnungsgröße | Größer als 0 |
| ro | Drehung | -360 bis 360 |
| Sc | Skalieren | Größer als 0 |
- X- und Y-Koordinaten können sich an einer beliebigen Stelle innerhalb des Pinbilds oder an einem Rand um das Bild befinden. Die Randgröße ist das Minimum der Stiftbreite und -höhe.
pins?: string[]Eigenschaftswert
string[]
style
Zurückzugebende Kartenformatvorlage. Derzeit ist nur der verfügbare Stil Standard. Mögliche Werte: "Standard"
style?: StyleEigenschaftswert
view
Der View-Parameter gibt an, welcher Satz geopolitisch umstrittener Inhalte über Azure Maps-Dienste zurückgegeben wird, einschließlich Rahmen und Bezeichnungen, die auf der Karte angezeigt werden. Der View-Parameter (auch als "Benutzerregionsparameter" bezeichnet) zeigt die richtigen Karten für dieses Land/diese Region an. Standardmäßig ist der View-Parameter 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 „View“-Parameter für diesen Standort entsprechend festzulegen. Alternativ haben Sie die Möglichkeit, „View=Auto“ festzulegen, wodurch die Kartendaten basierend auf der IP-Adresse der Anforderung zurückgibt. Der Parameter View in Azure Maps muss in Übereinstimmung mit den geltenden Gesetzen des Landes verwendet werden, in dem Karten, Bilder und andere Daten sowie Inhalte dritter Parteien, auf die Sie über Azure Maps zugreifen dürfen, verfügbar gemacht werden. Beispiel: view=IN. Weitere Informationen und die verfügbaren Ansichten finden Sie unter Unterstützte Ansichten .
view?: stringEigenschaftswert
string
width
Breite des resultierenden Bilds in Pixel. Der Bereich beträgt 1 bis 8192. Der Standardwert ist 512. Es sollte nicht mit bbox verwendet werden.
width?: numberEigenschaftswert
number
zoom
Gewünschter Zoomfaktor der Karte. Der Zoomwert muss sich im Bereich von 0 bis 20 (einschließlich) bewegen. Der Standardwert ist 12.
Weitere Informationen finden Sie unter Zoomstufen und Kachelraster .
zoom?: numberEigenschaftswert
number
Geerbte Eigenschaftsdetails
abortSignal
Das Signal, das zum Abbrechen von Anforderungen verwendet werden kann.
abortSignal?: AbortSignalLikeEigenschaftswert
AbortSignalLike
Geerbt von RequestOptionsBase.abortSignal
customHeaders
{object} [customHeaders] Benutzerdefinierte benutzerdefinierte Anforderungsheader, die angewendet werden, bevor die Anforderung gesendet wird.
customHeaders?: [key: string]: stringEigenschaftswert
[key: string]: string
Geerbt von RequestOptionsBase.customHeaders
onDownloadProgress
Rückruf, der beim Downloadfortschritt ausgelöst wird.
onDownloadProgress?: (progress: TransferProgressEvent) => voidEigenschaftswert
(progress: TransferProgressEvent) => void
Geerbt von RequestOptionsBase.onDownloadProgress
onUploadProgress
Rückruf, der beim Hochladen des Fortschritts ausgelöst wird.
onUploadProgress?: (progress: TransferProgressEvent) => voidEigenschaftswert
(progress: TransferProgressEvent) => void
Geerbt von RequestOptionsBase.onUploadProgress
timeout
Die Anzahl von Millisekunden, die eine Anforderung dauern kann, bevor sie automatisch beendet wird.
timeout?: numberEigenschaftswert
number
Geerbt von RequestOptionsBase.timeout