Class StaticMap

Mapa statyczna

Umożliwia tworzenie i dekorowanie statycznych obrazów map.

Poniższy przykład pokazuje, jak za pomocą tej klasy utworzyć mapę nowojorskiego teatru, w tym dworca kolejowego w pobliżu, i wyświetlić go w prostej aplikacji internetowej.

// 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";

Zobacz też

• Interfejs Google Static Maps API

Metody

Metoda	Zwracany typ	Krótki opis
addAddress(address)	StaticMap	Dodaje nowy adres do definicji bieżącej ścieżki.
addMarker(latitude, longitude)	StaticMap	Dodaje znacznik do mapy za pomocą punktu (lat/lng).
addMarker(address)	StaticMap	Dodaje znacznik do mapy przy użyciu adresu.
addPath(points)	StaticMap	Dodaje ścieżkę do mapy przy użyciu tablicy punktów.
addPath(polyline)	StaticMap	Dodaje ścieżkę do mapy za pomocą zakodowanej linii łamanej.
addPoint(latitude, longitude)	StaticMap	Dodaje nowy punkt (lat/lng) do bieżącej definicji ścieżki.
addVisible(latitude, longitude)	StaticMap	Dodaje lokalizację punktu (lata/długości), która musi być widoczna na mapie.
addVisible(address)	StaticMap	Dodaje lokalizację adresu, która musi być widoczna na mapie.
beginPath()	StaticMap	Uruchamia nową definicję ścieżki.
clearMarkers()	StaticMap	Czyści bieżący zestaw znaczników.
clearPaths()	StaticMap	Wyczyść bieżący zestaw ścieżek.
clearVisibles()	StaticMap	Czyści bieżący zestaw widocznych lokalizacji.
endPath()	StaticMap	Kończy definicję ścieżki rozpoczynaną od startPath().
getAs(contentType)	Blob	Zwraca dane wewnątrz tego obiektu jako obiekt blob przekonwertowany na określony typ treści.
getBlob()	Blob	Pobiera dane obrazu jako Blob.
getMapImage()	Byte[]	Pobiera nieprzetworzone dane obrazu jako tablicę bajtową.
getMapUrl()	String	Pobiera adres URL obrazu mapy.
setCenter(latitude, longitude)	StaticMap	Ustawia środek mapy za pomocą punktu (lat/Lng).
setCenter(address)	StaticMap	Ustawia środek mapy, używając adresu.
setCustomMarkerStyle(imageUrl, useShadow)	StaticMap	Ustawia niestandardowy obraz znacznika do użycia podczas tworzenia nowych znaczników.
setFormat(format)	StaticMap	Ustawia format obrazu mapy.
setLanguage(language)	StaticMap	Określa język tekstu na mapie (tam, gdzie ta funkcja jest dostępna).
setMapType(mapType)	StaticMap	Określa typ mapy, która ma się wyświetlać.
setMarkerStyle(size, color, label)	StaticMap	Ustawia styl znacznika, który ma być używany podczas tworzenia nowych znaczników.
setMobile(useMobileTiles)	StaticMap	Określa, czy należy używać wyspecjalizowanych zestawów kafelków na urządzeniach mobilnych.
setPathStyle(weight, color, fillColor)	StaticMap	Określa styl ścieżki, który ma być używany podczas tworzenia nowych ścieżek.
setSize(width, height)	StaticMap	Ustawia szerokość i wysokość obrazu mapy w pikselach.
setZoom(zoom)	StaticMap	Ustawia współczynnik powiększenia, czyli poziom powiększenia używany na mapie.

Szczegółowa dokumentacja

addAddress(address)

Dodaje nowy adres do definicji bieżącej ścieżki.

// 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();

Parametry

Nazwa	Typ	Opis
address	String	Adres do dodania.

Zwróć

StaticMap – to wystąpienie mapy na potrzeby łańcucha.

---

addMarker(latitude, longitude)

Dodaje znacznik do mapy za pomocą punktu (lat/lng).

