Class StaticMap

StaticMap

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

Poniższy przykład pokazuje, jak za pomocą tych zajęć utworzyć mapę nowojorskiego teatru dystrykt, w tym pobliskie stacje kolejowe, i wyświetlenie 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ż

• Statyczny interfejs Google Maps API

Metody

Metoda	Zwracany typ	Krótki opis
addAddress(address)	StaticMap	Dodaje nowy adres do bieżącej definicji ścieżki.
addMarker(latitude, longitude)	StaticMap	Dodaje znacznik do mapy za pomocą punktu (szerokości/długości geograficznej).
addMarker(address)	StaticMap	Dodaje do mapy znacznik na podstawie adresu.
addPath(points)	StaticMap	Dodaje ścieżkę do mapy za pomocą tablicy punktów.
addPath(polyline)	StaticMap	Dodaje ścieżkę do mapy za pomocą zakodowanej linii łamanej.
addPoint(latitude, longitude)	StaticMap	Dodaje nowy punkt (długość/długość geograficzna) do definicji bieżącej ścieżki.
addVisible(latitude, longitude)	StaticMap	Dodaje lokalizację punktu (szerokości i długości geograficznej), która musi być widoczna na mapie.
addVisible(address)	StaticMap	Dodaje lokalizację adresu, która musi być widoczna na mapie.
beginPath()	StaticMap	Rozpoczyna nową definicję ścieżki.
clearMarkers()	StaticMap	Usuwa bieżący zestaw znaczników.
clearPaths()	StaticMap	Wyczyść bieżący zestaw ścieżek.
clearVisibles()	StaticMap	Usuwa bieżący zestaw widocznych lokalizacji.
endPath()	StaticMap	Kończy definicję ścieżki początek ścieżki().
getAs(contentType)	Blob	Zwraca dane wewnątrz tego obiektu jako obiekt blob przekonwertowany na określony typ treści.
getBlob()	Blob	Pobiera dane obrazu w formacie Blob.
getMapImage()	Byte[]	Pobiera nieprzetworzone dane obrazu w postaci tablicy bajtów.
getMapUrl()	String	Pobiera adres URL obrazu mapy.
setCenter(latitude, longitude)	StaticMap	Ustawia środek mapy za pomocą punktu (szerokości/długości geograficznej).
setCenter(address)	StaticMap	Ustawia środek mapy za pomocą adresu.
setCustomMarkerStyle(imageUrl, useShadow)	StaticMap	Ustawia niestandardowy obraz znacznika, który będzie używany do tworzenia nowych znaczników.
setFormat(format)	StaticMap	Ustawia format obrazu mapy.
setLanguage(language)	StaticMap	Ustawia język, w którym będzie wyświetlany tekst na mapie (tam, gdzie jest dostępny).
setMapType(mapType)	StaticMap	Ustawia typ wyświetlanej mapy.
setMarkerStyle(size, color, label)	StaticMap	Określa styl znaczników do tworzenia nowych znaczników.
setMobile(useMobileTiles)	StaticMap	Określa, czy w przypadku urządzeń mobilnych mają być używane specjalistyczne zestawy kafelków.
setPathStyle(weight, color, fillColor)	StaticMap	Określa styl ścieżki, który będzie używany przy tworzeniu nowych ścieżek.
setSize(width, height)	StaticMap	Ustawia szerokość i wysokość obrazu mapy w pikselach.
setZoom(zoom)	StaticMap	Określa współczynnik powiększenia (poziom powiększenia mapy).

Szczegółowa dokumentacja

addAddress(address)

Dodaje nowy adres do bieżącej definicji ś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.

Powrót

StaticMap – ta instancja mapy na potrzeby tworzenia łańcuchów.

---

addMarker(latitude, longitude)

Dodaje znacznik do mapy za pomocą punktu (szerokości/długości geograficznej).

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

Powrót

StaticMap – ta instancja mapy na potrzeby tworzenia łańcuchów.

Zobacz też

• Statyczny interfejs Google Maps API

---

