Willkommen zur Entwicklerdokumentation für das Google Static Maps-API! Mit dem Google Static Maps-API können Sie ein Google Maps-Bild in Ihre Webseite einbetten, ohne dafür JavaScript oder eine dynamische Seitenladefunktion zu benötigen. Google Static Map erstellt Ihre Karte auf der Grundlage von URL-Parametern, die über eine Standard-HTTP-Anfrage gesendet werden. Sie erhalten Ihre Karte als Bild, das Sie in Ihre Webseite integrieren können.

Das Google Static Maps-API erfordert einen Maps-API-Schlüssel. Falls Sie dies noch nicht getan haben, melden Sie sich für einen kostenlosen API-Schlüssel an.

Neu! Das Google Static Maps-API bietet ab sofort Satellitenkacheln und Geländekacheln!

Kurzes Beispiel
Das folgende Beispiel enthält die URL eines statischen Kartenbildes von Lauenburg, das nachfolgend angezeigt wird:

#Es wurde der API key für tinte-4-u eingesetzt.
#Bitte setzen Sie hier ihren eigenen ein!




Es ist nicht notwendig, besondere Einstellungen vorzunehmen, damit das Bild auf der Seite angezeigt wird. Es ist kein JavaScript erforderlich. Es musste nur eine URL erstellt und innerhalb eines <img>-Tags platziert werden. Sie können eine statische Google-Karte überall auf Ihrer Webseite platzieren, wo Sie ein Bild einbinden können.

Inhalt

1. Zielgruppe
2. Grenzen der Verwendung
3. Übersicht
4. URL-Parameter
5. Verwendung der Parameter
   • Positionen angeben
     • Geografische Breiten- und Längenangaben
     • Geokodierung
   • Zoomstufen
   • Bildgrößen
   • Darstellungsbereich
   • Bildformate
   • Kartentypen
   • Markierungen hinzufügen
     • Markierungsbeschreibungen
     • Implizite Positionierung der Karte mithilfe von Markierungen
   • Static Map-Pfade
     • Pfadattribute
     • Pfadpunkte festlegen
6. Weitere Informationen

Zielgruppe

Dieses Dokument richtet sich an Website- und Handy-Entwickler, die Google Static Maps-API-Bilder in eine Webseite integrieren möchten. Es dient als Einführung zur Verwendung des API und als Referenzmaterial zu den verfügbaren Parametern.

Grenzen der Verwendung

zurück zum Start

Die Verwendung des Static Maps-API erfordert die Registrierung eines kostenlosen Maps-API-Schlüssels. Der Maps-API-Schlüssel ermöglicht Ihnen die Verwendung des Static Maps-API und des Standard-Maps-API.

Die Verwendung des Google Static Maps-API unterliegt einem Suchabfragenlimit von 1000 eindeutigen (unterschiedlichen) Bildanforderungen pro Betrachter pro Tag. Da diese Begrenzung ein Limit pro Betrachter und nicht pro Schlüssel ist, brauchen sich die meisten Entwickler keine Gedanken hinsichtlich eines Überschreitens ihres Limits zu machen. Beachten Sie außerdem, dass Anforderungen von identischen Bildern im Allgemeinen nicht über die ursprüngliche Anforderung hinausgehend für das Limit angerechnet werden.

Überschreitet ein Nutzer das oben festgelegte Limit, wird folgende Abbildung angezeigt. Sie weist darauf hin, dass die festgesetzte Quote überschritten wurde:



Dieses Limit besteht, um Missbrauch und/oder Zweckentfremdung des Static Maps-API zu verhindern, und kann jederzeit ohne Vorankündigung geändert werden. Wenn Sie diesen Wert innerhalb von 24 Stunden überschreiten oder den Service anderweitig missbrauchen, funktioniert das Static Maps-API möglicherweise vorübergehend nicht. Wenn Sie diese Beschränkung weiterhin überschreiten, kann Ihr Zugriff auf das Static Maps-API dauerhaft gesperrt werden.

Übersicht

zurück zum Start

