Class StaticMap

StatischeKarte

Ermöglicht das Erstellen und Anpassen statischer Kartenbilder.

Im folgenden Beispiel wird gezeigt, wie Sie mit dieser Klasse eine Karte des New Yorker Theatre District mit nahegelegenen Bahnhöfen erstellen und in einer einfachen Web-App anzeigen.

// Create a map centered on Times Square.
const 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.
const 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 (let i = 0; i < corners.length; i++) {
  map.addAddress(corners[i]);
}
// All static map URLs require an API key.
const url = `${map.getMapUrl()}&key=YOUR_API_KEY`;

Weitere Informationen

Methoden

MethodeRückgabetypKurzbeschreibung
addAddress(address)StaticMapFügt der aktuellen Pfaddefinition eine neue Adresse hinzu.
addMarker(latitude, longitude)StaticMapFügt der Karte eine Markierung mithilfe eines Punktes (Breitengrad/Längengrad) hinzu.
addMarker(address)StaticMapFügt der Karte mithilfe einer Adresse eine Markierung hinzu.
addPath(points)StaticMapFügt der Karte einen Pfad mithilfe eines Arrays von Punkten hinzu.
addPath(polyline)StaticMapFügt der Karte einen Pfad mithilfe einer codierten Polylinie hinzu.
addPoint(latitude, longitude)StaticMapFügt der aktuellen Pfaddefinition einen neuen Punkt (Breitengrad/Längengrad) hinzu.
addVisible(latitude, longitude)StaticMapFügt einen Punkt (Breitengrad/Längengrad) hinzu, der auf der Karte sichtbar sein muss.
addVisible(address)StaticMapFügt einen Adressstandort hinzu, der auf der Karte sichtbar sein muss.
beginPath()StaticMapStartet eine neue Pfaddefinition.
clearMarkers()StaticMapLöscht die aktuelle Gruppe von Markierungen.
clearPaths()StaticMapLöscht den aktuellen Satz von Pfaden.
clearVisibles()StaticMapLöscht die aktuelle Gruppe sichtbarer Orte.
endPath()StaticMapSchließt eine mit beginPath() begonnene Pfaddefinition ab.
getAs(contentType)BlobGibt die Daten in diesem Objekt als Blob zurück, das in den angegebenen Inhaltstyp konvertiert wurde.
getBlob()BlobRuft die Bilddaten als Blob ab.
getMapImage()Byte[]Ruft die Rohbilddaten als Byte-Array ab.
getMapUrl()StringRuft die URL des Kartenbilds ab.
setCenter(latitude, longitude)StaticMapLegt den Mittelpunkt der Karte mithilfe eines Punktes (Breitengrad/Längengrad) fest.
setCenter(address)StaticMapLegt die Mitte der Karte anhand einer Adresse fest.
setCustomMarkerStyle(imageUrl, useShadow)StaticMapLegt das benutzerdefinierte Markierungsbild fest, das beim Erstellen neuer Markierungen verwendet werden soll.
setFormat(format)StaticMapLegt das Format des Kartenbilds fest.
setLanguage(language)StaticMapLegt die Sprache fest, die für Text auf der Karte verwendet werden soll (sofern verfügbar).
setMapType(mapType)StaticMapLegt den anzuzeigenden Kartentyp fest.
setMarkerStyle(size, color, label)StaticMapLegt den Markierungsstil fest, der beim Erstellen neuer Markierungen verwendet werden soll.
setMobile(useMobileTiles)StaticMapLegt fest, ob spezielle Kachelsätze für Mobilgeräte verwendet werden sollen.
setPathStyle(weight, color, fillColor)StaticMapLegt den Pfadstil fest, der beim Erstellen neuer Pfade verwendet werden soll.
setSize(width, height)StaticMapLegt die Breite und Höhe des Kartenbilds in Pixeln fest.
setZoom(zoom)StaticMapLegt den Zoomfaktor oder die Vergrößerungsstufe für die 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.
const map = Maps.newStaticMap()
                .beginPath()
                .addAddress('New York, NY')
                .addAddress('Boston, MA')
                .endPath();

Parameter

NameTypBeschreibung
addressStringEine hinzuzufügende Adresse.