// Creates a map and adds a marker at the specified coordinates.
var map = Maps.newStaticMap().addMarker(40.741799, -74.004207);

Parametry

Nazwa	Typ	Opis
latitude	Number	Szerokość geograficzna nowego znacznika.
longitude	Number	Długość geograficzna nowego znacznika.

Zwróć

StaticMap – to wystąpienie mapy na potrzeby łańcucha.

Zobacz też

• Interfejs Google Static Maps API

---

addMarker(address)

Dodaje znacznik do mapy przy użyciu adresu.

// Creates a map and adds a marker at the specified address.
var map = Maps.newStaticMap().addMarker('76 9th Ave, New York NY');

Parametry

Nazwa	Typ	Opis
address	String	Adres, gdzie należy umieścić nowy znacznik.

Zwróć

StaticMap – to wystąpienie mapy na potrzeby łańcucha.

Zobacz też

• Interfejs Google Static Maps API

---

addPath(points)

Dodaje ścieżkę do mapy przy użyciu tablicy punktów.

// 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]);

Parametry

Nazwa	Typ	Opis
points	Number[]	Tablica par szerokości i długości geograficznej, która określa ścieżkę.

Zwróć

StaticMap – to wystąpienie mapy na potrzeby łańcucha.

---

addPath(polyline)

Dodaje ścieżkę do mapy za pomocą zakodowanej linii łamanej.

// 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);

Parametry

Nazwa	Typ	Opis
polyline	String	Zakodowana linia łamana.

Zwróć

StaticMap – to wystąpienie mapy na potrzeby łańcucha.

---

addPoint(latitude, longitude)

Dodaje nowy punkt (lat/lng) do bieżącej definicji ścieżki.

// 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();

Parametry

Nazwa	Typ	Opis
latitude	Number	Szerokość geograficzna punktu.
longitude	Number	Długość geograficzna punktu.

Zwróć

StaticMap – to wystąpienie mapy na potrzeby łańcucha.

---

addVisible(latitude, longitude)

Dodaje lokalizację punktu (lata/długości), która musi być widoczna na mapie.

// Creates a map where New York and Boston are visible.
var map = Maps.newStaticMap()
    .addVisible(40.714353, -74.005973);
    .addVisible(42.358431, -71.059773)

Parametry

Nazwa	Typ	Opis
latitude	Number	Szerokość geograficzna punktu.
longitude	Number	Długość geograficzna punktu.

Zwróć

StaticMap – to wystąpienie mapy na potrzeby łańcucha.

Zobacz też

• Interfejs Google Static Maps API

---

addVisible(address)

Dodaje lokalizację adresu, która musi być widoczna na mapie.

// Creates a map where New York and Boston are visible.
var map = Maps.newStaticMap()
    .addVisible('New York, NY')
    .addVisible('Boston, MA');

Parametry

Nazwa	Typ	Opis
address	String	Adres, który musi być widoczny na mapie.

Zwróć

StaticMap – to wystąpienie mapy na potrzeby łańcucha.

Zobacz też

• Interfejs Google Static Maps API

---

beginPath()

Uruchamia nową definicję ścieżki. Wywołania addAddress() i addPoint() definiują każdy nowy wierzchołek na ścieżce. Ścieżka zostaje ukończona po wywołaniu funkcji endPath().

// 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();

Zwróć

StaticMap – to wystąpienie mapy na potrzeby łańcucha.

---

clearMarkers()

Czyści bieżący zestaw znaczników.

var map = Maps.newStaticMap();
// ...
// Do something interesting here ...
// ...
// Remove all markers on the map.
map.clearMarkers();

Zwróć

StaticMap – to wystąpienie mapy na potrzeby łańcucha.

---

clearPaths()

Wyczyść bieżący zestaw ścieżek.

var map = Maps.newStaticMap();
// ...
// Do something interesting here ...
// ...
// Remove all paths on the map.
map.clearPaths();

Zwróć

StaticMap – to wystąpienie mapy na potrzeby łańcucha.

---

clearVisibles()

Czyści bieżący zestaw widocznych lokalizacji.

