Class StaticMap

StaticMap

Cho phép tạo và trang trí hình ảnh bản đồ tĩnh.

Ví dụ bên dưới cho thấy cách bạn có thể sử dụng lớp này để tạo bản đồ Khu nhà hát của Thành phố New York, bao gồm cả các ga tàu hỏa lân cận và hiển thị bản đồ đó trong một ứng dụng web đơn giản.

// 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`;

Xem thêm

• API Google Maps tĩnh

Phương thức

Phương thức	Loại dữ liệu trả về	Mô tả ngắn
addAddress(address)	StaticMap	Thêm một địa chỉ mới vào định nghĩa đường dẫn hiện tại.
addMarker(latitude, longitude)	StaticMap	Thêm điểm đánh dấu vào bản đồ bằng một điểm (lat/lng).
addMarker(address)	StaticMap	Thêm điểm đánh dấu vào bản đồ bằng địa chỉ.
addPath(points)	StaticMap	Thêm một đường dẫn vào bản đồ bằng một mảng các điểm.
addPath(polyline)	StaticMap	Thêm một đường dẫn vào bản đồ bằng cách sử dụng một đường đa giác được mã hoá.
addPoint(latitude, longitude)	StaticMap	Thêm một điểm mới (lat/lng) vào định nghĩa đường dẫn hiện tại.
addVisible(latitude, longitude)	StaticMap	Thêm một vị trí điểm (lat/lng) phải hiển thị trong bản đồ.
addVisible(address)	StaticMap	Thêm vị trí địa chỉ phải hiển thị trên bản đồ.
beginPath()	StaticMap	Bắt đầu định nghĩa đường dẫn mới.
clearMarkers()	StaticMap	Xoá tập hợp điểm đánh dấu hiện tại.
clearPaths()	StaticMap	Xoá tập hợp đường dẫn hiện tại.
clearVisibles()	StaticMap	Xoá tập hợp vị trí hiển thị hiện tại.
endPath()	StaticMap	Hoàn tất định nghĩa đường dẫn bắt đầu bằng beginPath().
getAs(contentType)	Blob	Trả về dữ liệu bên trong đối tượng này dưới dạng một blob được chuyển đổi thành loại nội dung đã chỉ định.
getBlob()	Blob	Lấy dữ liệu hình ảnh dưới dạng Blob.
getMapImage()	Byte[]	Lấy dữ liệu hình ảnh thô dưới dạng mảng byte.
getMapUrl()	String	Lấy URL của hình ảnh bản đồ.
setCenter(latitude, longitude)	StaticMap	Đặt tâm của bản đồ bằng một điểm (lat/lng).
setCenter(address)	StaticMap	Đặt tâm của bản đồ bằng địa chỉ.
setCustomMarkerStyle(imageUrl, useShadow)	StaticMap	Đặt hình ảnh điểm đánh dấu tuỳ chỉnh để sử dụng khi tạo điểm đánh dấu mới.
setFormat(format)	StaticMap	Đặt định dạng của hình ảnh bản đồ.
setLanguage(language)	StaticMap	Đặt ngôn ngữ sẽ được dùng cho văn bản trên bản đồ (nếu có).
setMapType(mapType)	StaticMap	Đặt loại bản đồ sẽ hiển thị.
setMarkerStyle(size, color, label)	StaticMap	Đặt kiểu điểm đánh dấu để sử dụng khi tạo điểm đánh dấu mới.
setMobile(useMobileTiles)	StaticMap	Đặt xem có sử dụng bộ thẻ thông tin chuyên biệt cho thiết bị di động hay không.
setPathStyle(weight, color, fillColor)	StaticMap	Đặt kiểu đường dẫn để sử dụng khi tạo đường dẫn mới.
setSize(width, height)	StaticMap	Đặt chiều rộng và chiều cao của hình ảnh bản đồ tính bằng pixel.
setZoom(zoom)	StaticMap	Đặt hệ số thu phóng hoặc mức độ phóng to dùng cho bản đồ.

Tài liệu chi tiết

addAddress(address)

Thêm một địa chỉ mới vào định nghĩa đường dẫn hiện tại.

// 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();

Tham số

Tên	Loại	Mô tả
address	String	Địa chỉ cần thêm.

Cầu thủ trả bóng

StaticMap – Phiên bản bản đồ này, để tạo chuỗi.

---

addMarker(latitude, longitude)

Thêm điểm đánh dấu vào bản đồ bằng một điểm (lat/lng).

