可建立及裝飾靜態地圖圖片。
以下範例說明如何使用這個類別建立紐約市劇院區的地圖,包括附近的火車站,並在簡單的網路應用程式中顯示地圖。
// 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`;
另請參閱
方法
內容詳盡的說明文件
add Address(address)
在目前的路徑定義中新增地址。
// 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();
參數
名稱 | 類型 | 說明 |
---|---|---|
address | String | 要新增的地址。 |
回攻員
Static
:這個地圖執行個體,用於鏈結。
add Marker(latitude, longitude)
使用點 (緯/經) 在地圖上新增標記。
// Creates a map and adds a marker at the specified coordinates. const map = Maps.newStaticMap().addMarker(40.741799, -74.004207);
參數
名稱 | 類型 | 說明 |
---|---|---|
latitude | Number | 新標記的緯度。 |
longitude | Number | 新標記的經度。 |
回攻員
Static
:這個地圖例項,用於鏈結。
另請參閱
add Marker(address)
使用地址在地圖上新增標記。
// Creates a map and adds a marker at the specified address. const map = Maps.newStaticMap().addMarker('76 9th Ave, New York NY');
參數
名稱 | 類型 | 說明 |
---|---|---|
address | String | 要放置新標記的地址。 |
回攻員
Static
:這個地圖例項,用於鏈結。
另請參閱
add Path(points)
使用點陣列,在地圖中新增路徑。
// 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, ]);
參數
名稱 | 類型 | 說明 |
---|---|---|
points | Number[] | 定義路徑的經緯度組合陣列。 |
回攻員
Static
:這個地圖執行個體,用於鏈結。
add Path(polyline)
使用編碼後的折線,在地圖上新增路徑。
// 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);
參數
名稱 | 類型 | 說明 |
---|---|---|
polyline | String | 已編碼的折線。 |
回攻員
Static
:這個地圖執行個體,用於鏈結。
add Point(latitude, longitude)
在目前路徑定義中新增點 (緯/經)。
// 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();
參數
名稱 | 類型 | 說明 |
---|---|---|
latitude | Number | 點的緯度。 |
longitude | Number | 點的經度。 |
回攻員
Static
:這個地圖執行個體,用於鏈結。
add Visible(latitude, longitude)
新增必須在地圖中顯示的點 (經緯度) 位置。
// Creates a map where New York and Boston are visible. const map = Maps.newStaticMap() .addVisible(40.714353, -74.005973) .addVisible(42.358431, -71.059773);
參數
名稱 | 類型 | 說明 |
---|---|---|
latitude | Number | 點的緯度。 |
longitude | Number | 點的經度。 |
回攻員
Static
:這個地圖例項,用於鏈結。
另請參閱
add Visible(address)
新增必須在地圖上顯示的地址位置。
// Creates a map where New York and Boston are visible. const map = Maps.newStaticMap().addVisible('New York, NY').addVisible('Boston, MA');
參數
名稱 | 類型 | 說明 |
---|---|---|
address | String | 必須在地圖上顯示的地址。 |
回攻員
Static
:這個地圖執行個體,用於鏈結。
另請參閱
begin Path()
開始新的路徑定義。對 add
和 add
的呼叫會定義路徑中的每個新頂點。呼叫 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();
回攻員
Static
:這個地圖執行個體,用於鏈結。
clear Markers()
清除目前的標記集。
const map = Maps.newStaticMap(); // ... // Do something interesting here ... // ... // Remove all markers on the map. map.clearMarkers();
回攻員
Static
:此地圖執行個體,用於鏈結。
clear Paths()
清除目前的路徑組合。
const map = Maps.newStaticMap(); // ... // Do something interesting here ... // ... // Remove all paths on the map. map.clearPaths();
回攻員
Static
:這個地圖例項,用於鏈結。
clear Visibles()
清除目前的顯示位置集合。
const map = Maps.newStaticMap(); // ... // Do something interesting here ... // ... // Remove all visible locations created with addVisible(). map.clearVisibles();
回攻員
Static
:這個地圖執行個體,用於鏈結。
end Path()
完成以 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();
回攻員
Static
:這個地圖例項,用於鏈結。
get As(contentType)
將此物件內的資料傳回為轉換為指定內容類型的 Blob。這個方法會在檔案名稱中加入適當的副檔名,例如「myfile.pdf」。不過,系統會假設檔案名稱中最後一個句點 (如有) 後面的部分是應取代的現有副檔名。因此,「ShoppingList.12.25.2014」會變成「ShoppingList.12.25.pdf」。
如要查看轉換的每日配額,請參閱「Google 服務的配額」。新建立的 Google Workspace 網域可能會暫時受到更嚴格的配額限制。
參數
名稱 | 類型 | 說明 |
---|---|---|
content | String | 要轉換的 MIME 類型。對於大多數 Blob 而言,'application/pdf' 是唯一有效的選項。如果圖片為 BMP、GIF、JPEG 或 PNG 格式,'image/bmp' 、'image/gif' 、'image/jpeg' 或 'image/png' 也適用。如果是 Google 文件,'text/markdown' 也是有效的。 |
回攻員
Blob
:資料為 Blob。
get Blob()
取得圖片資料做為 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.
回攻員
Blob
:地圖圖片,採用所選圖片格式。
get Map Image()
以位元組陣列的形式取得原始圖片資料。
一般來說,建議使用 get
,這樣就能更輕鬆地與其他服務互動。
// 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'), );
回攻員
Byte[]
:地圖圖片,採用所選圖片格式。
get Map Url()
取得地圖圖片的網址。
// 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`);
回攻員
String
- 網址:地圖圖片網址。
set Center(latitude, longitude)
使用點 (經緯度) 設定地圖中心。
// Creates a map centered on Times Square, using its coordinates. const map = Maps.newStaticMap().setCenter(40.759011, -73.984472);
參數
名稱 | 類型 | 說明 |
---|---|---|
latitude | Number | 中心的緯度。 |
longitude | Number | 中心的經度。 |
回攻員
Static
:這個地圖例項,用於鏈結。
另請參閱
set Center(address)
使用地址設定地圖中心。
// Creates a map centered on Times Square, using its address. const map = Maps.newStaticMap().setCenter('Times Square, New York, NY');
參數
名稱 | 類型 | 說明 |
---|---|---|
address | String | 中心的地址。 |
回攻員
Static
:這個地圖例項,用於鏈結。
另請參閱
set Custom Marker Style(imageUrl, useShadow)
設定建立新標記時要使用的自訂標記圖片。已新增的標記不受影響。
// 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, );
參數
名稱 | 類型 | 說明 |
---|---|---|
image | String | 指定要用做標記自訂圖示的網址。圖片格式可為 PNG、JPEG 或 GIF,但建議使用 PNG。 |
use | Boolean | 表示標記應根據圖片的可見區域及其不透明度/透明度產生陰影。 |
回攻員
Static
:這個地圖執行個體,用於鏈結。
另請參閱
set Format(format)
set Language(language)
設定地圖文字的語言 (如有)。
// Creates a map with the language set to French. const map = Maps.newStaticMap().setLanguage('fr');
參數
名稱 | 類型 | 說明 |
---|---|---|
language | String | BCP-47 語言 ID。 |
回攻員
Static
:這個地圖例項,用於鏈結。
另請參閱
set Map Type(mapType)
set Marker Style(size, color, label)
設定建立新標記時要使用的標記樣式。已新增的標記不會受到影響。
// 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', );
參數
名稱 | 類型 | 說明 |
---|---|---|
size | String | Marker 中的常數值。 |
color | String | 格式為「0xrrggbb」的字串,或 Color 中的常數值。 |
label | String | 字串,包含單一字元 A-Z 或 0-9。 |
回攻員
Static
:這個地圖執行個體,用於鏈結。
另請參閱
set Mobile(useMobileTiles)
設定是否要使用行動裝置專用的資訊方塊組合。
// Creates a map that uses mobile-friendly tiles. const map = Maps.newStaticMap().setMobile(true);
參數
名稱 | 類型 | 說明 |
---|---|---|
use | Boolean | 是否使用行動資訊方塊。 |
回攻員
Static
:這個地圖執行個體,用於鏈結。
set Path Style(weight, color, fillColor)
設定建立新路徑時要使用的路徑樣式。已新增的路徑不會受到影響。
// 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', );
參數
名稱 | 類型 | 說明 |
---|---|---|
weight | Integer | 線條的寬度 (以像素為單位)。 |
color | String | 線條顏色,格式為「0xrrggbb」的字串,或 Color 中的常數值。 |
fill | String | 填充顏色,格式為「0xrrggbb」的字串,或 Color 中的常數值。 |
回攻員
Static
:這個地圖執行個體,用於鏈結。
另請參閱
set Size(width, height)
設定地圖圖片的寬度和高度 (單位為像素)。
// Creates a map 400px wide by 300px high. const map = Maps.newStaticMap().setSize(400, 300);
參數
名稱 | 類型 | 說明 |
---|---|---|
width | Integer | 圖片的寬度,以像素為單位。 |
height | Integer | 圖片的高度 (以像素為單位)。 |
回攻員
Static
:這個地圖執行個體,用於鏈結。
另請參閱
set Zoom(zoom)
設定地圖使用的縮放比例或放大倍率。
// Creates a map with a zoom factor of 10. const map = Maps.newStaticMap().setZoom(10);
參數
名稱 | 類型 | 說明 |
---|---|---|
zoom | Integer | 值介於 0 到 21 (含 0 和 21)。 |
回攻員
Static
:這個地圖執行個體,用於鏈結。