Wurde über eine URL-Adresse eine HTTP-Anfrage gestellt, übermittelt das Google Static Maps-API als Antwort eine Bilddatei (GIF, PNG oder JPEG). Für jede Anforderung können Sie die Position der Karte, die Größe des Bildes, die Zoomstufe, den Kartentyp und die Platzierung optionaler Markierungen auf Positionen auf der Karte angeben. Sie können darüber hinaus Ihre Markierungen mit alphanumerischen Zeichen kennzeichnen. So können Sie sich in einem "Schlüssel" auf sie beziehen.

Sie betten ein Static Maps-API-Bild innerhalb einer Webseite in das src-Attribut des <img>-Tags ein. Wenn die Webseite angezeigt wird, ruft der Browser das Bild vom Static Maps-API ab und rendert es an der Bildposition.

Dieses Dokument beschreibt das erforderliche Format von Static Maps-API-URL-Adressen und den verfügbaren Parametern. Es verweist auch auf einige Tipps und Tricks beim Angeben Ihrer URL-Adressen.

URL-Parameter

zurück zum Start

Eine Google Static Maps-API-URL muss die folgende Form aufweisen:


Einige Parameter sind erforderlich, während andere optional sind. Wie standardmäßig in HTTP-Anforderungen werden alle Parameter durch kaufmännische Und-Zeichen (&) voneinander getrennt. Die Liste der Parameter und ihrer möglichen Werte ist nachfolgend aufgeführt.

Das Static Maps-API definiert Kartenbilder mithilfe der folgenden URL-Parameter:

• center (erforderlich, wenn keine Markierungen vorhanden sind) definiert die Kartenmitte, mit gleichem Abstand von allen Seiten der Karte. Dieser Parameter nimmt ein durch Komma getrenntes Paar {geografische Breite, geografische Länge} (z. B. "40.714728,-73.998672") auf, das eine eindeutige Position auf der Erdoberfläche repräsentiert. Weitere Informationen finden Sie nachfolgend unter Geografische Breiten- und Längenangaben.

• zoom (erforderlich, wenn keine Markierungen vorhanden sind) definiert die Zoomstufe der Karte, die die Vergrößerungsstufe der Karte festlegt. Dieser Parameter nimmt einen numerischen Wert entsprechend der Zoomstufe des gewünschten Bereichs an. Weitere Informationen finden Sie nachfolgend unter Zoomstufen.

• size (erforderlich) definiert die Abmessungen des Kartenbildes. Dieser Parameter nimmt eine Zeichenfolge der Form valuexvalue an, wobei horizontale Pixel an erster und vertikale Pixel an zweiter Stelle aufgeführt werden. Beispielsweise definiert 500x400 eine Karte mit 500 Pixel Breite und 400 Pixel Höhe. Erstellen Sie eine statische Karte, die 100 Pixel breit oder kleiner ist, wird das Logo "Powered by Google" ebenfalls verkleinert dargestellt.

• format(optional) legt das Format der erstellten Bilddatei fest. Das Static Maps-API erstellt standardmäßig GIF-Dateien. Zu den möglichen Bildformaten zählen die Formate GIF, JPEG und PNG. Welches Format für Sie geeignet ist, hängt davon ab, wie Sie das Bild auf Ihrer Seite präsentieren möchten. Das JPEG-Format geht mit einer stärkeren Komprimierung einher. In den Formaten GIF und PNG ist die Auflösung höher. Weitere Informationen finden Sie unter Bildformate.

• maptype (optional) definiert den Typ der zu erzeugenden Karte. Für den Kartentyp stehen Ihnen eine Anzahl unterschiedlicher Werte zur Verfügung, z. B. satellite, terrain, hybrid oder mobile. Weitere Informationen finden Sie nachfolgend unter Static Maps-API-Kartentypen.

