Class StaticMap

StaticMap

Ermöglicht die Erstellung und Dekoration statischer Kartenbilder.

Das folgende Beispiel zeigt, wie Sie mit dieser Klasse eine Karte des New York City Theatre District mit Bahnhöfen in der Nähe erstellen und in einer einfachen Web-App anzeigen können.

// Create a map centered on Times Square.
var map = Maps.newStaticMap()
    .setSize(600, 600)
    .setCenter('Times Square, New York, NY');

// Add markers for the nearbye train stations.
map.setMarkerStyle(Maps.StaticMap.MarkerSize.MID, Maps.StaticMap.Color.RED, 'T');
map.addMarker('Grand Central Station, New York, NY');
map.addMarker('Penn Station, New York, NY');

// Show the boundaries of the Theatre District.
var corners = [
  '8th Ave & 53rd St, New York, NY',
  '6th Ave & 53rd St, New York, NY',
  '6th Ave & 40th St, New York, NY',
  '8th Ave & 40th St, New York, NY'
];
map.setPathStyle(4, Maps.StaticMap.Color.BLACK, Maps.StaticMap.Color.BLUE);
map.beginPath();
for (var i = 0; i < corners.length; i++) {
  map.addAddress(corners[i]);
}
// All static map URLs require an API key.
var url = map.getMapUrl() + "&key=YOUR_API_KEY";

Weitere Informationen

• Google Static Maps API

Methoden

Methode	Rückgabetyp	Kurzbeschreibung
addAddress(address)	StaticMap	Fügt der aktuellen Pfaddefinition eine neue Adresse hinzu.
addMarker(latitude, longitude)	StaticMap	Fügt der Karte eine Markierung mithilfe eines Punkts (lat/lng) hinzu.
addMarker(address)	StaticMap	Fügt der Karte eine Markierung mithilfe einer Adresse hinzu.
addPath(points)	StaticMap	Fügt der Karte mithilfe eines Arrays von Punkten einen Pfad hinzu.
addPath(polyline)	StaticMap	Fügt der Karte mithilfe einer codierten Polylinie einen Pfad hinzu.
addPoint(latitude, longitude)	StaticMap	Fügt der aktuellen Pfaddefinition einen neuen Punkt (lat/lng) hinzu.
addVisible(latitude, longitude)	StaticMap	Fügt einen Punkt (lat/lng) hinzu, der auf der Karte sichtbar sein muss.
addVisible(address)	StaticMap	Fügt eine Adresse hinzu, die auf der Karte sichtbar sein muss.
beginPath()	StaticMap	Startet eine neue Pfaddefinition.
clearMarkers()	StaticMap	Löscht die aktuelle Gruppe von Markierungen.
clearPaths()	StaticMap	Aktuelle Pfade löschen.
clearVisibles()	StaticMap	Löscht die aktuell sichtbaren Standorte
endPath()	StaticMap	Vervollständigt eine Pfaddefinition, die mit beginPath() beginnt.
getAs(contentType)	Blob	Gibt die Daten in diesem Objekt als Blob zurück, das in den angegebenen Inhaltstyp konvertiert wurde.
getBlob()	Blob	Ruft die Bilddaten als Blob ab.
getMapImage()	Byte[]	Ruft die Rohdaten des Bildes als Byte-Array ab.
getMapUrl()	String	Ruft die URL des Kartenbildes ab.
setCenter(latitude, longitude)	StaticMap	Legt den Mittelpunkt der Karte mithilfe eines Punkts (lat/lng) fest.
setCenter(address)	StaticMap	Legt die Mitte der Karte anhand einer Adresse fest.
setCustomMarkerStyle(imageUrl, useShadow)	StaticMap	Legt das benutzerdefinierte Markierungsbild fest, das beim Erstellen neuer Markierungen verwendet werden soll.
setFormat(format)	StaticMap	Legt das Format des Kartenbildes fest.
setLanguage(language)	StaticMap	Legt die Sprache fest, die für Text auf der Karte verwendet werden soll (wo verfügbar).
setMapType(mapType)	StaticMap	Legt den Typ der anzuzeigenden Karte fest.
setMarkerStyle(size, color, label)	StaticMap	Legt den Markierungsstil fest, der beim Erstellen neuer Markierungen verwendet werden soll.
setMobile(useMobileTiles)	StaticMap	Legt fest, ob spezielle Kachelsätze für Mobilgeräte verwendet werden sollen.
setPathStyle(weight, color, fillColor)	StaticMap	Legt den Pfadstil fest, der beim Erstellen neuer Pfade verwendet werden soll.
setSize(width, height)	StaticMap	Legt die Breite und Höhe des Kartenbildes in Pixeln fest.
setZoom(zoom)	StaticMap	Legt den Zoomfaktor oder die Vergrößerungsstufe fest, der für die Karte verwendet wird.