// Creates a map and adds a marker at the specified coordinates.
const map = Maps.newStaticMap().addMarker(40.741799, -74.004207);

Tham số

Tên	Loại	Mô tả
latitude	Number	Vĩ độ của điểm đánh dấu mới.
longitude	Number	Kinh độ của điểm đánh dấu mới.

Cầu thủ trả bóng

StaticMap – Phiên bản bản đồ này, để tạo chuỗi.

Xem thêm

• API Google Maps tĩnh

---

addMarker(address)

Thêm điểm đánh dấu vào bản đồ bằng địa chỉ.

// Creates a map and adds a marker at the specified address.
const map = Maps.newStaticMap().addMarker('76 9th Ave, New York NY');

Tham số

Tên	Loại	Mô tả
address	String	Địa chỉ để đặt điểm đánh dấu mới.

Cầu thủ trả bóng

StaticMap – Phiên bản bản đồ này, để tạo chuỗi.

Xem thêm

• API Google Maps tĩnh

---

addPath(points)

Thêm một đường dẫn vào bản đồ bằng một mảng các điểm.

// 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,
]);

Tham số

Tên	Loại	Mô tả
points	Number[]	Một mảng các cặp vĩ độ/kinh độ xác định đường dẫn.

Cầu thủ trả bóng

StaticMap – Phiên bản bản đồ này, để tạo chuỗi.

---

addPath(polyline)

Thêm một đường dẫn vào bản đồ bằng cách sử dụng một đường đa giác được mã hoá.

// 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);

Tham số

Tên	Loại	Mô tả
polyline	String	Một đường đa giác được mã hoá.

Cầu thủ trả bóng

StaticMap – Phiên bản bản đồ này, để tạo chuỗi.

---

addPoint(latitude, longitude)

Thêm một điểm mới (lat/lng) vào định nghĩa đường dẫn hiện tại.

// 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();

Tham số

Tên	Loại	Mô tả
latitude	Number	Vĩ độ của điểm.
longitude	Number	Kinh độ của điểm.

Cầu thủ trả bóng

StaticMap – Phiên bản bản đồ này, để tạo chuỗi.

---

addVisible(latitude, longitude)

Thêm một vị trí điểm (lat/lng) phải hiển thị trong bản đồ.

// Creates a map where New York and Boston are visible.
const map = Maps.newStaticMap()
                .addVisible(40.714353, -74.005973)
                .addVisible(42.358431, -71.059773);

Tham số

Tên	Loại	Mô tả
latitude	Number	Vĩ độ của điểm.
longitude	Number	Kinh độ của điểm.

Cầu thủ trả bóng

StaticMap – Phiên bản bản đồ này, để tạo chuỗi.

Xem thêm

• API Google Maps tĩnh

---

addVisible(address)

Thêm vị trí địa chỉ phải hiển thị trên bản đồ.

// Creates a map where New York and Boston are visible.
const map =
    Maps.newStaticMap().addVisible('New York, NY').addVisible('Boston, MA');

Tham số

Tên	Loại	Mô tả
address	String	Địa chỉ phải hiển thị trong bản đồ.

Cầu thủ trả bóng

StaticMap – Phiên bản bản đồ này, để tạo chuỗi.

Xem thêm

• API Google Maps tĩnh

---

beginPath()

Bắt đầu định nghĩa đường dẫn mới. Các lệnh gọi đến addAddress() và addPoint() xác định từng đỉnh mới trong đường dẫn. Đường dẫn sẽ hoàn tất khi endPath() được gọi.

// 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();

Cầu thủ trả bóng

StaticMap – Phiên bản bản đồ này, để tạo chuỗi.

---

clearMarkers()

Xoá tập hợp điểm đánh dấu hiện tại.

const map = Maps.newStaticMap();
// ...
// Do something interesting here ...
// ...
// Remove all markers on the map.
map.clearMarkers();

Cầu thủ trả bóng

StaticMap – Phiên bản bản đồ này, để tạo chuỗi.

---

clearPaths()

Xoá tập hợp đường dẫn hiện tại.

const map = Maps.newStaticMap();
// ...
// Do something interesting here ...
// ...
// Remove all paths on the map.
map.clearPaths();

Cầu thủ trả bóng

StaticMap – Phiên bản bản đồ này, để tạo chuỗi.

---

clearVisibles()

Xoá tập hợp vị trí hiển thị hiện tại.

const map = Maps.newStaticMap();
// ...
// Do something interesting here ...
// ...
// Remove all visible locations created with addVisible().
map.clearVisibles();

