Zum Inhalt

Query-Parameter

Alle statischen Bild-Endpunkte unterstützen zusätzlich die folgenden Query-Parameter:

Parameter         Beschreibung
path Pfad als kommagetrennte Longitude/Latitude-Paare oder im Google Encoded Polyline Format. Kann mehrfach angegeben werden. Optionen: fill, stroke, width.
latlng Gibt an, dass Koordinaten in der Reihenfolge Latitude,Longitude statt der üblichen Longitude,Latitude für Pfade und Marker angegeben werden.
fill Standardfarbe für die Füllung aller Pfade (z. B. red, rgba(255,255,255,0.5), #0000ff).
stroke Standardfarbe für die Kontur aller Pfade.
width Standardbreite der Kontur für alle Pfade.
linecap Darstellungsstil für die Start- und Endpunkte aller Pfade (siehe MDN).
linejoin Darstellungsstil für das Verbinden aufeinanderfolgender Segmente aller Pfade bei Richtungswechseln (siehe MDN).
border Farbe des optionalen Rahmens um alle Pfade.
borderwidth Breite des Rahmens (Standardwert 10 % der Konturbreite) für alle Pfade.
marker Marker im Format lng,lat|iconPath|option|option|.... Wird mit der unteren Mitte am angegebenen Standort dargestellt. lng,lat und iconPath sind erforderlich. Optionen: scale (Skalierungsfaktor), offset (Versatz als Pixelwert [offsetX],[offsetY]). Kann mehrfach angegeben werden.
padding Prozentualer Abstand für angepasste Endpunkte (flächenbasiertes und Pfad-Autofit).
maxzoom Maximale Zoomstufe (nur für den Auto-Endpunkt, bei dem die Zoomstufe berechnet wird).
format Bildformat für die Ausgabe des statischen Tileservers. Unterstützte Formate: png, jpg, webp.
scale Skalierungsfaktor für hochauflösende Bilder (z. B. 1x, 2x, 3x). Nützlich zum Erzeugen von Bildern in Retina-Qualität.
channel Optionales Freitext-Label, das mit der Anfrage zur clientseitigen Attribution protokolliert wird (z. B. channel=app). Hat keinen Einfluss auf das gerenderte Bild.

Path-Parameter

Der Parameter path definiert eine Menge von einem oder mehreren Standorten, die durch einen Pfad verbunden auf dem Kartenbild überlagert werden. Er erwartet eine Menge kommagetrennter Longitude,Latitude-Paare oder eine kodierte Polylinie im Google Encoded Polyline Format.

Beispiele: - Kommagetrennte Koordinaten: path=5.9,45.8|5.9,47.8|10.5,47.8|10.5,45.8|5.9,45.8 - Kodierte Polylinie: path=enc:_p~iF~ps|U_ulLnnqC_mqNvxq@`

Wird das Präfix enc: verwendet, gilt der Rest des Path-Parameters als Teil der kodierten Polyline-Zeichenfolge. Geben Sie in diesem Fall keine Koordinatenpaare an.

Der Pfad kann Styling-Optionen im Format (fill|stroke|width):value vor den Koordinaten oder der kodierten Polylinie enthalten.

Beispiele: - path=stroke:yellow|width:2|fill:green|5.9,45.8|5.9,47.8|10.5,47.8|10.5,45.8|5.9,45.8 - path=stroke:blue|width:1|fill:yellow|enc:_p~iF~ps|U_ulLnnqC_mqNvxq@`

Es können mehrere path-Parameter angegeben werden, um mehrere Pfade festzulegen.

Marker-Parameter

Der Parameter marker ermöglicht das Platzieren von Markern an bestimmten Standorten auf der Karte. Er erwartet eine Menge von Definitionen im Format lng,lat|iconPath|option|option|....

  • lng,lat gibt den Standort des Markers an. Der Marker wird mit seiner unteren Mitte an diesem Standort dargestellt.
  • iconPath ist entweder eine URL zu einem Marker-Bild oder ein Pfad zu einer Bilddatei relativ zum konfigurierten Icon-Verzeichnis auf dem Server. Sowohl lng,lat als auch iconPath sind erforderlich.
  • option liegt im Format name:value vor. Unterstützte Optionen:
    • scale – Skalierungsfaktor für das Marker-Bild (z. B. skaliert scale:0.5 das Bild auf die Hälfte seiner ursprünglichen Größe).
    • offset – Pixelversatz des Markers relativ zu den angegebenen lng,lat im Format [offsetX],[offsetY] (z. B. verschiebt offset:2,-4 den Marker 2 Pixel nach rechts und 4 Pixel nach oben).

Beispiel: marker=5.9,45.8|marker-icon.png|scale:0.5|offset:2,-4

Es können mehrere marker-Parameter angegeben werden, um mehrere Marker festzulegen.