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
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 | Hiermit 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
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
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
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
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
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
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
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
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
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
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
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
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
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
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.