Diese Seite wurde von der Cloud Translation API übersetzt.

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