Detaillierte Dokumentation

addAddress(address)

Fügt der aktuellen Pfaddefinition eine neue Adresse hinzu.

// Creates a map and adds a path from New York to Boston.
var map = Maps.newStaticMap()
    .beginPath()
    .addAddress('New York, NY')
    .addAddress('Boston, MA')
    .endPath();

Parameter

Name	Typ	Beschreibung
address	String	Eine hinzuzufügende Adresse.

Return

StaticMap: Diese Karteninstanz für Verkettungen.

---

addMarker(latitude, longitude)

Fügt der Karte eine Markierung mithilfe eines Punkts (lat/lng) hinzu.

// Creates a map and adds a marker at the specified coordinates.
var map = Maps.newStaticMap().addMarker(40.741799, -74.004207);

Parameter

Name	Typ	Beschreibung
latitude	Number	Der Breitengrad der neuen Markierung.
longitude	Number	Der Längengrad der neuen Markierung.

Return

StaticMap: Diese Karteninstanz für Verkettungen.

Weitere Informationen

• Google Static Maps API

---

addMarker(address)

Fügt der Karte eine Markierung mithilfe einer Adresse hinzu.

// Creates a map and adds a marker at the specified address.
var map = Maps.newStaticMap().addMarker('76 9th Ave, New York NY');

Parameter

Name	Typ	Beschreibung
address	String	Die Adresse, an der die neue Markierung platziert werden soll.

Return

StaticMap: Diese Karteninstanz für Verkettungen.

Weitere Informationen

• Google Static Maps API

---

addPath(points)

Fügt der Karte mithilfe eines Arrays von Punkten einen Pfad hinzu.

// Creates a map and adds a path from New York to Boston.
var map = Maps.newStaticMap()
    .addPath([40.714353, -74.005973, 42.358431, -71.059773]);

Parameter

Name	Typ	Beschreibung
points	Number[]	Ein Array mit Breitengrad/Längengrad-Paaren, die den Pfad definieren.

Return

StaticMap: Diese Karteninstanz für Verkettungen.

---

addPath(polyline)

Fügt der Karte mithilfe einer codierten Polylinie einen Pfad hinzu.

// Creates a map and adds a path from New York to Boston.
var polyline = Maps.encodePolyline([40.714353, -74.005973, 42.358431, -71.059773]);
var map = Maps.newStaticMap().addPath(polyline);

Parameter

Name	Typ	Beschreibung
polyline	String	Eine codierte Polylinie.

Return

StaticMap: Diese Karteninstanz für Verkettungen.

---

addPoint(latitude, longitude)

Fügt der aktuellen Pfaddefinition einen neuen Punkt (lat/lng) hinzu.

// Creates a map and adds a path from New York to Boston.
var map = Maps.newStaticMap()
    .beginPath()
    .addPoint(40.714353, -74.005973)
    .addPoint(42.358431, -71.059773)
    .endPath();

Parameter

Name	Typ	Beschreibung
latitude	Number	Der Breitengrad des Punkts.
longitude	Number	Der Längengrad des Punkts.

Return

StaticMap: Diese Karteninstanz für Verkettungen.

---

