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
| Methode | Rückgabetyp | Kurzbeschreibung |
|---|---|---|
add | Static | Fügt der aktuellen Pfaddefinition eine neue Adresse hinzu. |
add | Static | Fügt der Karte eine Markierung mithilfe eines Punktes (Breitengrad/Längengrad) hinzu. |
add | Static | Fügt der Karte mithilfe einer Adresse eine Markierung hinzu. |
add | Static | Fügt der Karte einen Pfad mithilfe eines Arrays von Punkten hinzu. |
add | Static | Fügt der Karte einen Pfad mithilfe einer codierten Polylinie hinzu. |
add | Static | Fügt der aktuellen Pfaddefinition einen neuen Punkt (Breitengrad/Längengrad) hinzu. |
add | Static | Fügt einen Punkt (Breitengrad/Längengrad) hinzu, der auf der Karte sichtbar sein muss. |
add | Static | Fügt einen Adressstandort hinzu, der auf der Karte sichtbar sein muss. |
begin | Static | Startet eine neue Pfaddefinition. |
clear | Static | Löscht die aktuelle Gruppe von Markierungen. |
clear | Static | Löscht den aktuellen Satz von Pfaden. |
clear | Static | Löscht die aktuelle Gruppe sichtbarer Orte. |
end | Static | Schließt eine mit beginPath() begonnene Pfaddefinition ab. |
get | Blob | Gibt die Daten in diesem Objekt als Blob zurück, das in den angegebenen Inhaltstyp konvertiert wurde. |
get | Blob | Ruft die Bilddaten als Blob ab. |
get | Byte[] | Ruft die Rohbilddaten als Byte-Array ab. |
get | String | Ruft die URL des Kartenbilds ab. |
set | Static | Legt den Mittelpunkt der Karte mithilfe eines Punktes (Breitengrad/Längengrad) fest. |
set | Static | Legt die Mitte der Karte anhand einer Adresse fest. |
set | Static | Legt das benutzerdefinierte Markierungsbild fest, das beim Erstellen neuer Markierungen verwendet werden soll. |
set | Static | Legt das Format des Kartenbilds fest. |
set | Static | Legt die Sprache fest, die für Text auf der Karte verwendet werden soll (sofern verfügbar). |
set | Static | Legt den anzuzeigenden Kartentyp fest. |
set | Static | Legt den Markierungsstil fest, der beim Erstellen neuer Markierungen verwendet werden soll. |
set | Static | Legt fest, ob spezielle Kachelsätze für Mobilgeräte verwendet werden sollen. |
set | Static | Legt den Pfadstil fest, der beim Erstellen neuer Pfade verwendet werden soll. |
set | Static | Legt die Breite und Höhe des Kartenbilds in Pixeln fest. |
set | Static | Legt den Zoomfaktor oder die Vergrößerungsstufe für die Karte fest. |
Detaillierte Dokumentation
add Address(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
| Name | Typ | Beschreibung |
|---|---|---|
address | String | Eine hinzuzufügende Adresse. |
Rückflug
Static: Diese Karteninstanz zur Verkettung.
add Marker(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
| Name | Typ | Beschreibung |
|---|---|---|
latitude | Number | Der Breitengrad der neuen Markierung. |
longitude | Number | Der Längengrad der neuen Markierung. |
Rückflug
Static: Diese Karteninstanz zur Verkettung.
Weitere Informationen
add Marker(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
| Name | Typ | Beschreibung |
|---|---|---|
address | String | Die Adresse, an der die neue Markierung platziert werden soll. |
Rückflug
Static: Diese Karteninstanz zur Verkettung.
Weitere Informationen
add Path(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
| Name | Typ | Beschreibung |
|---|---|---|
points | Number[] | Ein Array von Breiten-/Längengradpaaren, die den Pfad definieren. |
Rückflug
Static: Diese Karteninstanz zur Verkettung.
add Path(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
| Name | Typ | Beschreibung |
|---|---|---|
polyline | String | Eine codierte Polylinie. |
Rückflug
Static: Diese Karteninstanz zur Verkettung.
add Point(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
| Name | Typ | Beschreibung |
|---|---|---|
latitude | Number | Der Breitengrad des Punktes. |
longitude | Number | Der Längengrad des Punkts. |
Rückflug
Static: Diese Karteninstanz zur Verkettung.
add Visible(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
| Name | Typ | Beschreibung |
|---|---|---|
latitude | Number | Der Breitengrad des Punktes. |
longitude | Number | Der Längengrad des Punkts. |
Rückflug
Static: Diese Karteninstanz zur Verkettung.
Weitere Informationen
add Visible(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
| Name | Typ | Beschreibung |
|---|---|---|
address | String | Eine Adresse, die auf der Karte sichtbar sein muss. |
Rückflug
Static: Diese Karteninstanz zur Verkettung.
Weitere Informationen
begin Path()
Startet eine neue Pfaddefinition. Mit Aufrufen von add und add wird jeder neue Knoten im Pfad definiert. Der Pfad wird abgeschlossen, wenn end 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
Static: Diese Karteninstanz zur Verkettung.
clear Markers()
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
Static: Diese Karteninstanz zur Verkettung.
clear Paths()
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
Static: Diese Karteninstanz zur Verkettung.
clear Visibles()
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
Static: Diese Karteninstanz zur Verkettung.
end Path()
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
Static: Diese Karteninstanz zur Verkettung.
get As(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
| Name | Typ | Beschreibung |
|---|---|---|
content | String | Der 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.
get Blob()
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.
get Map Image()
Ruft die Rohbilddaten als Byte-Array ab.
Im Allgemeinen sollten Sie get 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.
get Map Url()
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.
set Center(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
| Name | Typ | Beschreibung |
|---|---|---|
latitude | Number | Der Breitengrad des Mittelpunkts. |
longitude | Number | Der Längengrad des Mittelpunkts. |
Rückflug
Static: Diese Karteninstanz zur Verkettung.
Weitere Informationen
set Center(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
| Name | Typ | Beschreibung |
|---|---|---|
address | String | Die Adresse des Zentrums. |
Rückflug
Static: Diese Karteninstanz zur Verkettung.
Weitere Informationen
set Custom Marker Style(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
| Name | Typ | Beschreibung |
|---|---|---|
image | String | Gibt 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. |
use | Boolean | Gibt 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
Static: Diese Karteninstanz zur Verkettung.
Weitere Informationen
set Format(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
| Name | Typ | Beschreibung |
|---|---|---|
format | String | Ein konstanter Wert aus Format. |
Rückflug
Static: Diese Karteninstanz zur Verkettung.
Weitere Informationen
set Language(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
| Name | Typ | Beschreibung |
|---|---|---|
language | String | Eine BCP-47-Sprachkennung. |
Rückflug
Static: Diese Karteninstanz zur Verkettung.
Weitere Informationen
set Map Type(mapType)
set Marker Style(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
| Name | Typ | Beschreibung |
|---|---|---|
size | String | Ein konstanter Wert aus Marker. |
color | String | Ein String im Format „0xrrggbb“ oder ein konstanter Wert aus Color. |
label | String | Ein String mit einem einzelnen Zeichen A–Z oder 0–9. |
Rückflug
Static: Diese Karteninstanz zur Verkettung.
Weitere Informationen
set Mobile(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
| Name | Typ | Beschreibung |
|---|---|---|
use | Boolean | Gibt an, ob mobile Kacheln verwendet werden sollen. |
Rückflug
Static: Diese Karteninstanz zur Verkettung.
set Path Style(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
| Name | Typ | Beschreibung |
|---|---|---|
weight | Integer | Die Breite von Linien in Pixeln. |
color | String | Die Linienfarbe als String im Format „0xrrggbb“ oder als konstanter Wert aus Color. |
fill | String | Die Füllfarbe, ein String im Format „0xrrggbb“ oder ein konstanter Wert aus Color. |
Rückflug
Static: Diese Karteninstanz zur Verkettung.
Weitere Informationen
set Size(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
| Name | Typ | Beschreibung |
|---|---|---|
width | Integer | Die Breite des Bilds in Pixeln |
height | Integer | Die Höhe des Bilds in Pixeln |
Rückflug
Static: Diese Karteninstanz zur Verkettung.
Weitere Informationen
set Zoom(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
| Name | Typ | Beschreibung |
|---|---|---|
zoom | Integer | Ein Wert zwischen 0 und 21 (einschließlich). |
Rückflug
Static: Diese Karteninstanz zur Verkettung.