Class StaticMap

StaticMap

Ermöglicht die Erstellung und Gestaltung statischer Kartenbilder.

Das folgende Beispiel zeigt, wie Sie mit dieser Klasse eine Karte des New York City Theatre erstellen können. Bezirk, einschließlich nahe gelegener Bahnhöfe, und sie in einer einfachen Web-App anzeigen.

// 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 mithilfe eines Punkts (lat/lng) eine Markierung hinzu.
addMarker(address)	StaticMap	Fügt der Karte mithilfe einer Adresse eine Markierung hinzu.
addPath(points)	StaticMap	Fügt der Karte einen Pfad mithilfe eines Arrays von Punkten hinzu.
addPath(polyline)	StaticMap	Fügt der Karte einen Pfad mithilfe einer codierten Polylinie 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 den aktuellen Satz 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 Rohbilddaten 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 den Mittelpunkt der Karte mithilfe 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 Kartenbilds fest.
setLanguage(language)	StaticMap	Legt die Sprache fest, die für den Text auf der Karte verwendet werden soll (sofern 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 spezialisierte Kachelsätze für Mobilgeräte verwendet werden.
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 bzw. die Vergrößerungsstufe der Karte fest.

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.

Rückflug

StaticMap: Diese Karteninstanz für Verkettungen.

---

addMarker(latitude, longitude)

Fügt mithilfe eines Punkts (lat/lng) eine Markierung zur Karte 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.

Rückflug

StaticMap: Diese Karteninstanz für Verkettungen.

Weitere Informationen

• Google Static Maps API

---

addMarker(address)

Fügt der Karte mithilfe einer Adresse eine Markierung 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.

Rückflug

StaticMap: Diese Karteninstanz für Verkettungen.

Weitere Informationen

• Google Static Maps API

---

addPath(points)

Fügt der Karte einen Pfad mithilfe eines Arrays von Punkten 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 aus Breiten- und Längengradpaaren, die den Pfad definieren.

Rückflug

StaticMap: Diese Karteninstanz für Verkettungen.

---

addPath(polyline)

Fügt der Karte einen Pfad mithilfe einer codierten Polylinie 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.

Rückflug

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.

Rückflug

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.

Rückflug

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.

Rückflug

StaticMap: Diese Karteninstanz für Verkettungen.

Weitere Informationen

• Google Static Maps API

---

beginPath()

Startet eine neue Pfaddefinition. Aufrufe von addAddress() und addPoint() definieren jeweils neuen Scheitelpunkt im Pfad. 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();

Rückflug

StaticMap: Diese Karteninstanz für Verkettungen.

---

clearMarkers()

Löscht den aktuellen Satz von Markierungen.

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

Rückflug

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();

Rückflug

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();

Rückflug

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();

Rückflug

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. Dieses fügt dem Dateinamen die entsprechende Erweiterung hinzu, beispielsweise "meinedatei.pdf". Allerdings geht davon aus, dass der Teil des Dateinamens, der auf den letzten Punkt folgt (falls vorhanden), ein vorhandener die ersetzt werden soll. Daher lautet „Einkaufsliste.12.25.2014“. wird zu „Einkaufsliste.12.25.pdf“.

Die Tageskontingente für Conversions finden Sie unter Kontingente für Google Dienste. Neu erstellte Google Workspace-Domains unterliegen möglicherweise vorübergehend strengeren Richtlinien. Kontingenten.

Parameter

Name	Typ	Beschreibung
contentType	String	Der MIME-Typ, in den konvertiert werden soll. Für die meisten Blobs ist 'application/pdf' ist die einzige gültige Option. Für Bilder im BMP-, GIF-, JPEG- oder PNG-Format gilt auch Folgendes: 'image/bmp', 'image/gif', 'image/jpeg' oder 'image/png' gültig sein. Bei einem Google Docs-Dokument ist 'text/markdown' ebenfalls gültig.

Rückflug

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.

Rückflug

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

---

getMapImage()

Ruft die Rohbilddaten als Byte-Array ab.

Im Allgemeinen ist die Verwendung von getBlob() vorzuziehen, da sie eine einfachere Interaktion mit anderen .

// 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'));

Rückflug

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");

Rückflug

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.

Rückflug

StaticMap: Diese Karteninstanz für Verkettungen.

Weitere Informationen

• Google Static Maps API

---

setCenter(address)

Legt den Mittelpunkt der Karte mithilfe 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.

Rückflug

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. Markierungen, die bereits nicht betroffen sind.

// 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 das Format PNG oder JPEG haben. oder GIF-Format, wobei PNG empfohlen wird.
useShadow	Boolean	Gibt an, dass für die Markierung ein Schatten generiert werden soll, der auf dem sichtbaren Bereich und deren Deckkraft/Transparenz.

Rückflug

StaticMap: Diese Karteninstanz für Verkettungen.

Weitere Informationen

• Google Static Maps API

---

setFormat(format)

Legt das Format des Kartenbilds 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.

Rückflug

StaticMap: Diese Karteninstanz für Verkettungen.

Weitere Informationen

• Google Static Maps API

---

setLanguage(language)

Legt die Sprache fest, die für den Text auf der Karte verwendet werden soll (sofern 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-Sprachkennzeichnung.

Rückflug

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.

Rückflug

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 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	Einen String im Format „0xrrggbb“ oder einen konstanten Wert aus Color.
label	String	Ein String, der ein einzelnes Zeichen von A–Z oder von 0–9 enthält.

Rückflug

StaticMap: Diese Karteninstanz für Verkettungen.

Weitere Informationen

• Google Static Maps API

---

setMobile(useMobileTiles)

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

// 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.

Rückflug

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 werden nicht betroffen sind.

// 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 Breite der Linien in Pixeln.
color	String	Die Linienfarbe als String im Format "0xrrggbb" oder einen konstanten Wert aus Color
fillColor	String	Die Füllfarbe, ein String im Format „0xrrggbb“ oder einen konstanten Wert aus Color

Rückflug

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

Rückflug

StaticMap: Diese Karteninstanz für Verkettungen.

Weitere Informationen

• Google Static Maps API

---

setZoom(zoom)

Legt den Zoomfaktor bzw. die Vergrößerungsstufe der Karte fest.

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

Parameter

Name	Typ	Beschreibung
zoom	Integer	Ein Wert von 0 bis 21 (einschließlich).

Rückflug

StaticMap: Diese Karteninstanz für Verkettungen.

Weitere Informationen

• Google Static Maps API