addMarker(address)

Dodaje do mapy znacznik na podstawie 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, pod którym ma zostać umieszczony nowy znacznik.

Powrót

StaticMap – ta instancja mapy na potrzeby tworzenia łańcuchów.

Zobacz też

• Statyczny interfejs Google Maps API

---

addPath(points)

Dodaje ścieżkę do mapy za pomocą 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 definiujących ścieżkę.

Powrót

StaticMap – ta instancja mapy na potrzeby tworzenia łańcuchów.

---

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.

Powrót

StaticMap – ta instancja mapy na potrzeby tworzenia łańcuchów.

---

addPoint(latitude, longitude)

Dodaje nowy punkt (długość/długość geograficzna) do definicji bieżącej ś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.

Powrót

StaticMap – ta instancja mapy na potrzeby tworzenia łańcuchów.

---

addVisible(latitude, longitude)

Dodaje lokalizację punktu (szerokości i długości geograficznej), 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.

Powrót

StaticMap – ta instancja mapy na potrzeby tworzenia łańcuchów.

Zobacz też

• Statyczny interfejs Google 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.

Powrót

StaticMap – ta instancja mapy na potrzeby tworzenia łańcuchów.

Zobacz też

• Statyczny interfejs Google Maps API

---

beginPath()

Rozpoczyna nową definicję ścieżki. Wywołania addAddress() i addPoint() definiują każde nowego wierzchołka na ścieżce. Ścieżka jest ukończona w chwili wywołania 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();

Powrót

StaticMap – ta instancja mapy na potrzeby tworzenia łańcuchów.

---

clearMarkers()

Usuwa bieżący zestaw znaczników.

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

Powrót

StaticMap – ta instancja mapy na potrzeby tworzenia łańcuchów.

---

clearPaths()

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

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

Powrót

StaticMap – ta instancja mapy na potrzeby tworzenia łańcuchów.

---

clearVisibles()

Usuwa bieżący zestaw widocznych lokalizacji.

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

Powrót

StaticMap – ta instancja mapy na potrzeby tworzenia łańcuchów.

---

endPath()

Kończy definicję ścieżki początek ś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();

Powrót

StaticMap – ta instancja mapy na potrzeby tworzenia łańcuchów.

---

getAs(contentType)

Zwraca dane wewnątrz tego obiektu jako obiekt blob przekonwertowany na określony typ treści. Ten dodaje do nazwy pliku odpowiednie rozszerzenie, na przykład „mojplik.pdf”. Jednak zakłada, że część nazwy pliku, która następuje po ostatnim kropce (jeśli występuje), jest już , które należy zastąpić. W rezultacie „ShoppingList.12.25.2014” zmienia się w „ShoppingList.12.25.pdf”.

Aby wyświetlić dzienne limity konwersji, zobacz Limity dla Google Usługi. Nowo utworzone domeny Google Workspace mogą być tymczasowo bardziej rygorystyczne limity.

Parametry

Nazwa	Typ	Opis
contentType	String	Typ MIME do skonwertowania. W przypadku większości blobów atrybut 'application/pdf' to jedyną prawidłową opcją. W przypadku zdjęć w formacie BMP, GIF, JPEG lub PNG możesz też użyć dowolnego z tych atrybutów: 'image/bmp', 'image/gif', 'image/jpeg' lub 'image/png'. prawidłowe. W przypadku dokumentów w Dokumentach Google prawidłowa jest też wartość 'text/markdown'.

Powrót

Blob – dane w postaci obiektu blob.

---

getBlob()

Pobiera dane obrazu w formacie 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.

Powrót

Blob – obraz mapy w wybranym formacie.

---

getMapImage()

Pobiera nieprzetworzone dane obrazu w postaci tablicy bajtów.

Ogólnie rzecz biorąc, wolisz używać usługi getBlob(), która ułatwia interakcje z innymi usług Google.

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

Powrót

Byte[] – obraz mapy w wybranym formacie.

---

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

Powrót

String – URL, adres URL obrazu mapy.

