Google Static Maps API, Version 2 – Entwicklerhandbuch

Willkommen zur Entwicklerdokumentation für das Google Static Maps-API! Mit dem Google Static Maps API können Sie ein Google Maps-Bild ohne JavaScript oder eine dynamische Seitenladefunktion in Ihre Webseite einbetten. Der Google Static Map-Dienst erstellt Ihre Karte basierend auf URL-Parametern, die über eine standardmäßige HTTP-Anfrage gesendet werden, und gibt die Karte als ein Bild wieder, das Sie auf Ihrer Webseite anzeigen können.

Hinweis: Für das Google Static Maps API ist kein Maps API-Schlüssel mehr erforderlich!

Kunden von Google Maps API Premier signieren stattdessen ihre URLs mithilfe eines kryptografischen Schlüssels, der ihnen zugesendet wird. Weitere Informationen finden Sie in der Premier-Dokumentation.

Neu! Der Google Static Maps-Dienst unterstützt jetzt benutzerdefinierte Markierungssymbole!

Wenn Sie lediglich vorhandene Static Maps-URLs für das neue API aktualisieren möchten, lesen Sie das Upgrade-Handbuch.

Kurzes Beispiel

Das folgende Beispiel zeigt die URL eines statischen Kartenbildes der Innenstadt von New York City, das unten abgebildet ist.

http://maps.google.com/maps/api/staticmap?center=Brooklyn+Bridge,New+York,NY&zoom=14&size=512x512&maptype=roadmap
&markers=color:blue%7Clabel:S%7C40.702147,-74.015794&markers=color:green%7Clabel:G%7C40.711614,-74.012318
&markers=color:red%7Ccolor:red%7Clabel:C%7C40.718217,-73.998284&sensor=false

Sie brauchen keine besondere Aktion durchzuführen, damit dieses Bild auf der Seite angezeigt wird. JavaScript ist nicht erforderlich. Wir haben lediglich eine URL erstellt und diese in einem <img>-Tag platziert. Sie können eine statische Karte von Google an einer beliebigen Stelle auf Ihrer Webseite platzieren, an der Sie ein Bild platzieren können.

Inhalt

Zielgruppe Grenzen der Verwendung Übersicht URL-Parameter Verwendung der Parameter Positionen angeben Geografische Breiten- und Längenangaben codieren Adressen Sensorverwendung angeben Zoomstufen Bildgrößen Bildformate Kartentypen Karten mit benutzerdefiniertem Stil Funktionsauswahl Stilvorgänge Markierungen hinzufügen Markierungsstile Markierungspositionen Benutzerdefinierte Symbole Static Map-Pfade Pfadstile Pfadpunkte angeben Codierte Polylinien Darstellungsbereiche Implizite Positionierung der Karte mithilfe von Markierungen Weitere Informationen

Zielgruppe

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

Nutzungsbegrenzungen

Für die Verwendung des Google Static Maps APIs gilt eine Suchanfragebegrenzung von 1000 eindeutigen (unterschiedlichen) Bildanforderungen pro Betrachter pro Tag. Da diese Einschränkung pro Betrachter gilt, brauchen sich die meisten Entwickler um die Einhaltung ihres Kontingents keine Sorgen zu machen. Beachten Sie jedoch, dass eine Begrenzung für zusätzliche Anfragen erzwungen wird, um einen Missbrauch des Dienstes zu verhindern. Anfragen identischer Bilder werden im Allgemeinen nur einmal gezählt.

Wenn ein Nutzer das oben genannte Limit überschreitet, wird als Hinweis das folgende Bild angezeigt:

Dieses Limit besteht, um Missbrauch und/oder Zweckentfremdung des Static Maps-APIs zu verhindern, und kann jederzeit ohne Vorankündigung geändert werden. Wenn Sie das 24-Stunden-Limit überschreiten oder den Dienst in anderer Weise missbrauchen, wird der Betrieb des Static Maps APIs für Sie möglicherweise vorübergehend eingestellt. Wenn Sie den Grenzwert weiterhin überschreiten, wird Ihr Zugriff auf das Static Maps API möglicherweise gesperrt.

Static Map-URLs dürfen maximal 2048 Zeichen lang sein. In der Praxis reicht diese URL-Länge in der Regel vollkommen aus, es sei denn, Sie erstellen komplexe Karten mit zahlreichen Markierungen und Pfaden. Beachten Sie jedoch, dass bestimmte Zeichen möglicherweise von Browsern bzw. Diensten URL-codiert werden, bevor sie an den Google Static Map-Dienst gesendet werden, was zu einer erhöhten Verwendung von Zeichen führt. Weitere Informationen erhalten Sie unter Erstellen einer gültigen URL.

Überblick

Das Google Static Maps API gibt als Antwort auf eine HTTP-Anfrage über eine URL ein Bild im Format GIF, PNG oder JPEG zurück. Bei jeder Anfrage können Sie den Standort der Karte angeben sowie die Größe des Bildes, die Zoomstufe, den Kartentyp und die Platzierung optionaler Markierungen an Standorten auf der Karte. Außerdem können Sie Ihre Markierungen mit alphanumerischen Zeichen beschriften, sodass Sie in einer Kartenlegende darauf verweisen können.

Die Einbettung eines Static Maps APIBildes in der Webseite erfolgt innerhalb des src-Attributes eines <img>-Tags. Wenn die Webseite angezeigt wird, ruft der Browser das Bild vom Static Maps-API ab und rendert es an der Bildposition. Statische Karten können nur in den Browser-Inhalt eingebettet dargestellt werden. Die Verwendung außerhalb des Browsers ist nicht zulässig. Bei Google Maps API Premier-Nutzern wird auf diese Anforderung verzichtet.

In diesem Dokument wird beschrieben, in welchem Format Static Maps API-URLs vorliegen müssen und welche Parameter verfügbar sind. Außerdem erhalten Sie einige Tipps und Tricks für das Festlegen von URLs.

URL-Parameter

URLs für das Google Static Maps API müssen folgende Form aufweisen:

http://maps.google.com/maps/api/staticmap?parameters