var map = Maps.newStaticMap();
// ...
// Do something interesting here ...
// ...
// Remove all visible locations created with addVisible().
map.clearVisibles();

Zwróć

StaticMap – to wystąpienie mapy na potrzeby łańcucha.

---

endPath()

Kończy definicję ścieżki rozpoczynaną od startPath().

// 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();

Zwróć

StaticMap – to wystąpienie mapy na potrzeby łańcucha.

---

getAs(contentType)

Zwraca dane wewnątrz tego obiektu jako obiekt blob przekonwertowany na określony typ treści. Ta metoda dodaje odpowiednie rozszerzenie do nazwy pliku, np. „"myfile.pdf&quot”. Zakładamy jednak, że część nazwy pliku po ostatnim okresie (jeśli w ogóle) jest rozszerzeniem, które należy zastąpić. W związku z tym "ShoppingList.12.25.2014" zmienia się w "ShoppingList.12.25.pdf".

Aby sprawdzić dzienne limity konwersji, zobacz Limity usług Google. Nowo utworzone domeny Google Workspace mogą podlegać tymczasowym ograniczeniom.

Parametry

Nazwa	Typ	Opis
contentType	String	Typ MIME, na który ma zostać przekonwertowane. W większości blobów 'application/pdf' jest jedyną prawidłową opcją. W przypadku obrazów w formacie BMP, GIF, JPEG lub PNG prawidłowy jest też każdy z tych formatów: 'image/bmp', 'image/gif', 'image/jpeg' lub 'image/png'.

Zwróć

Blob – dane jako obiekt blob.

---

getBlob()

Pobiera dane obrazu jako Blob.

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

Zwróć

Blob – obraz mapy w wybranym formacie obrazu.

---

getMapImage()

Pobiera nieprzetworzone dane obrazu jako tablicę bajtową.

Ogólnie zalecamy używanie getBlob(), co ułatwia interakcje z innymi usługami.

// 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'));

Zwróć

Byte[] – obraz mapy w wybranym formacie obrazu.

---

getMapUrl()

Pobiera adres URL obrazu mapy.

// 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");

Zwróć

String – adres URL obrazu mapy.

---

setCenter(latitude, longitude)

Ustawia środek mapy za pomocą punktu (lat/Lng).

// Creates a map centered on Times Square, using its coordinates.
var map = Maps.newStaticMap().setCenter(40.759011, -73.984472);

Parametry

Nazwa	Typ	Opis
latitude	Number	Szerokość geograficzna pośrodku.
longitude	Number	Długość geograficzna środkowa.

Zwróć

StaticMap – to wystąpienie mapy na potrzeby łańcucha.

Zobacz też

• Interfejs Google Static Maps API

---

setCenter(address)

Ustawia środek mapy, używając adresu.

// Creates a map centered on Times Square, using its address.
var map = Maps.newStaticMap().setCenter('Times Square, New York, NY');

Parametry

Nazwa	Typ	Opis
address	String	Adres centralny.

Zwróć

StaticMap – to wystąpienie mapy na potrzeby łańcucha.

Zobacz też

• Interfejs Google Static Maps API

---

setCustomMarkerStyle(imageUrl, useShadow)

Ustawia niestandardowy obraz znacznika do użycia podczas tworzenia nowych znaczników. Ta zmiana nie ma wpływu na znaczniki, które zostały już dodane.

// 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);

Parametry

Nazwa	Typ	Opis
imageUrl	String	Określa adres URL, którego można użyć jako ikony niestandardowej znacznika. Obrazy mogą być w formacie PNG, JPEG lub GIF, ale zalecamy używanie formatu PNG.
useShadow	Boolean	Wskazuje, że znacznik powinien zostać wygenerowany cień na podstawie widocznego obszaru obrazu oraz jego przezroczystości/przejrzystości.

Zwróć

StaticMap – to wystąpienie mapy na potrzeby łańcucha.

Zobacz też

• Interfejs Google Static Maps API

---

setFormat(format)

Ustawia format obrazu mapy.

