Class StaticMap

StaticMap

Umożliwia tworzenie i zdobienie statycznych obrazów mapy.

Przykład poniżej pokazuje, jak za pomocą tej klasy utworzyć mapę Teatralnego Dzielnicy w Nowym Jorku, w tym pobliskich stacji kolejowych, i wyświetlić ją w prostej aplikacji internetowej.

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

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 za pomocą punktu (lat/lng).
addMarker(address)StaticMapDodaje znacznik do mapy za pomocą 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ść geograficzna) do bieżącej definicji ścieżki.
addVisible(latitude, longitude)StaticMapDodaje punkt (szerokość/długość geograficzna) lokalizacji, który musi być widoczny na mapie.
addVisible(address)StaticMapDodaje lokalizację adresu, która musi być widoczna na mapie.
beginPath()StaticMapRozpoczyna nową definicję ścieżki.
clearMarkers()StaticMapCzyści bieżący zestaw pisaków.
clearPaths()StaticMapWyczyść bieżący zestaw ścieżek.
clearVisibles()StaticMapCzyści bieżący zestaw widocznych lokalizacji.
endPath()StaticMapDopełnia definicję ścieżki rozpoczętej za pomocą beginPath().
getAs(contentType)BlobZwraca dane z tego obiektu jako blob przekonwertowany na określony typ treści.
getBlob()BlobPobiera dane obrazu jako Blob.
getMapImage()Byte[]Pobiera dane nieprzetworzonego obrazu jako tablicę bajtów.
getMapUrl()StringPobiera adres URL obrazu mapy.
setCenter(latitude, longitude)StaticMapUstawia środek mapy za pomocą punktu (szerokość/długość geograficzna).
setCenter(address)StaticMapUstawia środek mapy za pomocą adresu.
setCustomMarkerStyle(imageUrl, useShadow)StaticMapUstawia obraz niestandardowego znacznika, który ma być używany podczas tworzenia nowych znaczników.
setFormat(format)StaticMapUstawia format obrazu mapy.
setLanguage(language)StaticMapUstawia język, który ma być używany do tekstu na mapie (gdzie jest dostępny).
setMapType(mapType)StaticMapOkreśla typ mapy, która ma być wyświetlana.
setMarkerStyle(size, color, label)StaticMapUstawia styl znacznika do użycia podczas tworzenia nowych znaczników.
setMobile(useMobileTiles)StaticMapOkreśla, czy na urządzeniach mobilnych mają być używane specjalne zestawy płytek.
setPathStyle(weight, color, fillColor)StaticMapOkreśla styl ścieżki, który ma być używany podczas tworzenia nowych ścieżek.
setSize(width, height)StaticMapUstawia szerokość i wysokość obrazu mapy w pikselach.
setZoom(zoom)StaticMapUstawia współczynnik powiększenia, czyli poziom powiększenia, używany na mapie.

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.
const map = Maps.newStaticMap()
                .beginPath()
                .addAddress('New York, NY')
                .addAddress('Boston, MA')
                .endPath();

Parametry

NazwaTypOpis
addressStringAdres do dodania.

Powrót

StaticMap – ta instancja mapy, do łańcuchowania.


addMarker(latitude, longitude)

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

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

Parametry

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

Powrót

StaticMap – ta instancja mapy, do łańcuchowania.

Zobacz też


addMarker(address)

Dodaje znacznik do mapy za pomocą adresu.

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

Parametry

NazwaTypOpis
addressStringAdres, pod którym ma zostać umieszczony nowy znacznik.

Powrót

StaticMap – ta instancja mapy, do łańcuchowania.

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.
const 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ę.

Powrót

StaticMap – ta instancja mapy, do łańcuchowania.


addPath(polyline)

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

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

Parametry

NazwaTypOpis
polylineStringzakodowana linia łamana;

Powrót

StaticMap – ta instancja mapy, do łańcuchowania.


addPoint(latitude, longitude)

Dodaje nowy punkt (szerokość/długość geograficzna) do bieżącej definicji ścieżki.

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

Parametry

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

Powrót

StaticMap – ta instancja mapy, do łańcuchowania.


addVisible(latitude, longitude)

Dodaje punkt (szerokość/długość geograficzna) lokalizacji, który musi być widoczny na mapie.

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

Parametry

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

Powrót

StaticMap – ta instancja mapy, do łańcuchowania.

Zobacz też


addVisible(address)

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

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

Parametry

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

Powrót

StaticMap – ta instancja mapy, do łańcuchowania.

Zobacz też


beginPath()

Rozpoczyna nową definicję ścieżki. Wywołania funkcji addAddress()addPoint() definiują każdy nowy wierzchołek na ścieżce. Ścieżka jest zakończona, gdy wywołana zostanie metoda endPath().

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

Powrót

StaticMap – ta instancja mapy, do łańcuchowania.


clearMarkers()

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

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

Powrót

StaticMap – ta instancja mapy, do łańcuchowania.


clearPaths()

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

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