Cầu thủ trả bóng

StaticMap – Phiên bản bản đồ này, để tạo chuỗi.

---

endPath()

Hoàn tất định nghĩa đường dẫn bắt đầu bằng 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();

Cầu thủ trả bóng

StaticMap – Phiên bản bản đồ này, để tạo chuỗi.

---

getAs(contentType)

Trả về dữ liệu bên trong đối tượng này dưới dạng một blob được chuyển đổi thành loại nội dung đã chỉ định. Phương thức này thêm đuôi tệp thích hợp vào tên tệp, ví dụ: "myfile.pdf". Tuy nhiên, hàm này giả định rằng phần tên tệp theo sau dấu chấm cuối cùng (nếu có) là một đuôi tệp hiện có cần được thay thế. Do đó, "ShoppingList.12.25.2014" sẽ trở thành "ShoppingList.12.25.pdf".

Để xem hạn mức hằng ngày cho lượt chuyển đổi, hãy xem bài viết Hạn mức cho Dịch vụ của Google. Các miền Google Workspace mới tạo có thể tạm thời phải tuân theo hạn mức nghiêm ngặt hơn.

Tham số

Tên	Loại	Mô tả
contentType	String	Loại MIME cần chuyển đổi sang. Đối với hầu hết các blob, 'application/pdf' là tuỳ chọn hợp lệ duy nhất. Đối với hình ảnh ở định dạng BMP, GIF, JPEG hoặc PNG, bất kỳ 'image/bmp', 'image/gif', 'image/jpeg' hoặc 'image/png' nào cũng đều hợp lệ. Đối với tài liệu Google Tài liệu, 'text/markdown' cũng hợp lệ.

Cầu thủ trả bóng

Blob – Dữ liệu dưới dạng blob.

---

getBlob()

Lấy dữ liệu hình ảnh dưới dạng 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.

Cầu thủ trả bóng

Blob – Hình ảnh của bản đồ ở định dạng hình ảnh đã chọn.

---

getMapImage()

Lấy dữ liệu hình ảnh thô dưới dạng mảng byte.

Nhìn chung, bạn nên sử dụng getBlob() để tương tác đơn giản hơn với các dịch vụ khác.

// 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'),
);

Cầu thủ trả bóng

Byte[] – Hình ảnh của bản đồ ở định dạng hình ảnh đã chọn.

---

getMapUrl()

Lấy URL của hình ảnh bản đồ.

// 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`);

Cầu thủ trả bóng

String – URL URL của hình ảnh bản đồ.

---

setCenter(latitude, longitude)

Đặt tâm của bản đồ bằng một điểm (lat/lng).

// Creates a map centered on Times Square, using its coordinates.
const map = Maps.newStaticMap().setCenter(40.759011, -73.984472);

Tham số

Tên	Loại	Mô tả
latitude	Number	Vĩ độ của tâm.
longitude	Number	Kinh độ của tâm.

Cầu thủ trả bóng

StaticMap – Phiên bản bản đồ này, để tạo chuỗi.

Xem thêm

• API Google Maps tĩnh

---

setCenter(address)

Đặt tâm của bản đồ bằng địa chỉ.

// Creates a map centered on Times Square, using its address.
const map = Maps.newStaticMap().setCenter('Times Square, New York, NY');

Tham số

Tên	Loại	Mô tả
address	String	Địa chỉ của trung tâm.

Cầu thủ trả bóng

StaticMap – Phiên bản bản đồ này, để tạo chuỗi.

Xem thêm

• API Google Maps tĩnh

---

setCustomMarkerStyle(imageUrl, useShadow)

Đặt hình ảnh điểm đánh dấu tuỳ chỉnh để sử dụng khi tạo điểm đánh dấu mới. Các điểm đánh dấu đã thêm sẽ không bị ảnh hưởng.

// 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,
);

Tham số

Tên	Loại	Mô tả
imageUrl	String	Chỉ định một URL để dùng làm biểu tượng tuỳ chỉnh của điểm đánh dấu. Hình ảnh có thể ở định dạng PNG, JPEG hoặc GIF, mặc dù bạn nên dùng định dạng PNG.
useShadow	Boolean	Cho biết rằng điểm đánh dấu phải có bóng được tạo, dựa trên vùng hiển thị của hình ảnh và độ mờ/độ trong suốt của hình ảnh đó.

Cầu thủ trả bóng

StaticMap – Phiên bản bản đồ này, để tạo chuỗi.

Xem thêm

