Class StaticMap

StaticMap

Ermöglicht das Erstellen und Dekorieren statischer Kartenbilder.

Im folgenden Beispiel wird gezeigt, wie Sie mit dieser Klasse eine Karte des Theaterviertels von New York City mit nahe gelegenen Bahnhöfen erstellen und in einer einfachen Webanwendung anzeigen können.

// 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ügen Sie der aktuellen Pfaddefinition eine neue Adresse hinzu.
addMarker(latitude, longitude)StaticMapFügen Sie der Karte eine Markierung mit einem Punkt (Breiten-/Längengrad) hinzu.
addMarker(address)StaticMapFügen Sie der Karte eine Markierung mit einer Adresse hinzu.
addPath(points)StaticMapFügen Sie der Karte mithilfe eines Punktarrays einen Pfad hinzu.
addPath(polyline)StaticMapFügen Sie der Karte mithilfe einer codierten Polylinie einen Pfad hinzu.
addPoint(latitude, longitude)StaticMapFügen Sie der aktuellen Pfaddefinition einen neuen Punkt (Breiten-/Längengrad) hinzu.
addVisible(latitude, longitude)StaticMapFügen Sie einen Punkt (Breiten-/Längengrad) hinzu, der auf der Karte sichtbar sein muss.
addVisible(address)StaticMapFügen Sie einen Adressstandort hinzu, der auf der Karte sichtbar sein muss.
beginPath()StaticMapStartet eine neue Pfaddefinition.
clearMarkers()StaticMapLöscht die aktuellen Markierungen.
clearPaths()StaticMapLöschen Sie die aktuellen Pfade.
clearVisibles()StaticMapDie aktuell sichtbaren Standorte werden gelöscht.
endPath()StaticMapSchließt eine Pfaddefinition ab, die mit „beginPath()“ begonnen wurde.
getAs(contentType)BlobGibt die Daten in diesem Objekt als Blob zurück, der 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 mit einem Punkt (Breiten- und Längengrad) fest.
setCenter(address)StaticMapLegt den Mittelpunkt der Karte anhand einer Adresse fest.
setCustomMarkerStyle(imageUrl, useShadow)StaticMapHier legen Sie das benutzerdefinierte Markierungsbild fest, das beim Erstellen neuer Markierungen verwendet werden soll.
setFormat(format)StaticMapHiermit wird das Format des Kartenbilds festgelegt.
setLanguage(language)StaticMapHiermit wird die Sprache festgelegt, die für Text auf der Karte verwendet werden soll (sofern verfügbar).
setMapType(mapType)StaticMapHiermit wird festgelegt, welche Art von Karte angezeigt werden soll.
setMarkerStyle(size, color, label)StaticMapLegen Sie den Markierungsstil fest, der beim Erstellen neuer Markierungen verwendet werden soll.
setMobile(useMobileTiles)StaticMapHier legen Sie fest, ob spezielle Ansichten für Mobilgeräte verwendet werden sollen.
setPathStyle(weight, color, fillColor)StaticMapHier legen Sie den Pfadstil fest, der beim Erstellen neuer Pfade verwendet werden soll.
setSize(width, height)StaticMapHiermit werden die Breite und Höhe des Kartenbilds in Pixeln festgelegt.
setZoom(zoom)StaticMapHiermit wird der Zoomfaktor oder die Vergrößerungsstufe für die Karte festgelegt.

Detaillierte Dokumentation

addAddress(address)

Fügen Sie 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 Adresse, die hinzugefügt werden soll.

Rückflug

StaticMap: Diese Karteninstanz zur Verkettung.


addMarker(latitude, longitude)