Powrót

StaticMap – ta instancja mapy, do łańcuchowania.


clearVisibles()

Czyści bieżący zestaw widocznych lokalizacji.

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

Powrót

StaticMap – ta instancja mapy, do łańcuchowania.


endPath()

Dopełnia definicję ścieżki rozpoczętej za pomocą beginPath().

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

Powrót

StaticMap – ta instancja mapy, do łańcuchowania.


getAs(contentType)

Zwraca dane z tego obiektu jako blob przekonwertowany na określony typ treści. Ta metoda dodaje odpowiednie rozszerzenie do nazwy pliku, np. „mójplik.pdf”. Zakłada ona jednak, że część nazwy pliku, która następuje po ostatnim okresie (jeśli w ogóle występuje), to istniejące rozszerzenie, które należy zastąpić. W rezultacie plik „ShoppingList.12.25.2014” zmieni nazwę na „ShoppingList.12.25.pdf”.

Informacje o limitach dziennych konwersji znajdziesz w artykule Limity dotyczące usług Google. Nowo utworzone domeny Google Workspace mogą być tymczasowo objęte bardziej rygorystycznymi limitami.

Parametry

NazwaTypOpis
contentTypeStringTyp MIME, na który ma nastąpić konwersja. W przypadku większości blobów opcja 'application/pdf' jest jedyną prawidłową opcją. W przypadku obrazów w formacie BMP, GIF, JPEG lub PNG prawidłowe są również wartości 'image/bmp', 'image/gif', 'image/jpeg' lub 'image/png'. W przypadku dokumentu w Dokumentach Google możesz też użyć 'text/markdown'.

Powrót

Blob – dane w postaci bloba.


getBlob()

Pobiera dane obrazu jako Blob.

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

Powrót

Blob – obraz mapy w wybranym formacie.


getMapImage()

Pobiera dane nieprzetworzonego obrazu jako tablicę bajtów.

Zazwyczaj zalecamy używanie getBlob(), co pozwala na prostszą interakcję z innymi usługami.

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

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.
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`);

Powrót

String – URL adres URL obrazu mapy.


setCenter(latitude, longitude)

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

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

Parametry

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

Powrót

StaticMap – ta instancja mapy, do łańcuchowania.

Zobacz też


setCenter(address)

Ustawia środek mapy za pomocą adresu.

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

Parametry

NazwaTypOpis
addressStringAdres centrum.

Powrót

StaticMap – ta instancja mapy, do łańcuchowania.

Zobacz też


setCustomMarkerStyle(imageUrl, useShadow)

Ustawia obraz niestandardowego znacznika, który ma być używany podczas tworzenia nowych znaczników. Nie ma to 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".
const 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 format PNG.
useShadowBooleanWskazuje, że znacznik powinien mieć generowany cień na podstawie widocznego regionu obrazu i jego krycia/przezroczystości.

Powrót

StaticMap – ta instancja mapy, do łańcuchowania.

Zobacz też


setFormat(format)

Ustawia format obrazu mapy.

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

Parametry

NazwaTypOpis
formatStringWartość stała z Format.

Powrót

StaticMap – ta instancja mapy, do łańcuchowania.

Zobacz też


setLanguage(language)

Ustawia język, który ma być używany do tekstu na mapie (gdzie jest dostępny).

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

Parametry

NazwaTypOpis
languageStringIdentyfikator języka zgodny ze standardem BCP-47.

Powrót

StaticMap – ta instancja mapy, do łańcuchowania.

Zobacz też


setMapType(mapType)

Określa typ mapy, która ma być wyświetlana.

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

Parametry

NazwaTypOpis
mapTypeStringWartość stała z Type.

Powrót

StaticMap – ta instancja mapy, do łańcuchowania.

Zobacz też


setMarkerStyle(size, color, label)

Ustawia styl znacznika do użycia podczas tworzenia nowych znaczników. Nie dotyczy to już dodanych znaczników.

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

Parametry

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

Powrót

StaticMap – ta instancja mapy, do łańcuchowania.

Zobacz też


setMobile(useMobileTiles)

Określa, czy na urządzeniach mobilnych mają być używane specjalne zestawy płytek.

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

Parametry

NazwaTypOpis
useMobileTilesBooleanUżycie kart na urządzeniach mobilnych.

Powrót

StaticMap – ta instancja mapy, do łańcuchowania.


setPathStyle(weight, color, fillColor)

Określa styl ścieżki, który ma być używany podczas tworzenia nowych ścieżek. Ścieżki, które zostały już dodane, nie są na to w żaden sposób wpływane.

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

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.

Powrót

StaticMap – ta instancja mapy, do łańcuchowania.

Zobacz też


setSize(width, height)

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

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

Parametry

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

Powrót

StaticMap – ta instancja mapy, do łańcuchowania.

Zobacz też


setZoom(zoom)

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

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

Parametry

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

Powrót

StaticMap – ta instancja mapy, do łańcuchowania.

Zobacz też