addVisible(latitude, longitude)

Fügt einen Punkt (lat/lng) hinzu, der auf der Karte sichtbar sein muss.

// Creates a map where New York and Boston are visible.
var map = Maps.newStaticMap()
    .addVisible(40.714353, -74.005973);
    .addVisible(42.358431, -71.059773)

Parameter

Name	Typ	Beschreibung
latitude	Number	Der Breitengrad des Punkts.
longitude	Number	Der Längengrad des Punkts.

Return

StaticMap: Diese Karteninstanz für Verkettungen.

Weitere Informationen

• Google Static Maps API

---

addVisible(address)

Fügt eine Adresse hinzu, die auf der Karte sichtbar sein muss.

// Creates a map where New York and Boston are visible.
var map = Maps.newStaticMap()
    .addVisible('New York, NY')
    .addVisible('Boston, MA');

Parameter

Name	Typ	Beschreibung
address	String	Eine Adresse, die auf der Karte sichtbar sein muss.

Return

StaticMap: Diese Karteninstanz für Verkettungen.

Weitere Informationen

• Google Static Maps API

---

beginPath()

Startet eine neue Pfaddefinition. Durch Aufrufe von addAddress() und addPoint() wird jeder neue Scheitelpunkt im Pfad definiert. Der Pfad ist abgeschlossen, wenn endPath() aufgerufen wird.

// Creates a map and adds a path from New York to Boston.
var map = Maps.newStaticMap()
    .beginPath()
    .addAddress('New York, NY')
    .addAddress('Boston, MA')
    .endPath();

Return

StaticMap: Diese Karteninstanz für Verkettungen.

---

clearMarkers()

Löscht die aktuelle Gruppe von Markierungen.

var map = Maps.newStaticMap();
// ...
// Do something interesting here ...
// ...
// Remove all markers on the map.
map.clearMarkers();

Return

StaticMap: Diese Karteninstanz für Verkettungen.

---

clearPaths()

Aktuelle Pfade löschen.

var map = Maps.newStaticMap();
// ...
// Do something interesting here ...
// ...
// Remove all paths on the map.
map.clearPaths();

Return

StaticMap: Diese Karteninstanz für Verkettungen.

---

clearVisibles()

Löscht die aktuell sichtbaren Standorte

var map = Maps.newStaticMap();
// ...
// Do something interesting here ...
// ...
// Remove all visible locations created with addVisible().
map.clearVisibles();

Return

StaticMap: Diese Karteninstanz für Verkettungen.

---

endPath()

Vervollständigt eine Pfaddefinition, die mit beginPath() beginnt.

// Creates a map and adds a path from New York to Boston.
var map = Maps.newStaticMap()
    .beginPath()
    .addAddress('New York, NY')
    .addAddress('Boston, MA')
    .endPath();

Return

StaticMap: Diese Karteninstanz für Verkettungen.

---

getAs(contentType)

Gibt die Daten in diesem Objekt als Blob zurück, das in den angegebenen Inhaltstyp konvertiert wurde. Bei dieser Methode wird dem Dateinamen die entsprechende Erweiterung hinzugefügt, z. B. "myfile.pdf". Dabei wird jedoch davon ausgegangen, dass der Teil des Dateinamens, der auf den letzten Punkt (falls vorhanden) folgt, eine vorhandene Erweiterung ist, die ersetzt werden sollte. Aus „ShoppingList.12.25.2014“ wird dann „ShoppingList.12.25.pdf“.

Informationen zu den Tageskontingenten für Conversions finden Sie unter Kontingente für Google-Dienste. Für neu erstellte Google Workspace-Domains gelten möglicherweise vorübergehend strengere Kontingente.

Parameter

Name	Typ	Beschreibung
contentType	String	Der MIME-Typ, in den konvertiert werden soll. Für die meisten Blobs ist 'application/pdf' die einzige gültige Option. Für Bilder im BMP-, GIF-, JPEG- oder PNG-Format sind auch 'image/bmp', 'image/gif', 'image/jpeg' oder 'image/png' gültig.