Falls der Zugriff auf Ihre Website über HTTPS erfolgt, ist es notwendig, dass Sie Google Static Map-Bilder ebenfalls über HTTPS laden, um Sicherheitswarnungen des Browsers zu vermeiden. Außerdem wird HTTPS empfohlen, wenn Ihre Anforderungen vertrauliche Nutzerinformationen enthalten, zum Beispiel den Nutzerstandort:

https://maps.googleapis.com/maps/api/staticmap?parameters

Beachten Sie, dass das Google Static Maps API URLs mit benutzerdefinierten Symbolen über HTTPS nicht unterstützt. Stattdessen wird das Standardsymbol angezeigt.

Sowohl bei HTTP als auch HTTPS sind bestimmte URL-Parameter erforderlich, während andere optional sind. Wie bei URLs üblich, werden alle Parameter durch kaufmännische Und-Zeichen (&) voneinander getrennt. Im Folgenden finden Sie die Liste der Parameter und ihre möglichen Werte.

Wichtig: In der folgenden Erläuterung von URL-Parametern werden Beispiele angeführt, die deutlichkeitshalber in ihrer Form vor der Umschreibung angegeben werden. Parameter sollten, bevor Anforderungen an das API gesendet werden, vollständig URL-codiert werden. Beispielsweise wird in vielen Parametern als Trennzeichen ein Pipe-Zeichen verwendet (|), das in der endgültigen URL als %7C codiert werden sollte, wie im Kurzbeispiel am Anfang dieses Dokuments dargestellt.

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

Positionsparameter:

• center (erforderlich, wenn keine Markierungen vorhanden sind) definiert die Kartenmitte, mit gleichem Abstand von allen Rändern der Karte. Dieser Parameter akzeptiert eine Positionsangabe in Form eines durch Komma getrennten Wertepaars ({breite,länge}, z. B. "40.714728,-73.998672") oder als Adress-String (z. B. "city hall, new york, ny") und erkennt sie als eindeutige Position auf der Erde. Weitere Informationen finden Sie im Folgenden unter Positionen.
• 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.

Kartenparameter:

• size (erforderlich): Legt die Größe der rechteckigen Form des Kartenbildes fest. Dieser Parameter wird als Zeichenfolge in der Form valuexvalue angegeben, erst die Pixelanzahl in horizontaler Richtung und dann die in vertikaler Richtung. Mit dem Wert 500x400 wird beispielsweise eine Karte mit einer Breite von 500 Pixeln und einer Höhe von 400 Pixeln definiert. Wenn Sie eine statische Karte erstellen, die maximal 100 Pixel breit ist, wird die Größe des Logos "Powered by Google" automatisch reduziert.
• format (optional): Gibt das Format für das Bild an. Das Static Maps-API erstellt standardmäßig PNG-Dateien. Es sind verschiedene Formate möglich, einschließlich GIF, JPEG und PNG. Welches Format Sie verwenden, hängt davon ab, wie das Bild dargestellt werden soll. JPEG bietet normalerweise eine stärkere Komprimierung, während GIF und PNG detailgetreuer sind. Weitere Informationen finden Sie unter Bildformate.
• maptype (optional): Legt den Typ der aufzubauenden Karte fest. Es gibt verschiedene Werte für den Kartentyp, wie roadmap, satellite, hybrid, und terrain. Weitere Informationen finden Sie nachfolgend unter Static Maps-API-Kartentypen.
• language (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.

Funktionsparameter:

• markers (optional) definiert eine oder mehrere Markierungen, die an den angegebenen Positionen zum Bild hinzugefügt werden. Dieser Parameter akzeptiert eine einzelne Markierungsdefinition, wobei die einzelnen Parameter durch ein Pipe-Zeichen (|) voneinander getrennt werden. Mehrere Markierungen können innerhalb eines markers-Parameters platziert werden, sofern sie denselben Stil aufweisen; weitere Markierungen mit anderen Stilen können durch zusätzliche markers-Parameter hinzugefügt werden. Beachten Sie, dass Sie beim Bereitstellen von Markierungen für eine Karte die (normalerweise erforderlichen) Parameter center und zoomnicht angeben müssen. Weitere Informationen finden Sie nachfolgend unter Static Maps-Markierungen.
• path (optional): Legt einen einzelnen Pfad fest, der zwei oder mehr Punkte miteinander verbindet und der bei angegebenen Standorten auf dem Bild dargestellt werden soll. Dieser Parameter wird als eine Zeichenfolge von Punktdefinitionen angegeben, die durch ein senkrechtes Strichsymbol (|) voneinander getrennt werden. Zusätzliche Pfade können durch weitere path-Parameter hinzugefügt 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.
• visible (optional) gibt mindestens eine Position an, die auf der Karte sichtbar bleiben soll, auch wenn keine Markierungen oder anderen Indikatoren angezeigt werden. Mit diesem Parameter können Sie sicherstellen, dass bestimmte Funktionen oder Kartenpositionen auf der statischen Karten angezeigt werden.
• style (optional): Definiert einen benutzerdefinierten Stil, um die Darstellung einer bestimmten Funktion (Straße, Park usw.) der Karte zu ändern. Dieser Parameter nimmt die Argumente feature und element an, um die auszuwählenden Funktionen und die auf diese Auswahl anzuwendende Gruppe von Stilvorgängen festzulegen. Sie können mehrere Stile bereitstellen, indem Sie weitere style-Parameter hinzufügen. Weitere Informationen finden Sie im Folgenden unter Karten mit benutzerdefinierten Stilen.

Berichtsparameter:

• 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 für jede Static Maps-Anfrage zwingend. Weitere Informationen finden Sie im Folgenden unter Sensorverwendung angeben.

Verwendung der Parameter

Das Static Maps API ist relativ einfach zu verwenden, da es lediglich aus einer URL mit Parametern besteht. In diesem Abschnitt wird erklärt, wie Sie Ihre URLs mithilfe dieser Parameter aufbauen.

Positionen angeben

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 der Karte zu positionieren. Das Static Maps-API verwendet Zahlenwerte (Breiten- und Längengradwerte) oder Strings (Adressen), um diese Positionen anzugeben. Diese Werte ergeben eine geocodierte Position.

Verschiedene Parameter (z. B. die Parameter markers und path) akzeptieren mehrere Positionsangaben. In diesen Fällen müssen die Positionsangaben durch ein Pipe-Zeichen (|) voneinander getrennt werden.

Geografische Breiten- und Längenangaben

Der Breiten- und Längengrad wird durch numerische Werte mit sechs Dezimalstellen innerhalb einer durch Komma getrennten Textzeichenfolge angegeben. "40.714728,-73.998672" wäre zum Beispiel ein gültiger Geocode-Wert. Genauere Angaben über die sechste Dezimalstelle hinaus werden ignoriert.

Die Längenangaben basieren auf der Entfernung von Greenwich in England, durch das der Nullmeridian verläuft. Da Greenwich beim Breitengradwert 51.477222 liegt, kann man für center den Wert 51.477222,0 eingeben, um die Karte bei Greenwich zu zentrieren:

Die Breiten- und Längenangaben müssen einem gültigen Standort auf der Erdoberfläche entsprechen. Für den Breitengrad können alle Werte zwischen -90 und 90 und für den Längengrad alle Werte zwischen -180 und 180 verwendet werden. Wenn Sie ungültige Breiten- oder Längenangaben machen, wird Ihre Anfrage als ungültig abgelehnt.

Adressen

Die meisten Menschen denken nicht in Breiten- und Längengraden. Sie geben Positionen als Adressen an. Die Umwandlung einer Adresse in einen geografischen Punkt wird als Geocodierung bezeichnet. Der Static Maps-Dienst kann bei Angabe gültiger Adresse die Geocodierung selbstständig durchführen.

Für jeden Parameter, der die Angabe von geografischer Breite u–nd Länge akzeptiert, können Sie stattdessen auch einen String mit der Adresse angeben. Die Adresse wird von Google geocodiert und dem Static Maps-Dienst als Wert für geografische Breite und Länge bereitgestellt, der zum Platzieren von Markierungen oder Angeben von Positionen verwendet wird. Die Zeichenfolge muss mit URL-Encoding codiert sein, das heißt, Adressen wie "City Hall, New York, NY" sollten in "City+Hall,New+York,NY" umgewandelt werden.

Adressen können entweder präzise Ortsangaben sein, z. B. Straßenadressen, Polylinien wie benannte Routen oder Polygonbereiche wie Orte, Länder oder Nationalparks. Für Polylinien- und Polygonergebnisse wird der Mittelpunkt der Linie bzw. des Bereichs als Adressmitte verwendet. Sollten Sie Zweifel bezüglich der Geocodierung einer Adresse haben, können Sie die Adresse mithilfe dieses Geocodierungs-Dienstprogramms testen.

Im folgenden Beispiel wird eine statische Karte von Berkeley, Kalifornien (USA), erzeugt:

http://maps.google.com/maps/api/staticmap?center=Berkeley,CA&zoom=14&size=400x400&sensor=false

Sensorverwendung angeben

Die Verwendung des Google Static Maps-APIs erfordert die Angabe, ob Ihre Anwendung einen Sensor (z. B. einen GPS-Peilsender) zur Standortbestimmung des Benutzers verwendet. Dies ist besonders für Mobilgeräte wichtig. Die Anwendungen müssen einen erforderlichen Sensorparameter übergeben, der angibt, ob sie ein Sensorgerät verwenden.

Anwendungen, die den Nutzerstandort mittels eines Sensors ermitteln, müssen sensor=true in der Anforderungs-URL des Static Maps-APIs übergeben. Nutzt Ihre Anwendung keinen Sensor, übergeben Sie sensor=false.

Zoomstufen

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

Von Google Maps wird die Zoomstufe 0 festgelegt, sodass die gesamte Erde in der Ansicht umfasst ist. Mit jeder nächsten Zoomstufe wird die Genauigkeit in horizontaler wie vertikaler Richtung verdoppelt. Weitere Informationen zur Umsetzung finden Sie in der Dokumentation zum Google Maps-API.

Hinweis: Nicht alle Zoomstufen sind für alle Standorte der Erde verfügbar. Die Zoomstufen variieren je nach Standort, da die Daten in einigen Gebieten der Erde granularer sind 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 leeres Bild zurück.

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

http://maps.google.com/maps/api/staticmap?center=40.714728,-73.998672&zoom=12&size=400x400&sensor=false
http://maps.google.com/maps/api/staticmap?center=40.714728,-73.998672&zoom=14&size=400x400&sensor=false

  

Bildgrößen

Die Bilder können in einer Größe von maximal 640 mal 640 Pixeln abgerufen werden. Der size-Parameter wird als Zeichenfolge aus zwei durch ein x-Zeichen getrennten Werten angegeben. 640x640 ist die maximal zulässige Bildgröße. Durch die Kombination aus center-Parameter und size-Parameter wird implizit das abgedeckte Gebiet des Kartenbildes bestimmt.

Im folgenden Beispiel wird ein Ausschnitt der Erde am Äquator mit Zoomstufe 1 angefordert:

http://maps.google.com/maps/api/staticmap?center=0,0&zoom=1&size=400x50&sensor=true_or_false

Im folgenden Beispiel wird eine kleine Karte der Größe 100 x 100 Pixel angefordert, die auf dieselbe Region zentriert ist. Beachten Sie das kleinere Google-Logo:

Bildformate

Bilder können in verschiedenen gebräuchlichen Webgrafikformaten zurückgegeben werden: GIF, JPEG und PNG. Der format-Parameter erfordert einen der folgenden Werte:

• png8 oder png (Standardeinstellung) gibt an, dass das 8-Bit-PNG-Format verwendet wird.
• png32 gibt an, dass das 32-Bit-PNG-Format verwendet wird.
• gif gibt an, dass das GIF-Format verwendet wird.
• jpg gibt an, dass das komprimierte JPEG-Format verwendet wird.
• jpg-baselinegibt an, dass das nicht progressive komprimierte JPEG-Format verwendet wird.

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. Dadurch können Bilder auf Webseiten zügig geladen werden. Dies ist die derzeit am meisten verbreitete Verwendungsart für JPEG. Für einige JPEG-Anwendungen, besonders zum Drucken, werden jedoch nicht progressive Bilder (Baseline-Bilder) benötigt. In diesen Fällen können Sie das nicht progressive jpg-baseline-Format verwenden.

Kartentypen

Das Google Static Maps API erstellt Karten in folgenden verschiedenen Formaten:

• roadmap (Standard): Bezeichnet ein standardmäßiges Straßenkartenbild, wie es gewöhnlich auf der Google Maps-Website angezeigt wird. Falls kein maptype-Wert angegeben ist, liefert das Static Maps API standardmäßig roadmap-Kacheln.
• satellite bezeichnet ein Satellitenbild.
• terrain bezeichnet ein Kartenbild mit einem physischen Relief, das das Gelände und die Vegetation wiedergibt.
• hybrid bezeichnet ein Hybridbild aus Satelliten- und Straßenkartenbild, bei dem eine transparente Schicht mit den wichtigsten Straßen und Plätzen über dem Satellitenbild eingeblendet wird.

Das folgende Codebeispiel verdeutlicht den Unterschied zwischen einer Straßenkarte und einer Geländekarte.

http://maps.google.com/maps/api/staticmap?center=40.714728,-73.998672&zoom=12&size=400x400&maptype=roadmap&sensor=true_or_false
http://maps.google.com/maps/api/staticmap?center=40.714728,-73.998672&zoom=12&size=400x400&maptype=terrain&sensor=true_or_false

  

Bei Hybridkarten werden Satellitenbilder und wichtige Punkte von Straßenkarten kombiniert. Die folgenden Abbildungen zeigen Karten der Typen "Satellitenbild" und "Hybridkarte":

http://maps.google.com/maps/api/staticmap?center=40.714728,-73.998672&zoom=12&size=400x400&maptype=satellite&sensor=true_or_false
http://maps.google.com/maps/api/staticmap?center=40.714728,-73.998672&zoom=12&size=400x400&maptype=hybrid&sensor=true_or_false

  

Karten mit benutzerdefinierten Stilen

Mithilfe von Karten mit benutzerdefinierten Stilen können Sie die Darstellung der standardmäßigen grundlegenden Google-Kartenstile anpassen, indem Sie zum Beispiel Straßen, Parks und bebaute Flächen in einem anderen visuellen Stil anzeigen als beim Standardkartentyp. Diese Komponenten werden als Funktionen bezeichnet. Mithilfe von Karten mit benutzerdefinierten Stilen können Sie solche Funktionen auswählen und visuelle Stile auf die Funktionsanzeige anwenden. Dazu gehört auch die Möglichkeit, Funktionen ganz auszublenden. Durch diese Änderungen können Sie auf der Karte bestimmte Komponenten betonen oder den Inhalt innerhalb der umgebenden Seite vervollständigen.

Eine benutzerdefinierte Karte mit einem Stil besteht aus mindestens einem festgelegten Stil. Jeder Stil wird durch einen style-Parameter innerhalb der Google Static Map-Anforderungs-URL angegeben. Weitere Stile werden durch das Übergeben zusätzlicher style-Parameter angegeben. Ein Stil besteht aus einer Auswahl und einer Gruppe von Regeln, die auf diese Auswahl zutreffen. Die Regeln geben an, welche visuellen Änderungen an der Auswahl erfolgen sollen.

Jede style-Deklaration besteht aus einem der folgenden Argumente, abgetrennt durch das Pipe-Zeichen ("|") innerhalb der style-Deklaration:

• feature (optional): Gibt an, welche Funktionen für diese Stiländerung ausgewählt werden sollen. Weitere Informationen erhalten Sie im Folgenden unter Kartenfunktionen. Falls kein feature-Argument übergeben wird, werden alle Funktionen ausgewählt.
• element (optional): Gibt an, welche Untergruppe der ausgewählten Funktionen ausgewählt werden soll. Weitere Informationen erhalten Sie im Folgenden unter Kartenelemente. Falls kein element-Argument übergeben wird, werden alle Elemente der entsprechenden Funktion ausgewählt.
• In allen nachfolgenden Argumenten werden die Regeln angegeben, die auf die obige Auswahl zutreffen sollen. Alle Regeln werden in der Reihenfolge angewendet, in der sie innerhalb der style-Deklaration aufgeführt werden. Weitere Informationen erhalten Sie im Folgenden unter Stilregeln. Einer Funktionsauswahl kann, innerhalb der normalen URL-Längenbeschränkungen des Google Static Maps APIs, eine beliebige Anzahl von Regeln folgen.

Beachten Sie, dass die style-Deklaration die obigen Argumente in der entsprechenden Reihenfolge angeben muss. Beispielsweise würde eine Funktionsauswahl mit zwei Regeln folgendermaßen aussehen:

style=feature:featureArgument|element:elementArgument|rule1:rule1Argument|rule2:rule2Argument

Kartenfunktionen

Eine Karte besteht aus einer Gruppe von Funktionen wie zum Beispiel Straßen oder Parks. Die Funktionstypen bilden eine Kategoriestruktur, wobei feature:all der Stamm ist. Im Folgenden werden einige häufige Funktionen aufgelistet:

• feature:all (Standardeinstellung): Wählt alle Funktionen der Karte aus.
• feature:road wählt alle Straßen auf der Karte aus.
• feature:landscape wählt alle Hintergrundlandschaften auf der Karte aus. Oft sind das zum Beispiel die Bereiche zwischen den Straßen. In Städten besteht eine Landschaft gewöhnlich aus bebauten Gebieten.

Die vollständige Liste der Funktionen, die in einer Karte zur Auswahl stehen, finden Sie in der Google Maps Javascript API, Version 3 – Referenz.

Einige Kategorien von Funktionstypen enthalten Unterkategorien, die in einer Schreibweise mit trennendem Punkt angegeben werden, zum Beispiel landscape.natural oder road.local. Wenn die übergeordnete Funktion angegeben wird, zum Beispiel road, werden die auf diese Auswahl angewendeten Stile auf alle Straßen angewendet, einschließlich der Unterkategorien.

Elemente von Kartenfunktionen

Des Weiteren bestehen einige Funktionen auf einer Karte normalerweise aus verschiedenen Elementen. Beispielsweise besteht eine Straße nicht nur aus der auf der Karte gezeichneten Linie (Geometrie), sondern auch aus dem auf der Karte angezeigten Text, der den Namen der Straße nennt (Labels). Elemente innerhalb von Funktionen werden durch die Deklaration eines element-Arguments ausgewählt. Für Argumente von Elementen werden die folgenden Werte unterstützt:

• element:all(Standardeinstellung): Wählt alle Elemente dieser Funktion aus.
• element:geometry: Wählt nur geometrische Elemente dieses Merkmals aus.
• element:labels: Wählt nur Textlabels aus, die diesem Merkmal zugewiesen sind.

Falls kein Argument für ein Element übergeben wird, werden die Stile unabhängig vom Typ des Elements auf alle Elemente der Funktion angewendet.

Mit der folgenden style-Deklaration werden die Labels für alle lokalen Straßen ausgewählt:

style=feature:road.local|element:labels

Stilregeln

Stilregeln sind Formatierungsoptionen, die auf die innerhalb der jeweiligen style-Deklaration angegebenen Funktionen und Elemente angewendet werden. Jede style-Deklaration muss mindestens einen Vorgang enthalten. Mehrere Vorgänge werden durch das Pipe-Zeichen ("|") voneinader getrennt. Jeder Vorgang gibt seinen Argumentwert mithilfe des Doppelpunktzeichens (":") an und alle Vorgänge werden in der angegebenen Reihenfolge auf die Auswahl angewendet.

Derzeit werden die folgenden Vorgangsargumente und annehmenden Werte unterstützt:

• hue (eine RGB-Hex-Zeichenfolge vom Format 0xRRGGBB): Zeigt die Grundfarbe für die Auswahl an. * Siehe nachfolgenden Hinweis zur Verwendung.
• lightness (ein Gleitpunktwert zwischen -100 und 100): Zeigt die Änderung der Helligkeit des Elements in Prozent an. Negative Werte erhöhen die Dunkelheit (Schwarz liegt bei -100), während positive Werte die Helligkeit erhöhen (Weiß liegt bei +100).
• saturation (ein Gleitpunktwert zwischen -100 und 100): Zeigt die Änderung der Intensität der Grundfarbe für das Element in Prozent an.
• gamma (ein Gleitpunktwert zwischen 0.01 und 10.0, wobei 1.0 keine Korrektur anwendet): Zeigt das Ausmaß der Gammakorrektur am Element an. Gammas ändern die Helligkeit von Farbtönen auf nicht lineare Art und Weise, wobei Weiß- oder Schwarzwerte nicht einbezogen werden. Gammas werden normalerweise zur Änderung des Kontrasts von mehreren Elementen verwendet. Sie können beispielsweise das Gamma ändern, um den Kontrast zwischen Rändern und Innenflächen des Elements zu erhöhen oder zu verringern. Niedrige Gammawerte (< 1) erhöhen den Kontrast, während hohe Werte (> 1) den Kontrast verringern.
• inverse_lightness:true kehrt die vorhandene Helligkeit einfach um.
• visibility (on, off oder simplified): Zeigt an, ob und wie das Element auf der Karte angezeigt wird. visibility:simplified: Zeigt an, dass die Karte die Darstellung dieser Elemente nach Bedarf vereinfachen sollte. In einer vereinfachten Straßenstruktur werden dann beispielsweise weniger Straßen angezeigt.

Stilregeln müssen als separate, unterscheidbare Vorgänge angewendet werden. Sie werden in der Reihenfolge angewendet, in der sie in der style-Deklaration vorkommen. Die Reihenfolge ist wichtig, da manche Vorgänge nicht kommutativ sind. Funktionen bzw. Elemente, die durch Stilvorgänge geändert werden, verfügen (in der Regel) bereits über Stile. Die Vorgänge werden, falls vorhanden, auf diese Stile angewendet.

Beachten Sie, dass zur Anzeige der Farbe in den Stilvorgängen das Hue, Saturation, Lightness (HSL)-Modell (Farbton, Sättigung, Helligkeit) verwendet wird. Diese Vorgänge zur Definition von Farbe sind im Grafikdesign üblich. Farbton zeigt die Grundfarbe an. Sättigung zeigt die Intensität dieser Farbe an. Helligkeit zeigt den relativen Anteil von Weiß oder Schwarz in der Grundfarbe an. Alle drei HSL-Werte können RGB-Werten zugeordnet werden (und umgekehrt). Gammakorrektur dient zur Änderung der Sättigung im gesamten Farbraum, in der Regel um den Kontrast zu erhöhen oder zu vermindern. Außerdem definiert das HSL-Modell die Farbe in einem Koordinatenraum, in dem hue (Farbton) die Ausrichtung innerhalb eines Farbkreises anzeigt, während Sättigung und Helligkeit die Amplituden entlang verschiedener Achsen anzeigen. Farbtöne werden innerhalb eines RGB-Farbraums gemessen, der den meisten RGB-Farbbereichen ähnelt, außer, dass Schwarz- und Weißschattierungen fehlen.

Ein RGB-Farbkreis

Hinweis: Der Farbton, hue, nimmt einen RGB-Hex-Farbwert an, verwendet diesen Wert jedoch nur zur Bestimmung der Grundfarbe (ihrer Ausrichtung im Farbkreis), nicht zur Bestimmung ihrer Sättigung oder Helligkeit. Diese werden separat als Änderungen in Prozent angegeben. Zum Beispiel kann der Farbton für Reines Grün als hue:0x00ff00 oder hue:0x000100 definiert werden und beide Farbtöne sind identisch. Beide Werte verweisen auf ein reines Grün im HSL-Farbmodell. RGB-hue-Werte, die zu gleichen Teilen aus Rot, Grün und Blau bestehen wie zum Beispiel hue:0x0000000 (Schwarz) und hue:0xffffff (Weiß) und alle reinen Schattierungen von Grau, zeigen auf keinen Fall einen Farbton an, da keiner dieser Werte eine Ausrichtung im HSL-Koordinatenraum angibt. Zur Angabe von Schwarz, Weiß oder Grau müssen alle saturation-Werte entfernt werden (saturation:-100-Vorgang hinzufügen) und stattdessen muss der lightness-Wert angepasst werden.

Außerdem werden beim Ändern vorhandener Funktionen, die bereits über ein Farbschema verfügen, durch das Ändern eines Wertes wie zum Beispiel hue die vorhandenen saturation- oder lightness-Werte nicht geändert.

Im folgenden Beispiel wird eine Karte von Brooklyn angezeigt, auf der die lokalen Straßen in Hellgrün geändert und die Wohngegenden in Schwarz geändert wurden. (Beachten Sie, dass in diesem vollständig bearbeiteten Beispiel die Pipe-Trennzeichen korrekt URL-encodiert sind; siehe Hinweis oben):

http://maps.google.com/maps/api/staticmap?sensor=false&size=512x512&center=Brooklyn&zoom=12&style=feature:road.local%7Celement:geometry%7Chue:0x00ff00%7Csaturation:100&style=feature:landscape%7Celement:geometry%7Clightness:-100

Das folgende komplexere Beispiel verwendet mehrere Stile und Vereinfachungen, um das Aussehen einer US-Straßenkarte zu imitieren:

http://maps.google.com/maps/api/staticmap?sensor=false&size=512x512&zoom=11&center=Chicago&style=feature:road.highway%7Celement:geometry%7Chue:0xff0022%7Csaturation:60%7Clightness:-20&style=feature:road.arterial%7Celement:geometry%7Chue:0x2200ff%7Clightness:-40:visibility:simplified%7Csaturation:30&style=feature:road.local%7Chue:0xf6ff00%7Csaturation:60%7Cgamma:0.7%7Cvisibility:simplified&style=feature:water%7Celement:geometry%7Csaturation:40%7Clightness:40&style=road.highway%7Celement:labels%7Cvisibility:on%7Csaturation:98&style=feature:administrative.locality%7Celement:labels%7Chue:0x0022ff%7Csaturation:50%7Clightness:-10%7Cgamma:0.9&style=feature:transit.line%7Celement:geometry%7Chue:0xff0000%7Cvisibility:on%7Clightness:-70

Markierungen

Der markers-Parameter definiert eine oder mehrere Markierungen an mehreren Standorten. Alle innerhalb einer markers-Deklaration definierten Markierungen müssen denselben Stil aufweisen; sollen Markierungen mit unterschiedlichen Stilen angezeigt werden, müssen Sie mehrere markers-Parameter mit individuellen Stilinformationen angeben.

Der markers-Parameter akzeptiert eine Gruppe von Wertzuweisungen (Markierungsbeschreibungen) im folgenden Format:

markers=markerStyles|markerLocation1| markerLocation2|... usw.

Die markerStyles-Gruppe wird am Anfang der markers-Deklaration deklariert und besteht aus null oder mehreren Stilbeschreibungen, die durch ein Pipe-Zeichen (|) voneinander getrennt sind, gefolgt von mindestens einer Positionsangabe, die ggf. ebenfalls durch ein Pipe-Zeichen (|) voneinander getrennt sind.

Da sowohl die Stil- als auch die Positionsangaben durch Pipe-Zeichen voneinander getrennt sind, müssen in Markierungsbeschreibungen generell zuerst die Stilinformationen aufgeführt werden. Trifft der Static Map-Server in der Markierungsbeschreibung auf eine Positionsangabe, werden alle weiteren Markierungsparameter ebenfalls wie Positionsangaben behandelt.

Markierungsstile

Bei den Markierungsstilbeschreibungen handelt es sich um eine Reihe von Wertzuweisungen, die durch ein Pipe-Zeichen (|) voneinander getrennt sind. In der Stilbeschreibung werden die visuellen Attribute definiert, die zur Darstellung der Markierungen in dieser Markierungsbeschreibung verwendet werden sollen. Diese Stilbeschreibungen enthalten die folgenden Schlüssel/Wert-Zuweisungen:

• size: (optional): Gibt die Größe der Markierung an; möglich sind {tiny, mid, small}. Wenn kein size-Parameter festgelegt wird, wird die Markierung in der Standardgröße ("normal") angezeigt.

• color: (optional) gibt eine 24-Bit-Farbe (z. B.: color=0xFFFFCC) oder eine vordefinierte Farbe aus der Gruppe {black, brown, green, purple, yellow, blue, gray, orange, red, white} an.

  Transparenzen (als 32-Bit-Farbwerte im Hexadezimalformat angegeben) werden in Markierungen nicht unterstützt, in Pfaden hingegen schon.

• label: (optional) definiert ein einziges großgeschriebenes alphanumerisches Zeichen aus dem Satz {a–z, 0–9}. Die Verwendung von Großbuchstaben ist in dieser Version des APIs erstmals erforderlich. Nur in Markierungen mit Standardgröße und mid-Größe kann ein alphanumeric-character-Parameter angezeigt werden. In Markierungen der Größe tiny und small kann kein alphanumerisches Zeichen angezeigt werden.

Hinweis: Anstelle dieser Markierungen können Sie auch eigene, benutzerdefinierte Symbole verwenden. Weitere Informationen finden Sie im Folgenden unter Benutzerdefinierte Symbole.

Markierungspositionen

Jede Markierungsbeschreibung muss einen Satz von mindestens einer Position enthalten, um festzulegen, wo die Markierung auf der Karte platziert werden soll. Diese Positionen können entweder als Werte für geografische Breite und Länge oder als Adressen angegeben werden. Die Positionsangaben werden durch ein Pipe-Zeichen (|) voneinander getrennt.

Die Positionsparameter definieren die Markierungsposition auf der Karte. Befindet sich die Position außerhalb des Kartenbereichs, erscheint die betreffende Markierung nicht auf dem fertigen Bild, sofern die Parameter center und zoom angegeben werden. Werden diese Parameter hingegen nicht angegeben, erzeugt der Static Map-Server automatisch ein Bild mit den angegebenen Markierungen. Weitere Informationen hierzu finden Sie auch im Abschnitt Implizite Positionierung weiter unten.

Nachfolgend finden Sie eine Beispielmarkierungsdeklaration. Beachten Sie, dass ein Satz von Stilen und drei Positionen definiert werden:

http://maps.google.com/maps/api/staticmap?center=Williamsburg,Brooklyn,NY&zoom=13&size=400x400&
markers=color:blue%7Clabel:S%7C11211%7C11206%7C11222&sensor=true_or_false

Zum Definieren von Markierungen mit unterschiedlichen Stilen müssen mehrere markers-Parameter bereitgestellt werden. Dieser Satz von markers-Parametern definiert drei Markierungen: eine blaue Markierung mit dem Label "S" bei 62.107733, -145.5419, eine kleine grüne Markierung bei "Delta Junction, AK" und eine mittelgroße gelbe Markierung mit dem Label "C" bei "Tok, AK". Diese Markierungen werden im folgenden Beispiel gezeigt:

http://maps.google.com/maps/api/staticmap?center=63.259591,-144.667969&zoom=6&size=400x400\
&markers=color:blue%7Clabel:S%7C62.107733,-145.541936&markers=size:tiny%7Ccolor:green%7CDelta+Junction,AK\
&markers=size:mid%7Ccolor:0xFFFF00%7Clabel:C%7CTok,AK&sensor=false" />

Benutzerdefinierte Symbole

Anstelle der Markierungssymbole von Google können Sie bei Bedarf Ihre eigenen, benutzerdefinierten Symbole verwenden. Benutzerdefinierte Symbole werden mithilfe der folgenden Beschreibungen im markers-Parameter festgelegt:

• icon gibt eine URL an, die als benutzerdefiniertes Symbol der Markierung verwendet werden soll. Die Bilder können in den Formaten PNG, JPEG oder GIF vorliegen; empfohlen wird PNG.
• shadow (Standard: true) gibt an, dass der Static Maps-Dienst einen geeigneten Schatten für das Bild erzeugen soll. Dieser Schatten basiert auf dem sichtbaren Bereich und der Deckkraft/Transparenz des Bildes.

Der icon-Parameter muss in Form einer URL angegeben werden; diese URL sollte URL-codiert sein. Sie können eine beliebige gültige URL verwenden oder einen URL-Kürzungsdienst wie http://bit.ly oder http://tinyurl.com nutzen. Die meisten URL-Kürzungsdienste bieten den Vorteil, dass sie URLs automatisch codieren. Die Größe der Symbole ist auf maximal 4096 Pixel beschränkt (64 x 64 Pixel bei quadratischen Bildern) und der Static Maps-Dienst erlaubt bis zu fünf verschiedene benutzerdefinierte Symbole pro Anfrage. Jedes dieser verschiedenen Symbole kann innerhalb der statischen Karte mehrfach verwendet werden.

Bei benutzerdefinierten Symbolen, die die Beschreibung shadow:true besitzen (Standard), wird als "Ankerpunkt" die untere Mitte des Symbolbildes festgelegt, von wo aus der Schatten geworfen wird. Symbole ohne Schatten, das heißt mit der Beschreibung shadow:false, werden dagegen mittig über dem betreffenden Standort angezeigt, das heißt den Ankerpunkt bildet der Mittelpunkt des Bildes.

Im folgenden Beispiel werden mit dem Chart API von Google benutzerdefinierte Markierungen für verschiedene Cafés in New York erstellt:

http://maps.google.com/maps/api/staticmap?size=480x480&markers=
icon:http://chart.apis.google.com/chart?chst=d_map_pin_icon%26chld=cafe%257C996600%7C
224+West+20th+Street+NY%7C75+9th+Ave+NY%7C700+E+9th+St+NY&sensor=true_or_false

Hinweis: Die mehrfachen Ebenen des Escape-Vorgangs oben können verwirrend sein. Das Google Chart API verwendet das Pipe-Zeichen (|) zur Trennung von Zeichenfolgen innerhalb seiner URL-Parameter. Da dieses Zeichen in einer URL nicht zulässig ist (siehe Hinweis oben), wird es beim Erstellen einer vollständig gültigen Chart-URL mit %7C umschrieben. Nun wird das Ergebnis als eine Zeichenfolge in eine icon-Spezifikation eingebettet, doch es enthält ein %-Zeichen (aus dem oben genannten %7C), das nicht direkt zu Daten in einer URL hinzugefügt werden kann und mit %25 umschrieben werden muss. Das hat zur Folge, dass die URL %257C enthält, was zwei Ebenen von Encoding darstellt. Ebenso enthält die Chart-URL ein &-Zeichen, das nicht direkt hinzugefügt werden kann, ohne mit einem Trennzeichen für URL-Parameter in statischen Karten verwechselt zu werden. Daher muss auch dieses Zeichen umschrieben werden.

So wird die URL für eine statische Karte erstellt:

# Intended chld parameter:
chld=cafe|996600

# Embedded in a fully valid chart URL:
http://chart.apis.google.com/chart?chst=d_map_pin_icon&chld=cafe%7C996600

# Intended icon parameter, containing a fully valid URL:
markers=icon:http://chart.apis.google.com/chart?chst=d_map_pin_icon&chld=cafe%7C996600

# Embedded in a valid and unambiguous static map URL:
...&markers=icon:http://chart.apis.google.com/chart?chst=d_map_pin_icon%26chld=cafe%257C996600

Static Map-Pfade

Der Parameter path definiert einen Satz von über einen Pfad miteinander verbundenen Positionen, die auf das Kartenbild projiziert werden. Der path-Parameter akzeptiert eine Gruppe von Wertzuweisungen (Pfadbeschreibungen) im folgenden Format:

path=pathStyles|pathLocation1|pathLocation2|... usw.

Beachten Sie, dass die beiden Pfadpunkte durch ein Pipe-Zeichen (|) voneinander getrennt werden. Da sowohl die Stil- als auch die Punktangaben durch Pipe-Zeichen voneinander getrennt sind, müssen in Pfadbeschreibungen generell zuerst die Stilinformationen aufgeführt werden. Trifft der Static Map-Server in der Pfadbeschreibung auf eine Positionsangabe, werden alle weiteren Pfadparameter ebenfalls wie Positionsangaben behandelt.

Pfadstile

Bei den Pfadstilbeschreibungen handelt es sich um eine Reihe von Wertzuweisungen, die durch ein Pipe-Zeichen (|) voneinander getrennt sind. Diese Stilbeschreibung definiert die visuellen Attribute, die zur Anzeige des Pfads verwendet werden sollen. Diese Stilbeschreibungen enthalten die folgenden Schlüssel/Wert-Zuweisungen:

• weight: (optional) bestimmte die Dicke des Pfads in Pixel. Wird der Parameter weight nicht definiert, erscheint der Pfad in der Standarddicke (5 Pixel).

• color: (optional) gibt eine Farbe als 24-Bit- (z. B. color=0xFFFFCC) oder 32-Bit-Wert (z. B. color=0xFFFFCCFF) im Hexadezimalformat oder aus dem Satz {black, brown, green, purple, yellow, blue, gray, orange, red, white} an.

  Bei Angabe eines hexadezimalen 32-Bit-Werts bestimmen die beiden letzten Zeichen den 8-Bit-Alphatransparenzwert. Dieser Wert variiert zwischen 00 (vollkommen transparent) und FF (vollkommen opak). Transparenzen werden in Pfaden nicht unterstützt, für Markierungen hingegen schon.

• fillcolor: (optional) gibt an, dass der Pfad eine Polygonfläche abgrenzt, und bestimmt die Füllfarbe für die Verwendung als Overlay in diesem Bereich. Die folgenden Positionen müssen keine geschlossene Schleife ergeben. Der Static Map-Server verbindet den ersten und den letzten Punkt automatisch miteinander. Beachten Sie jedoch, dass jeder Strich außerhalb des gefüllten Bereichs offen bleibt, falls Sie nicht dieselbe Anfangs- und Endposition angeben.

Im Folgenden finden Sie einige Beispiele für Pfaddefinitionen:

• dünne blaue Linie, 50 % Deckkraft: path=color:0x0000ff|weight:1
• rote Linie: path=color:0xff0000ff|weight:5
• dicke schwarze Linie: path=color:0xffffffff|weight:10

Diese Pfadstile sind 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 (Position).

Pfadpunkte

Zum Zeichnen eines Pfades müssen dem path-Parameter auch mindestens zwei Punkte übergeben 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.

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.

Die Angaben des path-Parameters lauten wie folgt:

path=color:0x0000ff|weight:5|40.737102,-73.990318|40.749825,-73.987963|40.752946,-73.987384|40.755823,-73.986397

Im folgenden Beispiel wird der gleiche Pfad stattdessen mit einer stärkeren roten Linie und mit 100 % Deckkraft definiert:

Die Angaben dieses path-Parameters lauten wie folgt:

path=color:0xff0000ff|weight:5|40.737102,-73.990318|40.749825,-73.987963|40.752946,-73.987384|40.755823,-73.986397

Im folgenden Beispiel wird ein Polygon in Manhattan definiert und eine Reihe von Kreuzungen als Positionen übergeben:

Die Angaben dieses path-Parameters lauten wie folgt:

path=color:0x00000000|weight:5|fillcolor:0xFFFF0033|8th+Avenue+%26+34th+St,New+York,NY|\
8th+Avenue+%26+42nd+St,New+York,NY|Park+Ave+%26+42nd+St,New+York,NY,NY|\
Park+Ave+%26+34th+St,New+York,NY,NY

Der Pfad selbst wird als unsichtbar definiert, für die Polygonfläche wird eine Opazität von 15 % festgelegt..

Codierte Polylinien

Anstelle einer Reihe von Positionen können Sie einen Pfad auch als codierte Polylinie deklarieren. Verwenden Sie dazu das Präfix enc: in der Positionsdeklaration der path-Angabe. Geben Sie einen codierten Polylinienpfad für eine Karte an, müssen Sie die normalerweise erforderlichen Parameter center und zoom nicht definieren.

Im folgenden Beispiel wird der Verlauf des Alaska Highway von Dawson Creek, BC, bis Delta Junction, AK, mithilfe einer codierten Polylinie dargestellt:

http://maps.google.com/maps/api/staticmap?size=400x400&path=weight:3%7Ccolor:orange%7Cenc:polyline_data

As with standard paths, encoded polyline paths may also demarcate polygonal areas if a fillcolor argument is passed to the path parameter.

The following example outlines a polygonal area for Brooklyn, NY:

http://maps.google.com/maps/api/staticmap?size=400x400&path=fillcolor:0xAA000033%7Ccolor:0xFFFFFF00%7C
enc:encoded_data

Darstellungsbereiche

Für Bilder kann ein Darstellungsbereich definiert werden, indem mithilfe des visible-Parameters sichtbare Positionen angegeben werden. Mit dem visible-Parameter wird der Static Maps-Dienst angewiesen, die Karte so zu erzeugen, dass die vorhandenen Positionen sichtbar bleiben. (Dieser Parameter kann auch mit vorhandenen Markierungen oder Pfaden kombiniert werden, um einen sichtbaren Bereich zu definieren.) Legen Sie auf diese Weise einen Darstellungsbereich fest, ist es nicht mehr notwendig, eine exakte Zoomstufe anzugeben.

Im folgenden Beispiel wird eine Karte angefordert, in deren Mitte Boston, MA, liegt und auf der außerdem das MIT und der Harvard Square in Cambridge, MA, sichtbar sind:

http://maps.google.com/maps/api/staticmap?center=Boston,MA
&visible=77+Massachusetts+Ave,Cambridge,MA%7CHarvard+Square,Cambridge,MA&size=512x512&sensor=true_or_false

Implizite Positionierung der Karte

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 den Parameter markers, path oder visible angeben, können Sie stattdessen das Static Maps-API die korrekte Mitte und Zoomstufe ermitteln lassen, basierend auf der Auswertung der Position dieser Elemente.

Wenn Sie zwei oder mehr Elemente angeben, ermittelt das Static Maps-API die korrekte Mitte und Zoomstufe und bietet großzügige Ränder für die enthaltenen Elemente. Im folgenden Beispiel sehen Sie eine Karte von San Francisco, Oakland und San Jose, Kalifornien:

http://maps.google.com/maps/api/staticmap?size=512x512&maptype=roadmap\
&markers=size:mid%7Ccolor:red%7CSan+Francisco,CA%7COakland,CA%7CSan+Jose,CA&sensor=false

Weitere Informationen

Weitere Informationen zur Verwendung des Static Maps-APIs oder anderer Google Maps-API-Produkte finden Sie in der Maps-API-Google-Gruppe.