Class StaticMap

Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
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ż

Metody

MetodaZwracany typKrótki opis
addAddress(address)StaticMapDodaje nowy adres do definicji bieżącej ścieżki.
addMarker(latitude, longitude)StaticMapDodaje znacznik do mapy za pomocą punktu (lat/lng).
addMarker(address)StaticMapDodaje znacznik do mapy przy użyciu adresu.
addPath(points)StaticMapDodaje ścieżkę do mapy przy użyciu tablicy punktów.
addPath(polyline)StaticMapDodaje ścieżkę do mapy za pomocą zakodowanej linii łamanej.
addPoint(latitude, longitude)StaticMapDodaje nowy punkt (lat/lng) do bieżącej definicji ścieżki.
addVisible(latitude, longitude)StaticMapDodaje lokalizację punktu (lata/długości), która musi być widoczna na mapie.
addVisible(address)StaticMapDodaje lokalizację adresu, która musi być widoczna na mapie.
beginPath()StaticMapUruchamia 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 rozpoczynaną od startPath().
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 jako tablicę bajtową.
getMapUrl()StringPobiera adres URL obrazu mapy.
setCenter(latitude, longitude)StaticMapUstawia środek mapy za pomocą punktu (lat/Lng).
setCenter(address)StaticMapUstawia środek mapy, używając adresu.
setCustomMarkerStyle(imageUrl, useShadow)StaticMapUstawia niestandardowy obraz znacznika do użycia podczas tworzenia nowych znaczników.
setFormat(format)StaticMapUstawia format obrazu mapy.
setLanguage(language)StaticMapOkreśla język tekstu na mapie (tam, gdzie ta funkcja jest dostępna).
setMapType(mapType)StaticMapOkreśla typ mapy, która ma się wyświetlać.
setMarkerStyle(size, color, label)StaticMapUstawia styl znacznika, który ma być używany podczas tworzenia nowych znaczników.
setMobile(useMobileTiles)StaticMapOkreśla, czy należy używać wyspecjalizowanych zestawów kafelków na urządzeniach mobilnych.
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 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

NazwaTypOpis
addressStringAdres 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

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

Zwróć

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

Zobacz też


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

NazwaTypOpis
addressStringAdres, gdzie należy umieścić nowy znacznik.

Zwróć

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

Zobacz też


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

NazwaTypOpis
pointsNumber[]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

NazwaTypOpis
polylineStringZakodowana 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

NazwaTypOpis
latitudeNumberSzerokość geograficzna punktu.
longitudeNumberDł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

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

Zwróć

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

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.

Zwróć

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

Zobacz też


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

NazwaTypOpis
contentTypeStringTyp 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

NazwaTypOpis
latitudeNumberSzerokość geograficzna pośrodku.
longitudeNumberDługość geograficzna środkowa.

Zwróć

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

Zobacz też


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

NazwaTypOpis
addressStringAdres centralny.

Zwróć

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

Zobacz też


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

NazwaTypOpis
imageUrlStringOkreś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.
useShadowBooleanWskazuje, ż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ż


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 od Format.

Zwróć

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

Zobacz też


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

NazwaTypOpis
languageStringIdentyfikator języka BCP-47.

Zwróć

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

Zobacz też


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

NazwaTypOpis
mapTypeStringWartość stała od Type.

Zwróć

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

Zobacz też


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

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

Zwróć

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

Zobacz też


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

NazwaTypOpis
useMobileTilesBooleanOkreś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

NazwaTypOpis
weightIntegerSzerokość linii w pikselach.
colorStringKolor linii w postaci ciągu w formacie "0xrrggbb" lub wartość stała z Color.
fillColorStringKolor 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ż


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.

Zwróć

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

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.
var map = Maps.newStaticMap().setZoom(10);

Parametry

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

Zwróć

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

Zobacz też