• markers (optional) definiert eine oder mehrere Markierungen, die an den angegebenen Positionen zum Bild hinzugefügt werden. Dieser Parameter enthält einen String von Markierungsdefinitionen, die durch ein Pipe-Zeichen (|) voneinander getrennt werden. Beachten Sie, dass Sie beim Bereitstellen von Markierungen für eine Karte die (normalerweise erforderlichen) center- und zoom-Parameter nicht angeben müssen. Weitere Informationen finden Sie nachfolgend unter Static Map-Markierungen.

• path (optional) definiert einen einzelnen Pfad aus zwei oder mehr miteinander verbundenen Punkten, der an bestimmten Stellen auf dem Bild eingeblendet wird. Dieser Parameter enthält einen String von Punktdefinitionen, die durch ein Pipe-Zeichen (|) voneinander getrennt werden. Geben Sie einen Pfad für eine Karte an, müssen Sie die normalerweise erforderlichen Parameter center und zoom nicht definieren. Weitere Informationen finden Sie im Folgenden unter Static Map-Pfade.

• span (optional) definiert die Mindestgröße des Darstellungsbereichs für das Kartenbild. Der Bereich wird als Wertpaar Breitengrad/Längengrad angegeben. Static Map erstellt auf Grundlage dieses Werts eine Karte der entsprechenden Zoomstufe. Die Karte beinhaltet den vollständigen Wert span ausgehend vom Kartenmittelpunkt. Die erstellte Karte verwendet unter Umständen einen größeren Längen- oder Breitengrad als von Ihnen angegeben. Dies hängt von der Ausdehnung der rechteckigen Karte ab. Wurde zoom festgelegt, wird span ignoriert.

• frame (optional) legt fest, dass das erstellte Bild mit einem blauen Rahmen dargestellt wird. Der Rahmen ist 5 Pixel dick und hat eine Opazität von 55 %.

• hl (optional) legt die Sprache fest, in der die Kennzeichnungen auf Kartenkacheln wiedergegeben werden. Dieser Parameter wird nur für einige ausgewählte Länderkacheln unterstützt. Unterstützt der Kachelsatz Ihre gewünschte Sprache nicht, wird die Standardsprache für den jeweiligen Kachelsatz verwendet.

• key (erforderlich) identifiziert den Maps-API-Schlüssel für die Domain, auf der diese URL-Anforderung ausgeführt wird. Wenn Sie keinen Maps-API-Schlüssel besitzen, können Sie sich kostenlos für einen Schlüssel anmelden.

• sensor (erforderlich) legt fest, ob die Anwendung, die die statische Karte anfordert, einen Sensor verwendet, um den Standort des Nutzers zu ermitteln. Die Angabe dieses Parameters ist ab jetzt für jede Static Map-Anfrage zwingend. Weitere Informationen finden Sie nachfolgend im Abschnitt Sensoren.

Verwendung der Parameter

zurück zum Start

Das Static Maps-API ist relativ einfach zu verwenden, da es nur aus einer URL mit Parametern besteht. In diesem Abschnitt wird die Verwendung dieser Parameter zur Erstellung Ihrer URL-Adressen erklärt.

Positionen angeben

zurück zum Start

Das Static Maps-API muss die Positionen auf der Karte präzise identifizieren können, sowohl um die Karte an der korrekten Position zu zentrieren (mithilfe des center-Parameters) als auch um optionale Ortsmarken (mithilfe des markers-Parameters) auf Positionen auf der Karte zu setzen. Das Static Maps-API verwendet Breiten- und Längengradwerte, um diese Positionen anzugeben. Diese Werte ergeben zusammen eine geokodierte Position.

Nutzt Ihr Gerät einen "Sensor", beispielsweise ein GPS-Gerät, um den Standort eines anderen Gerätes oder eines Nutzers zu bestimmen, müssen Sie innerhalb der URL Ihrer Static Map-API-Anfrage auch sensor=true übergeben. Nutzt Ihre Anwendung keinen Sensor, übergeben Sie sensor=false.

Geografische Breiten- und Längenangaben

zurück zum Start