Rückflug

StaticMap: Diese Karteninstanz zur Verkettung.


addMarker(latitude, longitude)

Fügt der Karte eine Markierung mithilfe eines Punktes (Breitengrad/Längengrad) hinzu.

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

Parameter

NameTypBeschreibung
latitudeNumberDer Breitengrad der neuen Markierung.
longitudeNumberDer Längengrad der neuen Markierung.

Rückflug

StaticMap: Diese Karteninstanz zur Verkettung.

Weitere Informationen


addMarker(address)

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

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

Parameter

NameTypBeschreibung
addressStringDie Adresse, an der die neue Markierung platziert werden soll.

Rückflug

StaticMap: Diese Karteninstanz zur Verkettung.

Weitere Informationen


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.
const map = Maps.newStaticMap().addPath([
  40.714353,
  -74.005973,
  42.358431,
  -71.059773,
]);

Parameter

NameTypBeschreibung
pointsNumber[]Ein Array von Breiten-/Längengradpaaren, die den Pfad definieren.

Rückflug

StaticMap: Diese Karteninstanz zur Verkettung.


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.
const polyline = Maps.encodePolyline([
  40.714353,
  -74.005973,
  42.358431,
  -71.059773,
]);
const map = Maps.newStaticMap().addPath(polyline);

Parameter

NameTypBeschreibung
polylineStringEine codierte Polylinie.

Rückflug

StaticMap: Diese Karteninstanz zur Verkettung.


addPoint(latitude, longitude)

Fügt der aktuellen Pfaddefinition einen neuen Punkt (Breitengrad/Längengrad) hinzu.

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

Parameter

NameTypBeschreibung
latitudeNumberDer Breitengrad des Punktes.
longitudeNumberDer Längengrad des Punkts.

Rückflug

StaticMap: Diese Karteninstanz zur Verkettung.


addVisible(latitude, longitude)

Fügt einen Punkt (Breitengrad/Längengrad) hinzu, der auf der Karte sichtbar sein muss.

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

Parameter

NameTypBeschreibung
latitudeNumberDer Breitengrad des Punktes.
longitudeNumberDer Längengrad des Punkts.

Rückflug

StaticMap: Diese Karteninstanz zur Verkettung.

Weitere Informationen


addVisible(address)

Fügt einen Adressstandort hinzu, der auf der Karte sichtbar sein muss.

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

Parameter

NameTypBeschreibung
addressStringEine Adresse, die auf der Karte sichtbar sein muss.

Rückflug

StaticMap: Diese Karteninstanz zur Verkettung.

Weitere Informationen


beginPath()

Startet eine neue Pfaddefinition. Mit Aufrufen von addAddress() und addPoint() wird jeder neue Knoten im Pfad definiert. Der Pfad wird abgeschlossen, wenn endPath() aufgerufen wird.

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

Rückflug

StaticMap: Diese Karteninstanz zur Verkettung.


clearMarkers()

Löscht die aktuelle Gruppe von Markierungen.

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

Rückflug

StaticMap: Diese Karteninstanz zur Verkettung.


clearPaths()

Löscht den aktuellen Satz von Pfaden.

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

Rückflug

StaticMap: Diese Karteninstanz zur Verkettung.


clearVisibles()

Löscht die aktuelle Gruppe sichtbarer Orte.

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

Rückflug

StaticMap: Diese Karteninstanz zur Verkettung.


endPath()

Schließt eine mit beginPath() begonnene Pfaddefinition ab.

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

Rückflug

StaticMap: Diese Karteninstanz zur Verkettung.


getAs(contentType)

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

Die täglichen Kontingente 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

NameTypBeschreibung
contentTypeStringDer 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. Für ein Google Docs-Dokument ist auch 'text/markdown' 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.
const map = Maps.newStaticMap().setCenter('Times Square, New York, NY');
DriveApp.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 sollten Sie getBlob() verwenden, da dies eine einfachere Interaktion mit anderen Diensten ermöglicht.

// Creates a map centered on Times Square and saves it to Google Drive.
const map = Maps.newStaticMap().setCenter('Times Square, New York, NY');
DriveApp.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 Kartenbilds ab.

