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ż

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 (szerokości/długości geograficznej).
addMarker(address)StaticMapDodaje do mapy znacznik na podstawie 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 (długość/długość geograficzna) do definicji bieżącej ścieżki.
addVisible(latitude, longitude)StaticMapDodaje lokalizację punktu (szerokości i długości geograficznej), 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()StaticMapUsuwa bieżący zestaw znaczników.
clearPaths()StaticMapWyczyść bieżący zestaw ścieżek.
clearVisibles()StaticMapUsuwa bieżący zestaw widocznych lokalizacji.
endPath()StaticMapKończy definicję ścieżki początek ścieżki().
getAs(contentType)BlobZwraca dane wewnątrz tego obiektu jako obiekt blob przekonwertowany na określony typ treści.
getBlob()BlobPobiera dane obrazu w formacie Blob.
getMapImage()Byte[]Pobiera nieprzetworzone dane obrazu w postaci tablicy bajtów.
getMapUrl()StringPobiera adres URL obrazu mapy.
setCenter(latitude, longitude)StaticMapUstawia środek mapy za pomocą punktu (długości/szerokości geograficznej).
setCenter(address)StaticMapUstawia środek mapy za pomocą adresu.
setCustomMarkerStyle(imageUrl, useShadow)StaticMapUstawia niestandardowy obraz znacznika, który będzie używany do tworzenia nowych znaczników.
setFormat(format)StaticMapUstawia format obrazu mapy.
setLanguage(language)StaticMapUstawia język, w którym będzie wyświetlany tekst na mapie (tam, gdzie jest dostępny).
setMapType(mapType)StaticMapUstawia typ wyświetlanej mapy.
setMarkerStyle(size, color, label)StaticMapOkreśla styl znaczników do tworzenia nowych znaczników.
setMobile(useMobileTiles)StaticMapOkreśla, czy w przypadku urządzeń mobilnych mają być używane specjalistyczne zestawy kafelków.
setPathStyle(weight, color, fillColor)StaticMapOkreśla styl ścieżki, który będzie używany przy tworzeniu nowych ścieżek.
setSize(width, height)StaticMapUstawia szerokość i wysokość obrazu mapy w pikselach.
setZoom(zoom)StaticMapOkreś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

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

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

Powrót

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

Zobacz też


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

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

Powrót

StaticMap – ta instancja mapy na potrzeby 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ę.

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

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

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

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

Powrót

StaticMap – ta instancja mapy na potrzeby 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.

Powrót

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

Zobacz też


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

NazwaTypOpis
contentTypeStringTyp 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[] – zdjęcie 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

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

Powrót

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

Zobacz też


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

NazwaTypOpis
addressStringAdres centrum.

Powrót

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

Zobacz też


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

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


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

Powrót

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

Zobacz też


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

NazwaTypOpis
languageStringIdentyfikator języka w formacie BCP-47.

Powrót

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

Zobacz też


setMapType(mapType)

Ustawia typ wyświetlanej mapy.

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

Parametry

NazwaTypOpis
mapTypeStringStała wartość z pola Type.

Powrót

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

Zobacz też


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

NazwaTypOpis
sizeStringStała wartość z pola MarkerSize.
colorStringCiąg w formacie „0xrrggbb” lub stałą wartość z pola Color.
labelStringCią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ż


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

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

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 w formacie „0xrrggbb”. lub stała wartość z Color

Powrót

StaticMap – ta instancja mapy na potrzeby 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.

Powrót

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

Zobacz też


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

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

Powrót

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

Zobacz też