Diese Seite wurde von der Cloud Translation API übersetzt.

Class 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

Google Static Maps API

Methoden

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

Name	Typ	Beschreibung
`address`	`String`	Eine 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

Name	Typ	Beschreibung
`latitude`	`Number`	Der Breitengrad der neuen Markierung.
`longitude`	`Number`	Die Längengrad der neuen Markierung.

Rückflug

StaticMap: Diese Karteninstanz zur Verkettung.

Weitere Informationen

Google Static Maps API

`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

Name	Typ	Beschreibung
`address`	`String`	Die Adresse, an der die neue Markierung platziert werden soll.

Rückflug

StaticMap: Diese Karteninstanz zur Verkettung.

Weitere Informationen

Google Static Maps API

`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

Name	Typ	Beschreibung
`points`	`Number[]`	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

Name	Typ	Beschreibung
`polyline`	`String`	Eine 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

Name	Typ	Beschreibung
`latitude`	`Number`	Der Breitengrad des Punkts.
`longitude`	`Number`	Der 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

Name	Typ	Beschreibung
`latitude`	`Number`	Der Breitengrad des Punkts.
`longitude`	`Number`	Der Längengrad des Punkts.

Rückflug

StaticMap: Diese Karteninstanz zur Verkettung.

Weitere Informationen

Google Static Maps API

`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

Name	Typ	Beschreibung
`address`	`String`	Eine Adresse, die auf der Karte sichtbar sein muss.

Rückflug

StaticMap: Diese Karteninstanz zur Verkettung.

Weitere Informationen

Google Static Maps API

`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

Name	Typ	Beschreibung
`contentType`	`String`	Der 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

Name	Typ	Beschreibung
`latitude`	`Number`	Der Breitengrad des Mittelpunkts.
`longitude`	`Number`	Der Längengrad des Mittelpunkts.

Rückflug

StaticMap: Diese Karteninstanz zur Verkettung.

Weitere Informationen

Google Static Maps API

`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

Name	Typ	Beschreibung
`address`	`String`	Die Adresse des Zentrums.

Rückflug

StaticMap: Diese Karteninstanz zur Verkettung.

Weitere Informationen

Google Static Maps API

`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

Name	Typ	Beschreibung
`imageUrl`	`String`	Gibt 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.
`useShadow`	`Boolean`	Gibt 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

Google Static Maps API

`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

Name	Typ	Beschreibung
`format`	`String`	Ein konstanter Wert aus `Format`.

Rückflug

StaticMap: Diese Karteninstanz zur Verkettung.

Weitere Informationen

Google Static Maps API

`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

Name	Typ	Beschreibung
`language`	`String`	Eine BCP-47-Sprachkennzeichnung.

Rückflug

StaticMap: Diese Karteninstanz zur Verkettung.

Weitere Informationen

Sprachunterstützung in Google Maps APIs

`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

Name	Typ	Beschreibung
`mapType`	`String`	Ein konstanter Wert aus `Type`.

Rückflug

StaticMap: Diese Karteninstanz zur Verkettung.

Weitere Informationen

Google Static Maps API

`setMarkerStyle(size, color, label)`

Legen Sie hier 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

Name	Typ	Beschreibung
`size`	`String`	Ein konstanter Wert aus `MarkerSize`.
`color`	`String`	Ein String im Format „0xrrggbb“ oder ein konstanter Wert aus `Color`.
`label`	`String`	Ein String mit einem einzelnen Zeichen aus A–Z oder 0–9.

Rückflug

StaticMap: Diese Karteninstanz zur Verkettung.

Weitere Informationen

Google Static Maps API

`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

Name	Typ	Beschreibung
`useMobileTiles`	`Boolean`	Ob 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

Name	Typ	Beschreibung
`weight`	`Integer`	Die Breite der Linien in Pixeln.
`color`	`String`	Die Linienfarbe als String im Format „0xrrggbb“ oder als Konstantenwert aus `Color`.
`fillColor`	`String`	Die Füllfarbe, ein String im Format „0xrrggbb“ oder ein Konstantenwert aus `Color`.

Rückflug

StaticMap: Diese Karteninstanz zur Verkettung.

Weitere Informationen

Google Static Maps API

`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

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 zur Verkettung.

Weitere Informationen

Google Static Maps API

`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

Name	Typ	Beschreibung
`zoom`	`Integer`	Ein Wert zwischen 0 und 21 (einschließlich).

Rückflug

StaticMap: Diese Karteninstanz zur Verkettung.

Weitere Informationen

Google Static Maps API