Class StaticMap

Statycznamapa

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

Przykład poniżej pokazuje, jak za pomocą tej klasy utworzyć mapę dzielnicy teatralnej 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 do mapy znacznik za pomocą punktu (szerokość/długość geograficzna).
addMarker(address)StaticMapDodaje znacznik do mapy za pomocą adresu.
addPath(points)StaticMapDodaje ścieżkę do mapy za pomocą tablicy punktów.
addPath(polyline)StaticMapDodaje do mapy ścieżkę za pomocą zakodowanej linii łamanej.
addPoint(latitude, longitude)StaticMapDodaje nowy punkt (szerokość/długość geograficzną) do bieżącej definicji ścieżki.
addVisible(latitude, longitude)StaticMapDodaje lokalizację punktową (szerokość/długość geograficzną), która musi być widoczna 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 znaczników.
clearPaths()StaticMapWyczyść bieżący zestaw ścieżek.
clearVisibles()StaticMapCzyści bieżący zestaw widocznych lokalizacji.
endPath()StaticMapKończy definicję ścieżki rozpoczętą za pomocą metody beginPath().
getAs(contentType)BlobZwraca dane w tym obiekcie jako obiekt blob przekonwertowany na określony typ treści.
getBlob()BlobPobiera dane obrazu jako Blob.
getMapImage()Byte[]Pobiera surowe dane obrazu jako tablicę bajtów.
getMapUrl()StringPobiera adres URL obrazu mapy.
setCenter(latitude, longitude)StaticMapWyśrodkowuje mapę na punkcie (szerokość/długość geograficzna).
setCenter(address)StaticMapWyśrodkowuje mapę na podstawie adresu.
setCustomMarkerStyle(imageUrl, useShadow)StaticMapUstawia niestandardowy obraz markera, który będzie używany podczas tworzenia nowych markerów.
setFormat(format)StaticMapUstawia format obrazu mapy.
setLanguage(language)StaticMapUstawia język, który ma być używany w tekście na mapie (jeśli jest dostępny).
setMapType(mapType)StaticMapUstawia typ mapy, która ma być wyświetlana.
setMarkerStyle(size, color, label)StaticMapUstawia styl znacznika, który będzie używany podczas tworzenia nowych znaczników.
setMobile(useMobileTiles)StaticMapOkreśla, czy na urządzeniach mobilnych mają być używane specjalistyczne zestawy kafelków.
setPathStyle(weight, color, fillColor)StaticMapUstawia styl ścieżki, który będzie 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 lub 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 łączenia.


addMarker(latitude, longitude)

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

// 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 łączenia.

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 się znajdować nowy znacznik.

Powrót

StaticMap – ta instancja mapy do łączenia.

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, które określają ścieżkę.

Powrót

StaticMap – ta instancja mapy do łączenia.


addPath(polyline)

Dodaje do mapy ścieżkę 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 łączenia.


addPoint(latitude, longitude)

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


addVisible(latitude, longitude)

Dodaje lokalizację punktową (szerokość/długość geograficzną), która musi być widoczna 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 łączenia.

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 łączenia.

Zobacz też


beginPath()

Rozpoczyna nową definicję ścieżki. Wywołania funkcji addAddress()addPoint() definiują każdy nowy wierzchołek na ścieżce. Ścieżka zostanie ukończona po wywołaniu funkcji 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 łączenia.


clearMarkers()

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

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

Powrót

StaticMap – ta instancja mapy do łączenia.


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 łączenia.


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 łączenia.


endPath()

Kończy definicję ścieżki rozpoczętą za pomocą metody 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 łączenia.


getAs(contentType)

Zwraca dane w tym obiekcie jako obiekt blob przekonwertowany na określony typ treści. Ta metoda dodaje do nazwy pliku odpowiednie rozszerzenie, np. „mójplik.pdf”. Zakłada jednak, że część nazwy pliku, która następuje po ostatniej kropce (jeśli występuje), jest istniejącym rozszerzeniem, które należy zastąpić. W konsekwencji nazwa „ShoppingList.12.25.2014” zmieni się na „ShoppingList.12.25.pdf”.

Aby wyświetlić dzienne limity konwersji, zapoznaj się z artykułem Limity usług Google. Nowo utworzone domeny Google Workspace mogą być tymczasowo objęte bardziej rygorystycznymi limitami.

Parametry

NazwaTypOpis
contentTypeStringTyp MIME, na który ma zostać przekonwertowany plik. W przypadku większości obiektów blob jedyną prawidłową opcją jest 'application/pdf'. W przypadku obrazów w formacie BMP, GIF, JPEG lub PNG prawidłowe są też znaki 'image/bmp', 'image/gif', 'image/jpeg' i 'image/png'. W przypadku dokumentu Google 'text/markdown' jest również prawidłowy.

Powrót

Blob – dane w formie obiektu blob.


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 surowe dane obrazu jako tablicę bajtów.

Zalecamy używanie getBlob(), które umożliwia prostsze interakcje 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)

Wyśrodkowuje mapę na punkcie (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 środka.
longitudeNumberDługość geograficzna środka.

Powrót

StaticMap – ta instancja mapy do łączenia.

Zobacz też


setCenter(address)

Wyśrodkowuje mapę na podstawie 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 łączenia.

Zobacz też


setCustomMarkerStyle(imageUrl, useShadow)

Ustawia niestandardowy obraz markera, który będzie używany podczas tworzenia nowych markerów. Nie ma to wpływu na dodane już znaczniki.

// 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 ikona niestandardowa markera. Obrazy mogą być w formacie PNG, JPEG lub GIF, ale zalecamy format PNG.
useShadowBooleanWskazuje, że znacznik powinien mieć wygenerowany cień na podstawie widocznego regionu obrazu oraz jego krycia lub przezroczystości.

Powrót

StaticMap – ta instancja mapy do łączenia.

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
formatStringStała wartość z Format.

Powrót

StaticMap – ta instancja mapy do łączenia.

Zobacz też


setLanguage(language)

Ustawia język, który ma być używany w tekście na mapie (jeśli jest dostępny).

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

Parametry

NazwaTypOpis
languageStringIdentyfikator języka BCP-47.

Powrót

StaticMap – ta instancja mapy do łączenia.

Zobacz też


setMapType(mapType)

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

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

Parametry

NazwaTypOpis
mapTypeStringStała wartość z Type.

Powrót

StaticMap – ta instancja mapy do łączenia.

Zobacz też


setMarkerStyle(size, color, label)

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

// 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
sizeStringStała wartość z MarkerSize.
colorStringCiąg znaków w formacie „0xrrggbb” lub stała wartość z Color.
labelStringCiąg zawierający pojedynczy znak A–Z lub 0–9.

Powrót

StaticMap – ta instancja mapy do łączenia.

Zobacz też


setMobile(useMobileTiles)

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

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

Parametry

NazwaTypOpis
useMobileTilesBooleanOkreśla, czy używać kart mobilnych.

Powrót

StaticMap – ta instancja mapy do łączenia.


setPathStyle(weight, color, fillColor)

Ustawia styl ścieżki, który będzie używany podczas tworzenia nowych ścieżek. Nie ma to wpływu na ścieżki, które zostały już dodane.

// 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 łączenia.

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 łączenia.

Zobacz też


setZoom(zoom)

Ustawia współczynnik powiększenia lub 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ść z zakresu od 0 do 21 włącznie.

Powrót

StaticMap – ta instancja mapy do łączenia.

Zobacz też