Umożliwia tworzenie i dekorowanie statycznych obrazów mapy.
Przykład poniżej pokazuje, jak za pomocą tej klasy utworzyć mapę teatralnego kwartału 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
Metoda | Zwracany typ | Krótki opis |
---|---|---|
add | Static | Dodaje nowy adres do bieżącej definicji ścieżki. |
add | Static | Dodaje znacznik do mapy za pomocą punktu (lat/lng). |
add | Static | Dodaje znacznik do mapy za pomocą adresu. |
add | Static | Dodaje ścieżkę do mapy za pomocą tablicy punktów. |
add | Static | Dodaje ścieżkę do mapy za pomocą zakodowanej linii łamanej. |
add | Static | Dodaje nowy punkt (szerokość/długość geograficzna) do bieżącej definicji ścieżki. |
add | Static | Dodaje punkt (szerokość/długość geograficzna) lokalizacji, który musi być widoczny na mapie. |
add | Static | Dodaje lokalizację adresu, która musi być widoczna na mapie. |
begin | Static | Rozpoczyna nową definicję ścieżki. |
clear | Static | Czyści bieżący zestaw pisaków. |
clear | Static | Wyczyść bieżący zestaw ścieżek. |
clear | Static | Czyści bieżący zestaw widocznych lokalizacji. |
end | Static | Dopełnia definicję ścieżki rozpoczętej za pomocą beginPath(). |
get | Blob | Zwraca dane z tego obiektu jako blob przekonwertowany na określony typ treści. |
get | Blob | Pobiera dane obrazu jako Blob . |
get | Byte[] | Pobiera dane nieprzetworzonego obrazu jako tablicę bajtów. |
get | String | Pobiera adres URL obrazu mapy. |
set | Static | Ustawia środek mapy za pomocą punktu (szerokość/długość geograficzna). |
set | Static | Ustawia środek mapy za pomocą adresu. |
set | Static | Ustawia obraz niestandardowego znacznika, który ma być używany podczas tworzenia nowych znaczników. |
set | Static | Ustawia format obrazu mapy. |
set | Static | Ustawia język, którego ma być używany do tekstu na mapie (gdzie jest to dostępne). |
set | Static | Określa typ mapy, która ma być wyświetlana. |
set | Static | Ustawia styl znacznika do użycia podczas tworzenia nowych znaczników. |
set | Static | Określa, czy na urządzeniach mobilnych mają być używane specjalne zestawy płytek. |
set | Static | Określa styl ścieżki, który ma być używany podczas tworzenia nowych ścieżek. |
set | Static | Ustawia szerokość i wysokość obrazu mapy w pikselach. |
set | Static | Ustawia współczynnik powiększenia, czyli poziom powiększenia używany na mapie. |
Szczegółowa dokumentacja
add Address(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
Nazwa | Typ | Opis |
---|---|---|
address | String | Adres do dodania. |
Powrót
Static
– ta instancja mapy, do łańcucha.
add Marker(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
Nazwa | Typ | Opis |
---|---|---|
latitude | Number | Szerokość geograficzna nowego znacznika. |
longitude | Number | Długość geograficzna nowego znacznika. |
Powrót
Static
– ta instancja mapy, do łańcuchowania.
Zobacz też
add Marker(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
Nazwa | Typ | Opis |
---|---|---|
address | String | Adres, pod którym ma zostać umieszczony nowy znacznik. |
Powrót
Static
– ta instancja mapy, do łańcuchowania.
Zobacz też
add Path(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
Nazwa | Typ | Opis |
---|---|---|
points | Number[] | Tablica par szerokości i długości geograficznej definiujących ścieżkę. |
Powrót
Static
– ta instancja mapy, do łańcucha.
add Path(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
Nazwa | Typ | Opis |
---|---|---|
polyline | String | zakodowana linia łamana; |
Powrót
Static
– ta instancja mapy, do łańcuchowania.
add Point(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
Nazwa | Typ | Opis |
---|---|---|
latitude | Number | Szerokość geograficzna punktu. |
longitude | Number | Długość geograficzna punktu. |
Powrót
Static
– ta instancja mapy, do łańcucha.
add Visible(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
Nazwa | Typ | Opis |
---|---|---|
latitude | Number | Szerokość geograficzna punktu. |
longitude | Number | Długość geograficzna punktu. |
Powrót
Static
– ta instancja mapy, do łańcuchowania.
Zobacz też
add Visible(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
Nazwa | Typ | Opis |
---|---|---|
address | String | Adres, który musi być widoczny na mapie. |
Powrót
Static
– ta instancja mapy, do łańcuchowania.
Zobacz też
begin Path()
Rozpoczyna definiowanie nowej ścieżki. Wywołania funkcji add
i add
definiują każdy nowy wierzchołek na ścieżce. Ścieżka jest zakończona, gdy wywołana zostanie metoda end
.
// 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
Static
– ta instancja mapy, do łańcuchowania.
clear Markers()
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
Static
– ta instancja mapy, do łańcuchowania.
clear Paths()
Wyczyść bieżący zestaw ścieżek.
const map = Maps.newStaticMap(); // ... // Do something interesting here ... // ... // Remove all paths on the map. map.clearPaths();
Powrót
Static
– ta instancja mapy, do łańcucha.
clear Visibles()
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
Static
– ta instancja mapy, do łańcucha.
end Path()
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
Static
– ta instancja mapy, do łańcucha.
get As(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” staje się „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
Nazwa | Typ | Opis |
---|---|---|
content | String | Typ 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.
get Blob()
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.
get Map Image()
Pobiera dane nieprzetworzonego obrazu jako tablicę bajtów.
Zazwyczaj zalecamy używanie get
, 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.
get Map Url()
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.
set Center(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
Nazwa | Typ | Opis |
---|---|---|
latitude | Number | Szerokość geograficzna centrum. |
longitude | Number | Długość geograficzna centrum. |
Powrót
Static
– ta instancja mapy, do łańcuchowania.
Zobacz też
set Center(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
Nazwa | Typ | Opis |
---|---|---|
address | String | Adres centrum. |
Powrót
Static
– ta instancja mapy, do łańcucha.
Zobacz też
set Custom Marker Style(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
Nazwa | Typ | Opis |
---|---|---|
image | String | Okreś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. |
use | Boolean | Wskazuje, że znacznik powinien mieć generowany cień na podstawie widocznego regionu obrazu i jego krycia/przezroczystości. |
Powrót
Static
– ta instancja mapy, do łańcuchowania.
Zobacz też
set Format(format)
set Language(language)
Ustawia język, którego ma być używany do tekstu na mapie (gdzie jest to dostępne).
// Creates a map with the language set to French. const map = Maps.newStaticMap().setLanguage('fr');
Parametry
Nazwa | Typ | Opis |
---|---|---|
language | String | Identyfikator języka zgodny ze standardem BCP-47. |
Powrót
Static
– ta instancja mapy, do łańcuchowania.
Zobacz też
set Map Type(mapType)
set Marker Style(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
Nazwa | Typ | Opis |
---|---|---|
size | String | Wartość stała z Marker . |
color | String | Ciąg znaków w formacie „0xrrggbb” lub stała wartość z Color . |
label | String | Ciąg tekstowy zawierający 1 znak z zakresu A–Z lub 0–9. |
Powrót
Static
– ta instancja mapy, do łańcuchowania.
Zobacz też
set Mobile(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
Nazwa | Typ | Opis |
---|---|---|
use | Boolean | Użycie kart mobilnych. |
Powrót
Static
– ta instancja mapy, do łańcucha.
set Path Style(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
Nazwa | Typ | Opis |
---|---|---|
weight | Integer | Szerokość linii w pikselach. |
color | String | Kolor linii jako ciąg znaków w formacie „0xrrggbb” lub stała wartość z Color . |
fill | String | Kolor wypełnienia, ciąg znaków w formacie „0xrrggbb” lub stała wartość z Color . |
Powrót
Static
– ta instancja mapy, do łańcuchowania.
Zobacz też
set Size(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
Nazwa | Typ | Opis |
---|---|---|
width | Integer | Szerokość obrazu w pikselach. |
height | Integer | Wysokość obrazu w pikselach. |
Powrót
Static
– ta instancja mapy, do łańcuchowania.
Zobacz też
set Zoom(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
Nazwa | Typ | Opis |
---|---|---|
zoom | Integer | Wartość od 0 do 21 włącznie. |
Powrót
Static
– ta instancja mapy, do łańcucha.