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
| Metoda | Zwracany typ | Krótki opis |
|---|---|---|
add | Static | Dodaje nowy adres do bieżącej definicji ścieżki. |
add | Static | Dodaje do mapy znacznik za pomocą punktu (szerokość/długość geograficzna). |
add | Static | Dodaje znacznik do mapy za pomocą adresu. |
add | Static | Dodaje ścieżkę do mapy za pomocą tablicy punktów. |
add | Static | Dodaje do mapy ścieżkę za pomocą zakodowanej linii łamanej. |
add | Static | Dodaje nowy punkt (szerokość/długość geograficzną) do bieżącej definicji ścieżki. |
add | Static | Dodaje lokalizację punktową (szerokość/długość geograficzną), która musi być widoczna 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 znaczników. |
clear | Static | Wyczyść bieżący zestaw ścieżek. |
clear | Static | Czyści bieżący zestaw widocznych lokalizacji. |
end | Static | Kończy definicję ścieżki rozpoczętą za pomocą metody beginPath(). |
get | Blob | Zwraca dane w tym obiekcie jako obiekt blob przekonwertowany na określony typ treści. |
get | Blob | Pobiera dane obrazu jako Blob. |
get | Byte[] | Pobiera surowe dane obrazu jako tablicę bajtów. |
get | String | Pobiera adres URL obrazu mapy. |
set | Static | Wyśrodkowuje mapę na punkcie (szerokość/długość geograficzna). |
set | Static | Wyśrodkowuje mapę na podstawie adresu. |
set | Static | Ustawia niestandardowy obraz markera, który będzie używany podczas tworzenia nowych markerów. |
set | Static | Ustawia format obrazu mapy. |
set | Static | Ustawia język, który ma być używany w tekście na mapie (jeśli jest dostępny). |
set | Static | Ustawia typ mapy, która ma być wyświetlana. |
set | Static | Ustawia styl znacznika, który będzie używany podczas tworzenia nowych znaczników. |
set | Static | Określa, czy na urządzeniach mobilnych mają być używane specjalistyczne zestawy kafelków. |
set | Static | Ustawia styl ścieżki, który będzie używany podczas tworzenia nowych ścieżek. |
set | Static | Ustawia szerokość i wysokość obrazu mapy w pikselach. |
set | Static | Ustawia współczynnik powiększenia lub 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 łączenia.
add Marker(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
| Nazwa | Typ | Opis |
|---|---|---|
latitude | Number | Szerokość geograficzna nowego znacznika. |
longitude | Number | Długość geograficzna nowego znacznika. |
Powrót
Static – ta instancja mapy do łączenia.
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 się znajdować nowy znacznik. |
Powrót
Static – ta instancja mapy do łączenia.
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, które określają ścieżkę. |
Powrót
Static – ta instancja mapy do łączenia.
add Path(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
| Nazwa | Typ | Opis |
|---|---|---|
polyline | String | Zakodowana linia łamana. |
Powrót
Static – ta instancja mapy do łączenia.
add Point(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
| Nazwa | Typ | Opis |
|---|---|---|
latitude | Number | Szerokość geograficzna punktu. |
longitude | Number | Długość geograficzna punktu. |
Powrót
Static – ta instancja mapy do łączenia.
add Visible(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
| Nazwa | Typ | Opis |
|---|---|---|
latitude | Number | Szerokość geograficzna punktu. |
longitude | Number | Długość geograficzna punktu. |
Powrót
Static – ta instancja mapy do łączenia.
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 łączenia.
Zobacz też
begin Path()
Rozpoczyna nową definicję ścieżki. Wywołania funkcji add i add definiują każdy nowy wierzchołek na ścieżce. Ścieżka zostanie ukończona po wywołaniu funkcji 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 łączenia.
clear Markers()
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
Static – ta instancja mapy do łączenia.
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 łączenia.
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 łączenia.
end Path()
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
Static – ta instancja mapy do łączenia.
get As(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
| Nazwa | Typ | Opis |
|---|---|---|
content | String | Typ 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.
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 surowe dane obrazu jako tablicę bajtów.
Zalecamy używanie get, 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.
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)
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
| Nazwa | Typ | Opis |
|---|---|---|
latitude | Number | Szerokość geograficzna środka. |
longitude | Number | Długość geograficzna środka. |
Powrót
Static – ta instancja mapy do łączenia.
Zobacz też
set Center(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
| Nazwa | Typ | Opis |
|---|---|---|
address | String | Adres centrum. |
Powrót
Static – ta instancja mapy do łączenia.
Zobacz też
set Custom Marker Style(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
| Nazwa | Typ | Opis |
|---|---|---|
image | String | Okreś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. |
use | Boolean | Wskazuje, że znacznik powinien mieć wygenerowany cień na podstawie widocznego regionu obrazu oraz jego krycia lub przezroczystości. |
Powrót
Static – ta instancja mapy do łączenia.
Zobacz też
set Format(format)
set Language(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
| Nazwa | Typ | Opis |
|---|---|---|
language | String | Identyfikator języka BCP-47. |
Powrót
Static – ta instancja mapy do łączenia.
Zobacz też
set Map Type(mapType)
set Marker Style(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
| Nazwa | Typ | Opis |
|---|---|---|
size | String | Stała wartość z Marker. |
color | String | Ciąg znaków w formacie „0xrrggbb” lub stała wartość z Color. |
label | String | Ciąg zawierający pojedynczy znak A–Z lub 0–9. |
Powrót
Static – ta instancja mapy do łączenia.
Zobacz też
set Mobile(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
| Nazwa | Typ | Opis |
|---|---|---|
use | Boolean | Określa, czy używać kart mobilnych. |
Powrót
Static – ta instancja mapy do łączenia.
set Path Style(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
| 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 łączenia.
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 łączenia.
Zobacz też
set Zoom(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
| Nazwa | Typ | Opis |
|---|---|---|
zoom | Integer | Wartość z zakresu od 0 do 21 włącznie. |
Powrót
Static – ta instancja mapy do łączenia.