Return

Blob: Die Daten als Blob.

---

getBlob()

Ruft die Bilddaten als Blob ab.

// Creates a map centered on Times Square and saves it to Google Drive.
var map = Maps.newStaticMap().setCenter('Times Square, New York, NY');
DocsList.createFile(map);  // You can call map.getBlob() explicitly or use it
                           // implicitly by passing the map where a blob is expected.

Return

Blob: Ein Bild der Karte im ausgewählten Bildformat.

---

getMapImage()

Ruft die Rohdaten des Bildes als Byte-Array ab.

Im Allgemeinen solltest du getBlob() verwenden, das eine einfachere Interaktion mit anderen Diensten ermöglicht.

// Creates a map centered on Times Square and saves it to Google Drive.
var map = Maps.newStaticMap().setCenter('Times Square, New York, NY');
DocsList.createFile(Utilities.newBlob(map.getMapImage(), 'image/png', 'map.png'));

Return

Byte[]: Ein Bild der Karte im ausgewählten Bildformat.

---

getMapUrl()

Ruft die URL des Kartenbildes ab.

// Creates a map centered on Times Square and gets the URL.
var map = Maps.newStaticMap().setCenter('Times Square, New York, NY');
// All static map URLs require an API key.
Logger.log(map.getMapUrl() + "&key=YOUR_API_KEY");

Return

String: URL Die URL des Kartenbilds.

---

setCenter(latitude, longitude)

Legt den Mittelpunkt der Karte mithilfe eines Punkts (lat/lng) fest.

// Creates a map centered on Times Square, using its coordinates.
var map = Maps.newStaticMap().setCenter(40.759011, -73.984472);

Parameter

Name	Typ	Beschreibung
latitude	Number	Der Breitengrad des Mittelpunkts.
longitude	Number	Der Längengrad des Mittelpunkts.

Return

StaticMap: Diese Karteninstanz für Verkettungen.

Weitere Informationen

• Google Static Maps API

---

setCenter(address)

Legt die Mitte der Karte anhand einer Adresse fest.

// Creates a map centered on Times Square, using its address.
var map = Maps.newStaticMap().setCenter('Times Square, New York, NY');

Parameter

Name	Typ	Beschreibung
address	String	Die Adresse des Zentrums.

Return

StaticMap: Diese Karteninstanz für Verkettungen.

Weitere Informationen

• Google Static Maps API

---

setCustomMarkerStyle(imageUrl, useShadow)

Legt das benutzerdefinierte Markierungsbild fest, das beim Erstellen neuer Markierungen verwendet werden soll. Bereits hinzugefügte Markierungen sind davon nicht betroffen.

// Creates a map with markers set to be medium sized, black, and labeled with the number "1".
var map = Maps.newStaticMap()
    .setCustomMarkerStyle('http://www.example.com/marker.png', false);

Parameter

Name	Typ	Beschreibung
imageUrl	String	Gibt eine URL an, die als benutzerdefiniertes Symbol der Markierung verwendet werden soll. Bilder können in den Formaten PNG, JPEG oder GIF vorliegen, empfohlen werden PNG.
useShadow	Boolean	Gibt an, dass für die Markierung basierend auf dem sichtbaren Bereich des Bildes und seiner Deckkraft/Transparenz ein Schatten generiert werden soll.

Return

StaticMap: Diese Karteninstanz für Verkettungen.

Weitere Informationen

• Google Static Maps API

---

setFormat(format)

Legt das Format des Kartenbildes fest.

// Creates a map with the image format set to PNG.
var map = Maps.newStaticMap().setFormat(Maps.StaticMap.Format.PNG);

Parameter

Name	Typ	Beschreibung
format	String	Ein konstanter Wert aus Format.

Return

StaticMap: Diese Karteninstanz für Verkettungen.

Weitere Informationen

• Google Static Maps API

---

setLanguage(language)

Legt die Sprache fest, die für Text auf der Karte verwendet werden soll (wo verfügbar).

