Class StaticMap

StaticMap

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

Poniższy przykład pokazuje, jak za pomocą tej klasy utworzyć mapę New York City's Theatre District, w tym pobliskich stacji kolejowych, i wyświetlić ją 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ż

Metody

MetodaZwracany typKrótki opis
addAddress(address)StaticMapDodaje nowy adres do bieżącej definicji ścieżki.
addMarker(latitude, longitude)StaticMapDodaje znacznik do mapy przy użyciu punktu (szerokość/długość).
addMarker(address)StaticMapDodaje do mapy znacznik przy użyciu adresu.
addPath(points)StaticMapDodaje ścieżkę do mapy za pomocą tablicy punktów.
addPath(polyline)StaticMapDodaje ścieżkę do mapy za pomocą zakodowanej linii łamanej.
addPoint(latitude, longitude)StaticMapDodaje nowy punkt (szerokość/długość) do bieżącej definicji ścieżki.
addVisible(latitude, longitude)StaticMapDodaje lokalizację punktu (szerokość/długość), który musi być widoczny na mapie.
addVisible(address)StaticMapDodaje lokalizację adresu, która musi być widoczna na mapie.
beginPath()StaticMapUruchamia nową definicję ścieżki.
clearMarkers()StaticMapUsuwa bieżący zestaw znaczników.
clearPaths()StaticMapWyczyść bieżący zestaw ścieżek.
clearVisibles()StaticMapUsuwa bieżący zestaw widocznych lokalizacji.
endPath()StaticMapUkończenie definicji ścieżki rozpoczętej za pomocą funkcji startedPath().
getAs(contentType)BlobZwraca dane wewnątrz tego obiektu jako obiekt blob przekonwertowany na określony typ treści.
getBlob()BlobPobiera dane obrazu jako Blob.
getMapImage()Byte[]Pobiera nieprzetworzone dane obrazu w postaci tablicy bajtów.
getMapUrl()StringPobiera adres URL obrazu mapy.
setCenter(latitude, longitude)StaticMapWyśrodkowuje mapę za pomocą punktu (szerokość/długość).
setCenter(address)StaticMapWyśrodkowuje mapę na podstawie adresu.
setCustomMarkerStyle(imageUrl, useShadow)StaticMapUstawia niestandardowy obraz znacznika, który ma być używany do tworzenia nowych znaczników.
setFormat(format)StaticMapUstawia format obrazu mapy.
setLanguage(language)StaticMapUstawia język tekstu na mapie (jeśli jest dostępny).
setMapType(mapType)StaticMapOkreśla typ mapy do wyświetlenia.
setMarkerStyle(size, color, label)StaticMapUstawia styl znaczników, który ma być używany podczas tworzenia nowych znaczników.
setMobile(useMobileTiles)StaticMapOkreśla, czy mają być używane specjalne zestawy kafelków na urządzeniach mobilnych.
setPathStyle(weight, color, fillColor)StaticMapUstawia styl ścieżki, którego chcesz używać podczas tworzenia nowych ścieżek.
setSize(width, height)StaticMapUstawia szerokość i wysokość obrazu mapy w pikselach.
setZoom(zoom)StaticMapUmożliwia ustawienie współczynnika powiększenia (poziomu powiększenia) używanego do wyświetlania 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

NazwaTypOpis
addressStringAdres do dodania.

Powroty

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


addMarker(latitude, longitude)

Dodaje znacznik do mapy przy użyciu punktu (szerokość/długość).

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

Parametry

NazwaTypOpis
latitudeNumberSzerokość geograficzna nowego znacznika.
longitudeNumberDługość geograficzna nowego znacznika.

Powroty

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

Zobacz też


addMarker(address)

Dodaje do mapy znacznik 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

NazwaTypOpis
addressStringAdres, pod którym należy umieścić nowy znacznik.

Powroty

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

Zobacz też


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

NazwaTypOpis
pointsNumber[]Tablica par szerokości i długości geograficznej definiujących ścieżkę.

Powroty

StaticMap – ta instancja mapy do 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

NazwaTypOpis
polylineStringZakodowana linia łamana.

Powroty

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


addPoint(latitude, longitude)

Dodaje nowy punkt (szerokość/długość) 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

NazwaTypOpis
latitudeNumberSzerokość geograficzna punktu.
longitudeNumberDługość geograficzna punktu.

Powroty

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


addVisible(latitude, longitude)

Dodaje lokalizację punktu (szerokość/długość), który musi być widoczny 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

NazwaTypOpis
latitudeNumberSzerokość geograficzna punktu.
longitudeNumberDługość geograficzna punktu.

Powroty

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

Zobacz też


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

NazwaTypOpis
addressStringAdres, który musi być widoczny na mapie.

Powroty

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

Zobacz też


beginPath()

Uruchamia nową definicję ścieżki. Wywołania addAddress() i addPoint() definiują każdy nowy wierzchołek na ścieżce. Ścieżka jest 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();

Powroty

StaticMap – ta instancja mapy do 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();

Powroty

StaticMap – ta instancja mapy do 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();

Powroty

StaticMap – ta instancja mapy do 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();

Powroty

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


