Ermöglicht die Erstellung und Dekoration statischer Kartenbilder.
Das folgende Beispiel zeigt, wie Sie mit dieser Klasse eine Karte des New York City Theatre District mit Bahnhöfen in der Nähe erstellen und in einer einfachen Web-App anzeigen können.
// 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
Methode | Rückgabetyp | Kurzbeschreibung |
---|---|---|
addAddress(address) | StaticMap | Fügt der aktuellen Pfaddefinition eine neue Adresse hinzu. |
addMarker(latitude, longitude) | StaticMap | Fügt der Karte eine Markierung mithilfe eines Punkts (lat/lng) hinzu. |
addMarker(address) | StaticMap | Fügt der Karte eine Markierung mithilfe einer Adresse hinzu. |
addPath(points) | StaticMap | Fügt der Karte mithilfe eines Arrays von Punkten einen Pfad hinzu. |
addPath(polyline) | StaticMap | Fügt der Karte mithilfe einer codierten Polylinie einen Pfad 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 die aktuelle Gruppe 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 Rohdaten des Bildes 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 die Mitte der Karte anhand 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 Kartenbildes fest. |
setLanguage(language) | StaticMap | Legt die Sprache fest, die für Text auf der Karte verwendet werden soll (wo 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 spezielle Kachelsätze für Mobilgeräte verwendet werden sollen. |
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 oder die Vergrößerungsstufe fest, der für die Karte verwendet wird. |
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. |
Return
StaticMap
: Diese Karteninstanz für Verkettungen.
addMarker(latitude, longitude)
Fügt der Karte eine Markierung mithilfe eines Punkts (lat/lng) 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. |
Return
StaticMap
: Diese Karteninstanz für Verkettungen.
Weitere Informationen
addMarker(address)
Fügt der Karte eine Markierung mithilfe einer Adresse 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. |
Return
StaticMap
: Diese Karteninstanz für Verkettungen.
Weitere Informationen
addPath(points)
Fügt der Karte mithilfe eines Arrays von Punkten einen Pfad 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 mit Breitengrad/Längengrad-Paaren, die den Pfad definieren. |
Return
StaticMap
: Diese Karteninstanz für Verkettungen.
addPath(polyline)
Fügt der Karte mithilfe einer codierten Polylinie einen Pfad 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. |
Return
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. |
Return
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. |
Return
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
Name | Typ | Beschreibung |
---|---|---|
address | String | Eine Adresse, die auf der Karte sichtbar sein muss. |
Return
StaticMap
: Diese Karteninstanz für Verkettungen.
Weitere Informationen
beginPath()
Startet eine neue Pfaddefinition. Durch Aufrufe von addAddress()
und addPoint()
wird jeder neue Scheitelpunkt im Pfad definiert. 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();
Return
StaticMap
: Diese Karteninstanz für Verkettungen.
clearMarkers()
Löscht die aktuelle Gruppe von Markierungen.
var map = Maps.newStaticMap(); // ... // Do something interesting here ... // ... // Remove all markers on the map. map.clearMarkers();
Return
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();
Return
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();
Return
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();
Return
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. Bei dieser Methode wird dem Dateinamen die entsprechende Erweiterung hinzugefügt, z. B. "myfile.pdf". Dabei wird jedoch davon ausgegangen, dass der Teil des Dateinamens, der auf den letzten Punkt (falls vorhanden) folgt, eine vorhandene Erweiterung ist, die ersetzt werden sollte. Aus „ShoppingList.12.25.2014“ wird dann „ShoppingList.12.25.pdf“.
Informationen zu den Tageskontingenten 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. Für Bilder im BMP-, GIF-, JPEG- oder PNG-Format sind auch 'image/bmp' , 'image/gif' , 'image/jpeg' oder 'image/png' gültig. |
Return
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.
Return
Blob
: Ein Bild der Karte im ausgewählten Bildformat.
getMapImage()
Ruft die Rohdaten des Bildes als Byte-Array ab.
Im Allgemeinen solltest du getBlob()
verwenden, das eine einfachere Interaktion mit anderen Diensten ermöglicht.
// 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'));
Return
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");
Return
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. |
Return
StaticMap
: Diese Karteninstanz für Verkettungen.
Weitere Informationen
setCenter(address)
Legt die Mitte der Karte anhand 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. |
Return
StaticMap
: Diese Karteninstanz für Verkettungen.
Weitere Informationen
setCustomMarkerStyle(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". 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 in den Formaten PNG, JPEG oder GIF vorliegen, empfohlen werden PNG. |
useShadow | Boolean | Gibt an, dass für die Markierung basierend auf dem sichtbaren Bereich des Bildes und seiner Deckkraft/Transparenz ein Schatten generiert werden soll. |
Return
StaticMap
: Diese Karteninstanz für Verkettungen.
Weitere Informationen
setFormat(format)
Legt das Format des Kartenbildes 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 . |
Return
StaticMap
: Diese Karteninstanz für Verkettungen.
Weitere Informationen
setLanguage(language)
Legt die Sprache fest, die für Text auf der Karte verwendet werden soll (wo 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-Sprachkennung. |
Return
StaticMap
: Diese Karteninstanz für Verkettungen.
Weitere Informationen
setMapType(mapType)
setMarkerStyle(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". 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 | Ein String im Format „0xrrggbb“ oder ein konstanter Wert aus Color . |
label | String | Ein String, der ein einzelnes Zeichen von A–Z oder 0–9 enthält. |
Return
StaticMap
: Diese Karteninstanz für Verkettungen.
Weitere Informationen
setMobile(useMobileTiles)
Legt fest, ob spezielle Kachelsätze für Mobilgeräte verwendet werden sollen.
// 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. |
Return
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 sind davon nicht betroffen.
// 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 Linienbreite in Pixeln. |
color | String | Die Linienfarbe als String im Format "0xrrggbb" oder als konstanter Wert aus Color . |
fillColor | String | Die Füllfarbe, ein String im Format „0xrrggbb“ oder ein konstanter Wert aus Color . |
Return
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
Name | Typ | Beschreibung |
---|---|---|
width | Integer | Die Breite des Bilds in Pixeln |
height | Integer | Die Höhe des Bilds in Pixeln |
Return
StaticMap
: Diese Karteninstanz für Verkettungen.
Weitere Informationen
setZoom(zoom)
Legt den Zoomfaktor oder die Vergrößerungsstufe fest, der für die Karte verwendet wird.
// Creates a map with a zoom factor of 10. var map = Maps.newStaticMap().setZoom(10);
Parameter
Name | Typ | Beschreibung |
---|---|---|
zoom | Integer | Ein Wert zwischen 0 und 21 (einschließlich) |
Return
StaticMap
: Diese Karteninstanz für Verkettungen.