Breiten- und Längengrade werden mithilfe von Zahlen in einem durch Komma getrennten Textstring definiert, der eine Genauigkeit von bis zu sechs Dezimalstellen besitzt. Beispielsweise ist "40.714728,-73.998672" ein gültiger Geocode-Wert. Eine Genauigkeit über die sechs Dezimalstellen hinaus wird ignoriert.

Längengradwerte basieren auf der Entfernung vom Ort Greenwich in England, durch den der Nullmeridian verläuft. Da sich Greenwich auf der geografischen Breite 51.477222 befindet, können wir einen center-Wert von 51.477222,0 angeben, um die Karte über Greenwich zu zentrieren:



Die Werte für Breiten- und Längengrade müssen einer gültigen Position auf der Erdoberfläche entsprechen. Breitengradwerte können einen beliebigen Wert zwischen -90 und 90 annehmen, während Längengradwerte einen beliebigen Wert zwischen -180 und 180 annehmen können. Geben Sie einen ungültigen Wert für Breiten- oder Längengrad an, wird Ihre Anfrage als ungültige Anfrage zurückgewiesen.

Geokodierung

zurück zum Start

Die meisten Menschen denken nicht in Breiten- und Längengraden. Sie geben Positionen als Adressen an. Der Vorgang, eine Adresse in einen geografischen Punkt zu konvertieren, wird als Geokodierung bezeichnet. Nähere Informationen dazu finden Sie im Abschnitt Google Maps-API-Services. Möchten Sie den Geokodierungs-Dienst direkt nutzen, benötigen Sie einen Maps-API-Schlüssel.

Sie können geokodierte Längen- und Breitengradwerte neben diesem Geokodierungs-Service auch über eine Reihe weiterer Services erhalten, einschließlich Google Maps selbst. Sie können beispielsweise eine Adresse in Google Maps eingeben und ihre geokodierte Position durch Klicken auf URL zu dieser Seite in der oberen rechten Ecke der Karte ermitteln. Aus dem angezeigten Pop-up-Dialogfeld können Sie die URL kopieren. Wenn Sie diese URL in einen Browser kopieren, finden Sie die geokodierten Werte im Parameter ll.

Zoomstufen

zurück zum Start

Karten in Google Maps haben eine ganzzahlige "Zoomstufe", die die Auflösung der aktuellen Ansicht definiert. In der normalen Kartenansicht sind Zoomstufen zwischen 0 (die niedrigste Zoomstufe, bei der der Globus vollständig angezeigt wird) und 19 (die höchste Zoomstufe, bei der einzelne Gebäude zu sehen sind) möglich.

Google Maps legt die Zoomstufe auf 0 fest, um die gesamte Erde anzuzeigen. Jede folgende Zoomstufe verdoppelt die Genauigkeit horizontal und vertikal. Nähere Informationen hierzu finden Sie in der Google Maps-API-Dokumentation.

Hinweis: Nicht alle Zoomstufen werden für alle Positionen auf der Erde angezeigt. Die Zoomstufen hängen von der Position ab, die Sie betrachten. In bestimmten Regionen der Erde sind die Daten weniger genau als in anderen.

Wenn Sie eine Anforderung für eine Zoomstufe senden, in der keine Kartenkacheln vorhanden sind, gibt das Static Maps-API stattdessen ein schwarzes Bild zurück.

Im nachfolgenden Beispiel werden zwei Karten von Manhattan mit dem gleichen center-Wert, aber mit den Zoomstufen 12 und 14 angefordert:

Bildgrößen

zurück zum Start

Sie können Bilder bis zu einer Größe von 640 x 640 Pixel abrufen. Der Parameter size besteht aus einem String mit zwei Werten, die durch ein x voneinander getrennt sind. 640x640 ist die größtmögliche Bildgröße. Der Parameter center definiert in Kombination mit dem Parameter size implizit den Abdeckungsbereich des Kartenbildes.

Im nachfolgenden Beispiel wird ein Stück der Erde am Äquator in der Zoomstufe 1 angefordert:




Das nachfolgende Beispiel fordert eine kleine Karte der Größe 100 x 100 Pixel an, deren Mittelpunkt in derselben Gegend liegt. Sie sehen, dass das Google-Logo angepasst wurde:

