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

Methoden

MethodeRückgabetypKurzbeschreibung
addAddress(address)StaticMapFügt der aktuellen Pfaddefinition eine neue Adresse hinzu.
addMarker(latitude, longitude)StaticMapFügt mithilfe eines Punkts (lat/lng) eine Markierung zur Karte 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 (lat/lng) hinzu.
addVisible(latitude, longitude)StaticMapFügt einen Punkt (lat/lng) hinzu, der auf der Karte sichtbar sein muss.
addVisible(address)StaticMapFügt eine Adresse hinzu, die auf der Karte sichtbar sein muss.
beginPath()StaticMapStartet eine neue Pfaddefinition.
clearMarkers()StaticMapLöscht den aktuellen Satz von Markierungen.
clearPaths()StaticMapAktuelle Pfade löschen.
clearVisibles()StaticMapLöscht die aktuell sichtbaren Standorte.
endPath()StaticMapVervollständigt eine Pfaddefinition, die mit „beginPath()“ beginnt.
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 Kartenbildes ab.
setCenter(latitude, longitude)StaticMapLegt den Mittelpunkt der Karte mithilfe eines Punkts (lat/lng) fest.
setCenter(address)StaticMapLegt den Mittelpunkt der Karte mithilfe 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 den Text auf der Karte verwendet werden soll (sofern verfügbar).
setMapType(mapType)StaticMapLegt den Typ der anzuzeigenden Karte fest.
setMarkerStyle(size, color, label)StaticMapLegt den Markierungsstil fest, der beim Erstellen neuer Markierungen verwendet werden soll.
setMobile(useMobileTiles)StaticMapLegt fest, ob spezialisierte Kachelsätze für Mobilgeräte verwendet werden.
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 Kartenbildes in Pixeln fest.
setZoom(zoom)StaticMapLegt 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

NameTypBeschreibung
addressStringEine 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

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

Rückflug

StaticMap: Diese Karteninstanz für Verkettungen.

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.
var 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 für Verkettungen.

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

Parameter

NameTypBeschreibung
pointsNumber[]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

NameTypBeschreibung
polylineStringEine 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

NameTypBeschreibung
latitudeNumberDer Breitengrad des Punkts.
longitudeNumberDer 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

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

Rückflug

StaticMap: Diese Karteninstanz für Verkettungen.

Weitere Informationen


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

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

Rückflug

StaticMap: Diese Karteninstanz für Verkettungen.

Weitere Informationen


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

NameTypBeschreibung
contentTypeStringDer 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

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

Rückflug

StaticMap: Diese Karteninstanz für Verkettungen.

Weitere Informationen


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

NameTypBeschreibung
addressStringDie Adresse des Zentrums.

Rückflug

StaticMap: Diese Karteninstanz für Verkettungen.

Weitere Informationen


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

NameTypBeschreibung
imageUrlStringGibt 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.
useShadowBooleanGibt 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


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

NameTypBeschreibung
formatStringEin konstanter Wert aus Format.

Rückflug

StaticMap: Diese Karteninstanz für Verkettungen.

Weitere Informationen


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

NameTypBeschreibung
languageStringEine BCP-47-Sprachkennzeichnung.

Rückflug

StaticMap: Diese Karteninstanz für Verkettungen.

Weitere Informationen


setMapType(mapType)

Legt den Typ der anzuzeigenden Karte fest.

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

Parameter

NameTypBeschreibung
mapTypeStringEin konstanter Wert aus Type.

Rückflug

StaticMap: Diese Karteninstanz für Verkettungen.

Weitere Informationen


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

NameTypBeschreibung
sizeStringEin konstanter Wert aus MarkerSize.
colorStringEinen String im Format „0xrrggbb“ oder einen konstanten Wert aus Color.
labelStringEin String, der ein einzelnes Zeichen von A–Z oder von 0–9 enthält.

Rückflug

StaticMap: Diese Karteninstanz für Verkettungen.

Weitere Informationen


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

NameTypBeschreibung
useMobileTilesBooleanGibt 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

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

Rückflug

StaticMap: Diese Karteninstanz für Verkettungen.

Weitere Informationen


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

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

Rückflug

StaticMap: Diese Karteninstanz für Verkettungen.

Weitere Informationen


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

NameTypBeschreibung
zoomIntegerEin Wert von 0 bis 21 (einschließlich).

Rückflug

StaticMap: Diese Karteninstanz für Verkettungen.

Weitere Informationen