endPath()

Ukończenie definicji ścieżki rozpoczętej za pomocą funkcji startedPath().

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

Powroty

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


getAs(contentType)

Zwraca dane wewnątrz tego obiektu jako obiekt blob przekonwertowany na określony typ treści. Ta metoda dodaje do nazwy pliku odpowiednie rozszerzenie, na przykład „mójplik.pdf”. Zakładamy jednak, że część nazwy pliku, która występuje po ostatniej kropce (jeśli występuje), jest istniejącym rozszerzeniem, które należy zastąpić. W związku z tym „Lista zakupów.12.25.2014” zmieni się na „Lista zakupów.12.25.pdf”.

Aby sprawdzić dzienne limity konwersji, przeczytaj artykuł Limity w usługach Google. Nowo utworzone domeny Google Workspace mogą tymczasowo podlegać bardziej rygorystycznym limitom.

Parametry

NazwaTypOpis
contentTypeStringTyp MIME, na który ma zostać przekonwertowany. W przypadku większości obiektów blob jedyną prawidłową opcją jest 'application/pdf'. W przypadku zdjęć w formacie BMP, GIF, JPEG lub PNG obowiązują dowolne z tych wartości: 'image/bmp', 'image/gif', 'image/jpeg' i 'image/png'.

Powroty

Blob – dane w postaci obiektu 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.

Powroty

Blob – zdjęcie mapy w wybranym formacie graficznym.


getMapImage()

Pobiera nieprzetworzone dane obrazu w postaci tablicy bajtów.

Ogólnie zalecamy korzystanie z getBlob(), który umożliwia prostsze 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'));

Powroty

Byte[] – zdjęcie mapy w wybranym formacie graficznym.


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

Powroty

String – adres URL obrazu mapy.


setCenter(latitude, longitude)

Wyśrodkowuje mapę za pomocą punktu (szerokość/długość).

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

Parametry

NazwaTypOpis
latitudeNumberSzerokość geograficzna środka.
longitudeNumberDługość geograficzna środka.

Powroty

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

Zobacz też


setCenter(address)

Wyśrodkowuje mapę na podstawie adresu.

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

Parametry

NazwaTypOpis
addressStringAdres centrum.

Powroty

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

Zobacz też


setCustomMarkerStyle(imageUrl, useShadow)

Ustawia niestandardowy obraz znacznika, który ma być używany do tworzenia nowych znaczników. Nie ma to wpływu na już dodane znaczniki.

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

NazwaTypOpis
imageUrlStringOkreśla adres URL, który ma być używany jako niestandardowa ikona znacznika. Obrazy mogą być w formacie PNG, JPEG lub GIF, ale zalecamy ten format.
useShadowBooleanWskazuje, że w przypadku znacznika powinien być wygenerowany cień zależny od obszaru widocznego obrazu oraz jego przezroczystości/przezroczystości.

Powroty

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

Zobacz też


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

NazwaTypOpis
formatStringWartość stała z Format.

Powroty

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

Zobacz też


setLanguage(language)

Ustawia język tekstu na mapie (jeśli jest dostępny).

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

Parametry

NazwaTypOpis
languageStringIdentyfikator języka BCP-47.

Powroty

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

Zobacz też


setMapType(mapType)

Określa typ mapy do wyświetlenia.

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

Parametry

NazwaTypOpis
mapTypeStringWartość stała z Type.

Powroty

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

Zobacz też


setMarkerStyle(size, color, label)

Ustawia styl znaczników, który ma być używany podczas tworzenia nowych znaczników. Nie ma to wpływu na już dodane znaczniki.

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

NazwaTypOpis
sizeStringWartość stała z MarkerSize.
colorStringCiąg w formacie „0xrrggbb” lub stała wartość z Color.
labelStringCiąg tekstowy zawierający pojedynczy znak A–Z lub 0–9.

Powroty

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

Zobacz też


setMobile(useMobileTiles)

Określa, czy mają być używane specjalne zestawy kafelków na urządzeniach mobilnych.

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

Parametry

NazwaTypOpis
useMobileTilesBooleanOkreśla, czy chcesz używać kart na urządzenia mobilne.

Powroty

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


setPathStyle(weight, color, fillColor)

Ustawia styl ścieżki, którego chcesz używać podczas tworzenia nowych ścieżek. Nie ma to wpływu na dodane już ś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

NazwaTypOpis
weightIntegerSzerokość linii w pikselach.
colorStringKolor linii, jako ciąg znaków w formacie „0xrrggbb” lub stała wartość z Color.
fillColorStringKolor wypełnienia, ciąg znaków w formacie „0xrrggbb” lub stała wartość z Color.

Powroty

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

Zobacz też


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

NazwaTypOpis
widthIntegerSzerokość obrazu w pikselach.
heightIntegerWysokość obrazu w pikselach.

Powroty

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

Zobacz też


setZoom(zoom)

Umożliwia ustawienie współczynnika powiększenia (poziomu powiększenia) używanego do wyświetlania mapy.

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

Parametry

NazwaTypOpis
zoomIntegerWartość od 0 do 21 włącznie.

Powroty

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

Zobacz też