Darstellungsbereiche

zurück zum Start

Bilder definieren unter Umständen einen Darstellungsbereich (Breiten- und Längengrade in Grad), der um einen bestimmten Mittelpunkt angezeigt wird. Dies geschieht durch die Angabe des Parameters span. Legen Sie auf diese Weise eine Mindestgröße für Ihren Darstellungsbereich fest, ist es nicht mehr notwendig, eine exakte Zoomstufe anzugeben. Der Static Map-Dienst verwendet den Parameter span in Kombination mit dem Parameter size, um eine Karte der entsprechenden Zoomstufe zu erstellen, die mindestens die zuvor festgelegten Begrenzungen des Darstellungsbereichs wiedergibt.

Das unten angeführte Beispiel verlangt eine quadratische Karte, die bei 0° Länge und 0° Breite und einer Höhe von 20° zentriert ist:




Das nächste Beispiel verlangt eine Karte mit Mittelpunkt Manhattan, die einen 1°-Bogen in beide Richtungen abbildet. Da diese Karte horizontal ausgerichtet ist, erstreckt sie sich horizontal über 4°. So kann sie in der vertikalen Ausdehnung die Mindestgröße von 1° einhalten.

Bildformate

zurück zum Start

Ihr Bild kann in einem der folgenden, gängigen Formate für Webgrafiken zurückgegeben werden: GIF, JPEG oder PNG. Der Parameter format hat einen der folgenden Werte:

• gif (Standard) legt als Bildformat GIF fest.

• jpg legt das Komprimierungsformat JPEG fest.

• jpg-baseline legt ein nicht progressives JPEG-Komprimierungsformat fest.

• png8 legt das Bildformat PNG (8 Bit) fest.

• png32 legt das Bildformat PNG (32 Bit) fest.

Mit den Parametern jpg und jpg-baseline rufen Sie die kleinstmögliche Bildgröße ab. Bei der Komprimierung kann jedoch die Bildqualität beeinträchtigt werden. Über gif, png8 und png32 erhalten Sie komprimierte Bilder ohne Qualitätsverlust.

Die meisten Bilder des Formats JPEG sind progressiv. Dies bedeutet, dass zunächst ein Bild mit schlechter Auflösung geladen wird, welches mit zunehmendem Dateneingang schärfer wird. Da Bilder so auf Webseiten schnell geladen werden können, wird das progressive JPEG-Format heute sehr oft genutzt. Einige Verwendungsweisen von JPEG-Bildern, vor allem das Drucken, erfordern jedoch nicht progressive Grundgrafiken. In solchen Fällen sollten Sie das nicht progressive Format jpg-baseline verwenden.

Kartentypen

zurück zum Start

Mit dem Google Static Maps-API können Sie Karten in unterschiedlichen Formaten erstellen, die nachfolgend aufgeführt sind:

• roadmap (Standard) zeigt eine Standardstraßenkarte an, wie sie normalerweise auf der Google Maps-Website zu sehen ist. Wenn kein maptype-Wert angegeben wurde, zeigt das Static Maps-API standardmäßig roadmap-Kacheln an.

• mobile definiert ein Straßenkarten-Bild für mobile Geräte. Symbole und Text sind größer dargestellt, entsprechend der höheren Auflösung und dem kleinen Bildschirm mobiler Geräte.

• satellite definiert ein Satellitenbild.

• terrain definiert eine physische Reliefkarte mit Gelände und Vegetation.

• hybrid definiert eine Hybridkarte aus Satellitenbild und Straßenkarte, mit einer transparenten Ebene auf dem Satellitenbild zur Einblendung großer Straßen und Plätze.

Das folgende Codebeispiel verdeutlicht den Unterschied zwischen einer normalen Straßenkarte und der Version für mobile Geräte. Für diese Karten gilt außerdem der Parameter frame=true.






Folgende Abbildungen zeigen Karten der Typen "Satellitenbild" und "Geländekarte":