// Creates a map with the language set to French.
var map = Maps.newStaticMap().setLanguage('fr');

Parameter

Name	Typ	Beschreibung
language	String	Eine BCP-47-Sprachkennung.

Return

StaticMap: Diese Karteninstanz für Verkettungen.

Weitere Informationen

• Sprachunterstützung in Google Maps APIs

---

setMapType(mapType)

Legt den Typ der anzuzeigenden Karte fest.

// Creates a satellite map.
var map = Maps.newStaticMap().setMapType(Maps.StaticMap.Type.SATELLITE);

Parameter

Name	Typ	Beschreibung
mapType	String	Ein konstanter Wert aus Type.

Return

StaticMap: Diese Karteninstanz für Verkettungen.

Weitere Informationen

• Google Static Maps API

---

setMarkerStyle(size, color, label)

Legt den Markierungsstil fest, der beim Erstellen neuer Markierungen verwendet werden soll. Bereits hinzugefügte Markierungen sind davon nicht betroffen.

// Creates a map with markers set to be medium sized, black, and labeled with the number "1".
var map = Maps.newStaticMap()
    .setMarkerStyle(Maps.StaticMap.MarkerSize.MID, Maps.StaticMap.Color.BLACK , '1');

Parameter

Name	Typ	Beschreibung
size	String	Ein konstanter Wert aus MarkerSize.
color	String	Ein String im Format „0xrrggbb“ oder ein konstanter Wert aus Color.
label	String	Ein String, der ein einzelnes Zeichen von A–Z oder 0–9 enthält.

Return

StaticMap: Diese Karteninstanz für Verkettungen.

Weitere Informationen

• Google Static Maps API

---

setMobile(useMobileTiles)

Legt fest, ob spezielle Kachelsätze für Mobilgeräte verwendet werden sollen.

// Creates a map that uses mobile-friendly tiles.
var map = Maps.newStaticMap().setMobile(true);

Parameter

Name	Typ	Beschreibung
useMobileTiles	Boolean	Gibt an, ob Kacheln für Mobilgeräte verwendet werden sollen.

Return

StaticMap: Diese Karteninstanz für Verkettungen.

---

setPathStyle(weight, color, fillColor)

Legt den Pfadstil fest, der beim Erstellen neuer Pfade verwendet werden soll. Bereits hinzugefügte Pfade sind davon nicht betroffen.

// Creates a map with paths set to be 1 pixel wide with a black line and a white fill.
var map = Maps.newStaticMap()
    .setPathStyle(1, Maps.StaticMap.Color.BLACK , 'red');

Parameter

Name	Typ	Beschreibung
weight	Integer	Die Linienbreite in Pixeln.
color	String	Die Linienfarbe als String im Format "0xrrggbb" oder als konstanter Wert aus Color.
fillColor	String	Die Füllfarbe, ein String im Format „0xrrggbb“ oder ein konstanter Wert aus Color.

Return

StaticMap: Diese Karteninstanz für Verkettungen.

Weitere Informationen

• Google Static Maps API

---

setSize(width, height)

Legt die Breite und Höhe des Kartenbildes in Pixeln fest.

// Creates a map 400px wide by 300px high.
var map = Maps.newStaticMap().setSize(400, 300);

Parameter

Name	Typ	Beschreibung
width	Integer	Die Breite des Bilds in Pixeln
height	Integer	Die Höhe des Bilds in Pixeln

Return

StaticMap: Diese Karteninstanz für Verkettungen.

Weitere Informationen

• Google Static Maps API

---

setZoom(zoom)

Legt den Zoomfaktor oder die Vergrößerungsstufe fest, der für die Karte verwendet wird.

// Creates a map with a zoom factor of 10.
var map = Maps.newStaticMap().setZoom(10);

Parameter

Name	Typ	Beschreibung
zoom	Integer	Ein Wert zwischen 0 und 21 (einschließlich)

Return

StaticMap: Diese Karteninstanz für Verkettungen.

Weitere Informationen

• Google Static Maps API