Fügen Sie der Karte eine Markierung mit einem Punkt (Breiten-/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.
longitudeNumberDie Längengrad der neuen Markierung.

Rückflug

StaticMap: Diese Karteninstanz zur Verkettung.

Weitere Informationen


addMarker(address)

Fügen Sie der Karte eine Markierung mit einer Adresse 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ügen Sie der Karte mithilfe eines Punktarrays einen Pfad 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ängengrad-Paaren, die den Pfad definieren.

Rückflug

StaticMap: Diese Karteninstanz zur Verkettung.


addPath(polyline)

Fügen Sie der Karte mithilfe einer codierten Polylinie einen Pfad 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ügen Sie der aktuellen Pfaddefinition einen neuen Punkt (Breiten-/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 Punkts.
longitudeNumberDer Längengrad des Punkts.

Rückflug

StaticMap: Diese Karteninstanz zur Verkettung.


addVisible(latitude, longitude)

Fügen Sie einen Punkt (Breiten-/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 Punkts.
longitudeNumberDer Längengrad des Punkts.

Rückflug

StaticMap: Diese Karteninstanz zur Verkettung.

Weitere Informationen


addVisible(address)

Fügen Sie 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. Aufrufe von addAddress() und addPoint() definieren jeden neuen Knoten im Pfad. Der Pfad ist 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 aktuellen 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öschen Sie die aktuellen Pfade.

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

Rückflug

StaticMap: Diese Karteninstanz zur Verkettung.


clearVisibles()

Die aktuell sichtbaren Standorte werden gelöscht.

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 Pfaddefinition ab, die mit „beginPath()“ begonnen wurde.

// 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, der in den angegebenen Inhaltstyp konvertiert wurde. Bei dieser Methode wird dem Dateinamen die entsprechende Erweiterung hinzugefügt, z. B. „meinedatei.pdf“. Es wird jedoch davon ausgegangen, dass der Teil des Dateinamens, der auf den letzten Punkt (falls vorhanden) folgt, eine vorhandene Erweiterung ist, die ersetzt werden soll. Daraus wird „Einkaufsliste.25.12.2014“ zu „Einkaufsliste.25.12.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. Bei Bildern im BMP-, GIF-, JPEG- oder PNG-Format sind auch 'image/bmp', 'image/gif', 'image/jpeg' oder 'image/png' zulässig. Für ein Google Docs-Dokument ist auch 'text/markdown' zulässig.

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.

Verwenden Sie im Allgemeinen getBlob(), da dies die Interaktion mit anderen Diensten vereinfacht.

// 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 mit einem Punkt (Breiten- und 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 den Mittelpunkt 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)

Hier legen Sie 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 der Markierung verwendet werden soll. Bilder können im PNG-, JPEG- oder GIF-Format vorliegen. PNG wird empfohlen.
useShadowBooleanGibt an, dass für die Markierung ein Schatten generiert werden soll, der auf dem sichtbaren Bereich des Bilds und seiner Deckkraft/Transparenz basiert.

Rückflug

StaticMap: Diese Karteninstanz zur Verkettung.

Weitere Informationen


setFormat(format)

Hiermit wird das Format des Kartenbilds festgelegt.

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

Hiermit wird die Sprache festgelegt, 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-Sprachkennzeichnung.

Rückflug

StaticMap: Diese Karteninstanz zur Verkettung.

Weitere Informationen


setMapType(mapType)

Hiermit wird festgelegt, welche Art von Karte angezeigt werden soll.

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

Legen Sie 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 aus A–Z oder 0–9.

Rückflug

StaticMap: Diese Karteninstanz zur Verkettung.

Weitere Informationen


setMobile(useMobileTiles)

Hier legen Sie fest, ob spezielle Ansichten für Mobilgeräte verwendet werden sollen.

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

Parameter

NameTypBeschreibung
useMobileTilesBooleanOb Ansichten für Mobilgeräte verwendet werden sollen oder nicht.

Rückflug

StaticMap: Diese Karteninstanz zur Verkettung.


setPathStyle(weight, color, fillColor)

Hier legen Sie 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 der Linien in Pixeln.
colorStringDie Linienfarbe als String im Format „0xrrggbb“ oder als Konstantenwert aus Color.
fillColorStringDie Füllfarbe, ein String im Format „0xrrggbb“ oder ein Konstantenwert aus Color.

Rückflug

StaticMap: Diese Karteninstanz zur Verkettung.

Weitere Informationen


setSize(width, height)

Hiermit werden die Breite und Höhe des Kartenbilds in Pixeln festgelegt.

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

Hiermit wird der Zoomfaktor oder die Vergrößerungsstufe für die Karte festgelegt.

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