// Creates a map centered on Times Square and gets the URL.
const 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 Punktes (Breitengrad/Längengrad) fest.

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

Parameter

NameTypBeschreibung
latitudeNumberDer Breitengrad des Mittelpunkts.
longitudeNumberDer Längengrad des Mittelpunkts.

Rückflug

StaticMap: Diese Karteninstanz zur Verkettung.

Weitere Informationen


setCenter(address)

Legt die Mitte der Karte anhand einer Adresse fest.

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

Parameter

NameTypBeschreibung
addressStringDie Adresse des Zentrums.

Rückflug

StaticMap: Diese Karteninstanz zur Verkettung.

Weitere Informationen


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".
const map = Maps.newStaticMap().setCustomMarkerStyle(
    'http://www.example.com/marker.png',
    false,
);

Parameter

NameTypBeschreibung
imageUrlStringGibt eine URL an, die als benutzerdefiniertes Symbol für die Markierung verwendet werden soll. Bilder können im PNG-, JPEG- oder GIF-Format vorliegen. PNG wird jedoch empfohlen.
useShadowBooleanGibt an, dass für die Markierung ein Schatten generiert werden soll, der auf der sichtbaren Region des Bildes und seiner Deckkraft/Transparenz basiert.

Rückflug

StaticMap: Diese Karteninstanz zur Verkettung.

Weitere Informationen


setFormat(format)

Legt das Format des Kartenbilds fest.

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

Parameter

NameTypBeschreibung
formatStringEin konstanter Wert aus Format.

Rückflug

StaticMap: Diese Karteninstanz zur Verkettung.

Weitere Informationen


setLanguage(language)

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

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

Parameter

NameTypBeschreibung
languageStringEine BCP-47-Sprachkennung.

Rückflug

StaticMap: Diese Karteninstanz zur Verkettung.

Weitere Informationen


setMapType(mapType)

Legt den anzuzeigenden Kartentyp fest.

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

Parameter

NameTypBeschreibung
mapTypeStringEin konstanter Wert aus Type.

Rückflug

StaticMap: Diese Karteninstanz zur Verkettung.

Weitere Informationen


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".
const map = Maps.newStaticMap().setMarkerStyle(
    Maps.StaticMap.MarkerSize.MID,
    Maps.StaticMap.Color.BLACK,
    '1',
);

Parameter

NameTypBeschreibung
sizeStringEin konstanter Wert aus MarkerSize.
colorStringEin String im Format „0xrrggbb“ oder ein konstanter Wert aus Color.
labelStringEin String mit einem einzelnen Zeichen A–Z oder 0–9.

Rückflug

StaticMap: Diese Karteninstanz zur Verkettung.

Weitere Informationen


setMobile(useMobileTiles)

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

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

Parameter

NameTypBeschreibung
useMobileTilesBooleanGibt an, ob mobile Kacheln verwendet werden sollen.

Rückflug

StaticMap: Diese Karteninstanz zur Verkettung.


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.
const map = Maps.newStaticMap().setPathStyle(
    1,
    Maps.StaticMap.Color.BLACK,
    'red',
);

Parameter

NameTypBeschreibung
weightIntegerDie Breite von Linien in Pixeln.
colorStringDie Linienfarbe als String im Format „0xrrggbb“ oder als konstanter Wert aus Color.
fillColorStringDie Füllfarbe, ein String im Format „0xrrggbb“ oder ein konstanter Wert aus Color.

Rückflug

StaticMap: Diese Karteninstanz zur Verkettung.

Weitere Informationen


setSize(width, height)

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

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

Parameter

NameTypBeschreibung
widthIntegerDie Breite des Bilds in Pixeln
heightIntegerDie Höhe des Bilds in Pixeln

Rückflug

StaticMap: Diese Karteninstanz zur Verkettung.

Weitere Informationen


setZoom(zoom)

Legt den Zoomfaktor oder die Vergrößerungsstufe für die Karte fest.

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

Parameter

NameTypBeschreibung
zoomIntegerEin Wert zwischen 0 und 21 (einschließlich).

Rückflug

StaticMap: Diese Karteninstanz zur Verkettung.

Weitere Informationen