• API Google Maps tĩnh

---

setFormat(format)

Đặt định dạng của hình ảnh bản đồ.

// Creates a map with the image format set to PNG.
const map = Maps.newStaticMap().setFormat(Maps.StaticMap.Format.PNG);

Tham số

Tên	Loại	Mô tả
format	String	Giá trị hằng số từ Format.

Cầu thủ trả bóng

StaticMap – Phiên bản bản đồ này, để tạo chuỗi.

Xem thêm

• API Google Maps tĩnh

---

setLanguage(language)

Đặt ngôn ngữ sẽ được dùng cho văn bản trên bản đồ (nếu có).

// Creates a map with the language set to French.
const map = Maps.newStaticMap().setLanguage('fr');

Tham số

Tên	Loại	Mô tả
language	String	Giá trị nhận dạng ngôn ngữ BCP-47.

Cầu thủ trả bóng

StaticMap – Phiên bản bản đồ này, để tạo chuỗi.

Xem thêm

• Hỗ trợ ngôn ngữ trong API Google Maps

---

setMapType(mapType)

Đặt loại bản đồ sẽ hiển thị.

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

Tham số

Tên	Loại	Mô tả
mapType	String	Giá trị hằng số từ Type.

Cầu thủ trả bóng

StaticMap – Phiên bản bản đồ này, để tạo chuỗi.

Xem thêm

• API Google Maps tĩnh

---

setMarkerStyle(size, color, label)

Đặt kiểu điểm đánh dấu để sử dụng khi tạo điểm đánh dấu mới. Các điểm đánh dấu đã thêm sẽ không bị ảnh hưởng.

// 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',
);

Tham số

Tên	Loại	Mô tả
size	String	Giá trị hằng số từ MarkerSize.
color	String	Một chuỗi ở định dạng "0xrrggbb" hoặc một giá trị hằng số từ Color.
label	String	Một chuỗi chứa một ký tự A-Z hoặc 0-9.

Cầu thủ trả bóng

StaticMap – Phiên bản bản đồ này, để tạo chuỗi.

Xem thêm

• API Google Maps tĩnh

---

setMobile(useMobileTiles)

Đặt xem có sử dụng bộ thẻ thông tin chuyên biệt cho thiết bị di động hay không.

// Creates a map that uses mobile-friendly tiles.
const map = Maps.newStaticMap().setMobile(true);

Tham số

Tên	Loại	Mô tả
useMobileTiles	Boolean	Liệu có sử dụng thẻ thông tin trên thiết bị di động hay không.

Cầu thủ trả bóng

StaticMap – Phiên bản bản đồ này, để tạo chuỗi.

---

setPathStyle(weight, color, fillColor)

Đặt kiểu đường dẫn để sử dụng khi tạo đường dẫn mới. Các đường dẫn đã thêm sẽ không bị ảnh hưởng.

// 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',
);

Tham số

Tên	Loại	Mô tả
weight	Integer	Chiều rộng của đường kẻ tính bằng pixel.
color	String	Màu của đường kẻ, dưới dạng chuỗi ở định dạng "0xrrggbb" hoặc giá trị hằng số từ Color.
fillColor	String	Màu tô, một chuỗi ở định dạng "0xrrggbb" hoặc một giá trị hằng số từ Color.

Cầu thủ trả bóng

StaticMap – Phiên bản bản đồ này, để tạo chuỗi.

Xem thêm

• API Google Maps tĩnh

---

setSize(width, height)

Đặt chiều rộng và chiều cao của hình ảnh bản đồ tính bằng pixel.

// Creates a map 400px wide by 300px high.
const map = Maps.newStaticMap().setSize(400, 300);

Tham số

Tên	Loại	Mô tả
width	Integer	Chiều rộng của hình ảnh tính bằng pixel.
height	Integer	Chiều cao của hình ảnh tính bằng pixel.

Cầu thủ trả bóng

StaticMap – Phiên bản bản đồ này, để tạo chuỗi.

Xem thêm

• API Maps Static của Google

---

setZoom(zoom)

Đặt hệ số thu phóng hoặc mức độ phóng to dùng cho bản đồ.

// Creates a map with a zoom factor of 10.
const map = Maps.newStaticMap().setZoom(10);

Tham số

Tên	Loại	Mô tả
zoom	Integer	Giá trị từ 0 đến 21.

Cầu thủ trả bóng

StaticMap – Phiên bản bản đồ này, để tạo chuỗi.

Xem thêm

• API Maps Static của Google