Markierungen

zurück zum Start

Der markers-Parameter definiert eine oder mehrere Markierungen, die zum Kartenbild hinzugefügt werden. Dieser Parameter besteht aus bis zu 50 Markierungen, die durch einen Wertesatz definiert werden:

markers=markerDescriptor1|markerDescriptor2|markerDescriptor3|... usw.

Beachten Sie, dass Markierungsbeschreibungen durch ein Pipe-Zeichen (|) voneinander getrennt werden. (Hinweis: Das Pipe-Zeichen ist außerdem %7C in ASCII, falls Sie Ihre URL-Adressen kodieren.)

Markierungsbeschreibungen

zurück zum Start

Jede Markierungsbeschreibung enthält einen String, die die Position definiert, um die Markierung und die visuellen Attribute zu platzieren, wenn Sie die Markierung anzeigen. Diese Zeichenfolgen enthalten die folgenden Variablenwerte:

•{latitude} (erforderlich) gibt einen Breitengradwert mit einer Genauigkeit von bis zu sechs Dezimalstellen an.

•{longitude} (erforderlich) gibt einen Längengradwert mit einer Genauigkeit von bis zu sechs Dezimalstellen an.

•{size} (optional) definiert die Größe der Markierungen unter Verwendung des Wertesatzes {tiny, mid, small}. Wird der Parameter size nicht definiert, erscheint die Markierung in der Standardgröße (normal).

•{color} (optional) definiert eine Farbe unter Verwendung des Wertesatzes {black, brown, green, purple, yellow, blue, gray, orange, red, white}.

•{alphanumeric-character} (optional) definiert ein einziges kleingeschriebenes alphanumerisches Zeichen aus dem Satz {a - z, 0 - 9}. Der Parameter alphanumeric-character kann nur für Markierungen in Standardgröße oder Markierungen in der Größe mid definiert werden. Für Markierungen in den Größen tiny und small können keine alphanumerischen Zeichen definiert werden.

Die Längen- und Breitengradwerte definieren die Position der Markierung auf der Karte. Wenn sich die Position außerhalb der Karte befindet, wird die Markierung nicht auf dem erzeugten Bild angezeigt.

Die Werte für Größe, Farbe und alphanumerisches Zeichen definieren das visuelle Erscheinungsbild der Markierung. Wird kein Wert für die Größe angegeben, wird die Markierung in Standardgröße (normal) angezeigt. Die Markierungen in Standardgröße sind darüber hinaus die einzigen Markierungen, die alphanumerische Zeichen wiedergeben können. Wird kein Wert (bzw. ein falscher Wert) angegeben, wird die standardmäßig rot gepunktete Markierung eingeblendet:



Eine Beispielmarkierungsdeklaration erfolgt in der Form {latitude},{longitude},{size}{color}{alphanumeric-character}. Beachten Sie, dass die Werte für Größe, Farbe und alphanumerisches Zeichen innerhalb des Strings nicht durch Kommata getrennt werden. Nachfolgend finden Sie eine Beispielmarkierungsdeklaration.


Der Parameter markers definiert drei Markierungen (getrennt durch |): eine blaue Markierung mit der Bezeichnung "S" bei 40.702147,-74.015794, eine kleine grüne Markierung bei 40.711614,-74.012318 und eine mittelgroße gelbe Markierung mit der Bezeichnung "C" bei 40.713504,-74.005607 (Rathaus). Diese Markierungen werden im folgenden Beispiel gezeigt:

Implizite Positionierung der Karte mithilfe von Markierungen

zurück zum Start

Normalerweise ist es notwendig, dass Sie die URL-Parameter center und zoom festlegen, um den Standort und die Zoomstufe Ihrer Karte zu definieren. Wenn Sie jedoch einen markers-Parameter angeben, können Sie stattdessen das Static Maps-API die korrekte Mitte und Zoomstufe ermitteln lassen, basierend auf der Auswertung der Position dieser Markierungen.