---

setCenter(latitude, longitude)

Ustawia środek mapy za pomocą punktu (szerokości/długości geograficznej).

// 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 środka.
longitude	Number	Długość geograficzna środka.

Powrót

StaticMap – ta instancja mapy na potrzeby tworzenia łańcuchów.

Zobacz też

• Statyczny interfejs Google Maps API

---

setCenter(address)

Ustawia środek mapy za pomocą 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 centrum.

Powrót

StaticMap – ta instancja mapy na potrzeby tworzenia łańcuchów.

Zobacz też

• Statyczny interfejs Google Maps API

---

setCustomMarkerStyle(imageUrl, useShadow)

Ustawia niestandardowy obraz znacznika, który będzie używany do tworzenia nowych znaczników. Znaczniki, które zostały już użyte nie wpływa na dodawane elementy.

// 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óry ma być używany jako niestandardowa ikona znacznika. Obrazy mogą być w formacie PNG, JPEG GIF, ale zalecamy format PNG.
useShadow	Boolean	Wskazuje, że dla znacznika powinien zostać wygenerowany cień na podstawie i przezroczystości.

Powrót

StaticMap – ta instancja mapy na potrzeby tworzenia łańcuchów.

Zobacz też

• Statyczny interfejs Google 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	Stała wartość z pola Format.

Powrót

StaticMap – ta instancja mapy na potrzeby tworzenia łańcuchów.

Zobacz też

• Statyczny interfejs Google Maps API

---

setLanguage(language)

Ustawia język, w którym będzie wyświetlany tekst na mapie (tam, gdzie jest dostępny).

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

Parametry

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

Powrót

StaticMap – ta instancja mapy na potrzeby tworzenia łańcuchów.

Zobacz też

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

---

setMapType(mapType)

Ustawia typ wyświetlanej mapy.

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

Parametry

Nazwa	Typ	Opis
mapType	String	Stała wartość z pola Type.

Powrót

StaticMap – ta instancja mapy na potrzeby tworzenia łańcuchów.

Zobacz też

• Statyczny interfejs Google Maps API

---

setMarkerStyle(size, color, label)

Określa styl znaczników do tworzenia nowych znaczników. Znaczniki, które zostały już dodane nie wpływa na to.

// 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	Stała wartość z pola MarkerSize.
color	String	Ciąg w formacie „0xrrggbb” lub stałą wartość z pola Color.
label	String	Ciąg tekstowy zawierający pojedynczy znak A–Z lub cyfry 0–9.

Powrót

StaticMap – ta instancja mapy na potrzeby tworzenia łańcuchów.

Zobacz też

• Statyczny interfejs Google Maps API

---

setMobile(useMobileTiles)

Określa, czy w przypadku urządzeń mobilnych mają być używane specjalistyczne zestawy kafelków.

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

Parametry

Nazwa	Typ	Opis
useMobileTiles	Boolean	Określa, czy używać kafelków mobilnych.

Powrót

StaticMap – ta instancja mapy na potrzeby tworzenia łańcuchów.

---

setPathStyle(weight, color, fillColor)

Określa styl ścieżki, który będzie używany przy tworzeniu nowych ścieżek. Dodane już ścieżki nie są dotkniętych problemem.

// 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 jako ciąg znaków w formacie „0xrrggbb”. lub stała wartość z Color
fillColor	String	Kolor wypełnienia, ciąg w formacie „0xrrggbb”. lub stała wartość z Color

Powrót

StaticMap – ta instancja mapy na potrzeby tworzenia łańcuchów.

Zobacz też

• Statyczny interfejs Google 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.

Powrót

StaticMap – ta instancja mapy na potrzeby tworzenia łańcuchów.

Zobacz też

• Statyczny interfejs Google Maps API

---

setZoom(zoom)

Określa współczynnik powiększenia (poziom powiększenia mapy).

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

Powrót

StaticMap – ta instancja mapy na potrzeby tworzenia łańcuchów.

Zobacz też

• Statyczny interfejs Google Maps API