// Creates a map with the image format set to PNG.
var map = Maps.newStaticMap().setFormat(Maps.StaticMap.Format.PNG);

Parametry

Nazwa	Typ	Opis
format	String	Wartość stała od Format.

Zwróć

StaticMap – to wystąpienie mapy na potrzeby łańcucha.

Zobacz też

• Interfejs Google Static Maps API

---

setLanguage(language)

Określa język tekstu na mapie (tam, gdzie ta funkcja jest dostępna).

// Creates a map with the language set to French.
var map = Maps.newStaticMap().setLanguage('fr');

Parametry

Nazwa	Typ	Opis
language	String	Identyfikator języka BCP-47.

Zwróć

StaticMap – to wystąpienie mapy na potrzeby łańcucha.

Zobacz też

• Obsługa języków w interfejsach API Map Google

---

setMapType(mapType)

Określa typ mapy, która ma się wyświetlać.

// Creates a satellite map.
var map = Maps.newStaticMap().setMapType(Maps.StaticMap.Type.SATELLITE);

Parametry

Nazwa	Typ	Opis
mapType	String	Wartość stała od Type.

Zwróć

StaticMap – to wystąpienie mapy na potrzeby łańcucha.

Zobacz też

• Interfejs Google Static Maps API

---

setMarkerStyle(size, color, label)

Ustawia styl znacznika, który ma być używany podczas tworzenia nowych znaczników. Ta zmiana nie ma wpływu na znaczniki, które zostały już dodane.

// 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');

Parametry

Nazwa	Typ	Opis
size	String	Wartość stała od MarkerSize.
color	String	Ciąg w formacie "0xrrggbb&quot lub wartość stała z Color.
label	String	Ciąg zawierający pojedynczy znak A–Z lub 0–9.

Zwróć

StaticMap – to wystąpienie mapy na potrzeby łańcucha.

Zobacz też

• Interfejs Google Static Maps API

---

setMobile(useMobileTiles)

Określa, czy należy używać wyspecjalizowanych zestawów kafelków na urządzeniach mobilnych.

// Creates a map that uses mobile-friendly tiles.
var map = Maps.newStaticMap().setMobile(true);

Parametry

Nazwa	Typ	Opis
useMobileTiles	Boolean	Określa, czy chcesz używać kafelków na urządzeniach mobilnych.

Zwróć

StaticMap – to wystąpienie mapy na potrzeby łańcucha.

---

setPathStyle(weight, color, fillColor)

Określa styl ścieżki, który ma być używany podczas tworzenia nowych ścieżek. Nie ma to wpływu na już dodane ścieżki.

// 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');

Parametry

Nazwa	Typ	Opis
weight	Integer	Szerokość linii w pikselach.
color	String	Kolor linii w postaci ciągu w formacie "0xrrggbb" lub wartość stała z Color.
fillColor	String	Kolor wypełnienia, ciąg znaków w formacie &xtt;0xrrggbb&quot lub wartość stała z Color.

Zwróć

StaticMap – to wystąpienie mapy na potrzeby łańcucha.

Zobacz też

• Interfejs Google Static Maps API

---

setSize(width, height)

Ustawia szerokość i wysokość obrazu mapy w pikselach.

// Creates a map 400px wide by 300px high.
var map = Maps.newStaticMap().setSize(400, 300);

Parametry

Nazwa	Typ	Opis
width	Integer	Szerokość obrazu w pikselach.
height	Integer	Wysokość obrazu w pikselach.

Zwróć

StaticMap – to wystąpienie mapy na potrzeby łańcucha.

Zobacz też

• Interfejs Google Static Maps API

---

setZoom(zoom)

Ustawia współczynnik powiększenia, czyli poziom powiększenia używany na mapie.

// Creates a map with a zoom factor of 10.
var map = Maps.newStaticMap().setZoom(10);

Parametry

Nazwa	Typ	Opis
zoom	Integer	Wartość od 0 do 21 włącznie.

Zwróć

StaticMap – to wystąpienie mapy na potrzeby łańcucha.

Zobacz też

• Interfejs Google Static Maps API