Wenn Sie zwei oder mehr Markierungen angeben, ermittelt das Static Maps-API die korrekte Mitte und Zoomstufe und bietet großzügige Ränder zum Anzeigen der Markierungen, die im markers-Parameter enthalten sind. Im folgenden Beispiel sind die gleichen Markierungen wie oben enthalten, die Parameter center- und zoom wurden jedoch entfernt, um die Karte dichter an den beiden interessanten Markierungen zu zentrieren.

Static Map-Pfade

zurück zum Start

Der Parameter path definiert einen Satz von Pfaden, die auf das Kartenbild projiziert werden. Dieser Parameter besteht aus einer Liste von Pfaden, die durch einen Satz verschiedener Werte definiert werden:


Beachten Sie, dass Pfadpunkte durch ein Pipe-Zeichen (|) voneinander getrennt werden. (Das Pipe-Zeichen ist außerdem %7C in ASCII, falls Sie Ihre URL-Adressen kodieren.)

Pfadattribute

zurück zum Start

Jeder path-Parameter kann mit einem optionalen String beginnen, der die Attribute des Pfads festlegt. Dieser String besteht aus einem pathColorType und einem Wert für diesen Typ, der mit einem Doppelpunkt abgetrennt wird. Möchten Sie stattdessen die Standardattribute für Pfade verwenden, können Sie einfach das Präfix des Pfad-Attributs in der Pfadbeschreibung auslassen. Das erste Argument der Pfadbeschreibung stellt in diesem Fall den ersten Punkt der Pfaddeklaration dar. (Siehe Kapitel Pfadpunkte unten.)

Es gibt zwei mögliche Varianten für pathColorType:

• rgb definiert ein Standard-RGB-Farbschema, das eine Hexadezimalfarbe (24 Bit) der Art 0xffffff als pathColorValue verwendet. Die standardmäßig eingestellte Opazität für Pfade des Typs rgb beträgt 50 %.

• rgba definiert den Wert einer Hexadezimalfarbe (32 Bit) der Art 0xffffffff als pathColorValue. Das vierte Byte (die letzten beiden Zeichen) legt eine Alpha-Transparenz fest. Mit rgba können Sie die Transparenz aller Pfade, die Sie erstellen, anpassen.
Neben der Farbe legt weight die Stärke des Pfads in Pixel fest.

Hier einige Beispiele für Pfaddefinitionen:

• dünne, blaue Linie, 50 % Opazität:
• durchgezogene, rote Linie:
• durchgezogene, dicke, schwarze Linie:
Die Spezifizierung von Pfadattributen in der Pfadbeschreibung ist optional. Möchten Sie Standardattribute verwenden, müssen Sie die Pfadattribute nicht definieren. In diesem Fall ist das erste "Argument" der Pfadbeschreibung der erste festgelegte Punkt.

Pfadpunkte

zurück zum Start

Möchten Sie einen Pfad ziehen, müssen für den Parameter path zwei oder mehr Punkte angegeben werden. Das Google Static Maps-API erstellt dann den Pfad, indem es diese Punkte in der angegebenen Reihenfolge miteinander verbindet. Jeder pathPoint wird innerhalb des pathDescriptor angegeben und durch | voneinander getrennt. Wie auch bei Markierungen versucht das Google Static Maps-API nun auf Grundlage der impliziten Position des angegebenen Pfads den Standard-Mittelpunkt und die Standard-Zoomstufe der Karte zu ermitteln. Das gegenwärtige Limit für einen Pfad beträgt 100 Punkte.

Im folgenden Beispiel wurde ein blauer Pfad mit einer Standard-Opazität von 50 % definiert, der sich in New York vom Union Square bis zum Times Square erstreckt. Beachten Sie, dass die Parameter center und zoom nicht definiert werden mussten.



Hier sehen Sie die Spezifikationen des Parameters path:


Im folgenden Beispiel wird derselbe Pfad als durchgezogene, rote Linie mit einer Opazität von 100 % dargestellt:

Hier sehen Sie die Spezifikationen des Parameters path:
zurück zum Start
© Google Maps