Class StaticMap

Bản đồtĩnh

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 kịch nghệ của Thành phố New York, bao gồm cả các ga tàu gầ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

Phương thức

Phương thứcKiểu dữ liệu trả vềMô tả ngắn
addAddress(address)StaticMapThêm một địa chỉ mới vào định nghĩa đường dẫn hiện tại.
addMarker(latitude, longitude)StaticMapThêm một điểm đánh dấu vào bản đồ bằng cách sử dụng một điểm (vĩ độ/kinh độ).
addMarker(address)StaticMapThêm một điểm đánh dấu vào bản đồ bằng cách sử dụng địa chỉ.
addPath(points)StaticMapThêm một đường dẫn vào bản đồ bằng cách sử dụng một mảng gồm nhiều điểm.
addPath(polyline)StaticMapThêm một đường dẫn vào bản đồ bằng cách sử dụng một đường nhiều đoạn được mã hoá.
addPoint(latitude, longitude)StaticMapThêm một điểm mới (lat/lng) vào định nghĩa đường dẫn hiện tại.
addVisible(latitude, longitude)StaticMapThêm một vị trí điểm (lat/lng) phải xuất hiện trên bản đồ.
addVisible(address)StaticMapThêm một vị trí địa chỉ phải xuất hiện trên bản đồ.
beginPath()StaticMapBắt đầu một định nghĩa mới về đường dẫn.
clearMarkers()StaticMapXoá nhóm điểm đánh dấu hiện tại.
clearPaths()StaticMapXoá nhóm đường dẫn hiện tại.
clearVisibles()StaticMapXoá nhóm vị trí hiện tại đang hiển thị.
endPath()StaticMapHoàn tất một định nghĩa đường dẫn bắt đầu bằng beginPath().
getAs(contentType)BlobTrả về dữ liệu bên trong đối tượng này dưới dạng một blob được chuyển đổi sang loại nội dung đã chỉ định.
getBlob()BlobLấ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ột mảng byte.
getMapUrl()StringLấ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 (vĩ độ/kinh độ).
setCenter(address)StaticMapĐặt tâm của bản đồ bằng một đị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 cho hình ảnh bản đồ.
setLanguage(language)StaticMapĐặt ngôn ngữ sẽ dùng cho văn bản trên bản đồ (nếu có).
setMapType(mapType)StaticMapĐặt loại bản đồ sẽ xuất hiện.
setMarkerStyle(size, color, label)StaticMapĐặt kiểu dấu đánh dấu sẽ dùng khi tạo dấu đánh dấu mới.
setMobile(useMobileTiles)StaticMapĐặt xem có sử dụng các bộ ô 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 đồ theo pixel.
setZoom(zoom)StaticMapĐặt hệ số thu phóng hoặc mức phóng đại 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();

Thông số

TênLoạiMô tả
addressStringĐịa chỉ cần thêm.

Cầu thủ trả bóng

StaticMap – Thực thể bản đồ này, để liên kết.


addMarker(latitude, longitude)

Thêm một điểm đánh dấu vào bản đồ bằng cách sử dụng một điểm (vĩ độ/kinh độ).

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

Thông số

TênLoạiMô tả
latitudeNumberVĩ độ của điểm đánh dấu mới.
longitudeNumberKinh độ của điểm đánh dấu mới.

Cầu thủ trả bóng

StaticMap – Thực thể bản đồ này, để liên kết.

Xem thêm


addMarker(address)

Thêm một điểm đánh dấu vào bản đồ bằng cách sử dụ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');

Thông số

TênLoạiMô tả
addressStringĐịa chỉ để đặt điểm đánh dấu mới.

Cầu thủ trả bóng

StaticMap – Thực thể bản đồ này, để liên kết.

Xem thêm


addPath(points)

Thêm một đường dẫn vào bản đồ bằng cách sử dụng một mảng gồm nhiều đ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,
]);

Thông số

TênLoạiMô tả
pointsNumber[]Một mảng gồm các cặp vĩ độ/kinh độ xác định đường dẫn.

Cầu thủ trả bóng

StaticMap – Thực thể bản đồ này, để liên kết.


addPath(polyline)

Thêm một đường dẫn vào bản đồ bằng cách sử dụng một đường nhiều đoạn đượ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);

Thông số

TênLoạiMô tả
polylineStringMột đường nhiều đường được mã hoá.

Cầu thủ trả bóng

StaticMap – Thực thể bản đồ này, để liên kết.


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

Thông số

TênLoạiMô tả
latitudeNumberVĩ độ của điểm.
longitudeNumberKinh độ của điểm.

Cầu thủ trả bóng

StaticMap – Thực thể bản đồ này, để liên kết.


addVisible(latitude, longitude)

Thêm một vị trí điểm (lat/lng) phải xuất hiện trên 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);

Thông số

TênLoạiMô tả
latitudeNumberVĩ độ của điểm.
longitudeNumberKinh độ của điểm.

Cầu thủ trả bóng

StaticMap – Thực thể bản đồ này, để liên kết.

Xem thêm


addVisible(address)

Thêm một vị trí địa chỉ phải xuất hiện 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');

Thông số

TênLoạiMô tả
addressStringĐịa chỉ phải xuất hiện trên bản đồ.

Cầu thủ trả bóng

StaticMap – Thực thể bản đồ này, để liên kết.

Xem thêm


beginPath()

Bắt đầu một định nghĩa mới về đường dẫn. Các lệnh gọi đến addAddress()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 – Thực thể bản đồ này, để liên kết.


clearMarkers()

Xoá nhóm đ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 – Thực thể bản đồ này, để liên kết.


clearPaths()

Xoá nhóm đườ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 – Thực thể bản đồ này, để liên kết.


clearVisibles()

Xoá nhóm vị trí hiện tại đang hiển thị.

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

Cầu thủ trả bóng

StaticMap – Thực thể bản đồ này, để liên kết.


endPath()

Hoàn tất mộ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 – Thực thể bản đồ này, để liên kết.


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 sang loại nội dung đã chỉ định. Phương thức này sẽ thêm đuôi thích hợp vào tên tệp, chẳng hạn như "myfile.pdf". Tuy nhiên, phương thức 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 tiện ích 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 Hạn mức cho các 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 thủ hạn mức nghiêm ngặt hơn.

Thông số

TênLoạiMô tả
contentTypeStringLoại MIME cần chuyển đổi. Đối với hầu hết các blob, 'application/pdf' là lựa chọn hợp lệ duy nhất. Đối với hình ảnh ở định dạng BMP, GIF, JPEG hoặc PNG, mọi định dạng 'image/bmp', 'image/gif', 'image/jpeg' hoặc 'image/png' 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 một 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ột mảng byte.

Nhìn chung, bạn nên sử dụng getBlob() vì nó cho phép 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 hình ảnh bản đồ.


setCenter(latitude, longitude)

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

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

Thông số

TênLoạiMô tả
latitudeNumberVĩ độ của tâm.
longitudeNumberKinh độ của trung tâm.

Cầu thủ trả bóng

StaticMap – Thực thể bản đồ này, để liên kết.

Xem thêm


setCenter(address)

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

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

Thông số

TênLoạiMô tả
addressStringĐịa chỉ của trung tâm.

Cầu thủ trả bóng

StaticMap – Thực thể bản đồ này, để liên kết.

Xem thêm


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. Những dấu mốc đã được 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,
);

Thông số

TênLoạiMô tả
imageUrlStringChỉ đị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.
useShadowBooleanCho 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 – Thực thể bản đồ này, để liên kết.

Xem thêm


setFormat(format)

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

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

Thông số

TênLoạiMô tả
formatStringMột giá trị hằng số từ Format.

Cầu thủ trả bóng

StaticMap – Thực thể bản đồ này, để liên kết.

Xem thêm


setLanguage(language)

Đặt ngôn ngữ sẽ 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');

Thông số

TênLoạiMô tả
languageStringGiá trị nhận dạng ngôn ngữ BCP-47.

Cầu thủ trả bóng

StaticMap – Thực thể bản đồ này, để liên kết.

Xem thêm


setMapType(mapType)

Đặt loại bản đồ sẽ xuất hiện.

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

Thông số

TênLoạiMô tả
mapTypeStringMột giá trị hằng số từ Type.

Cầu thủ trả bóng

StaticMap – Thực thể bản đồ này, để liên kết.

Xem thêm


setMarkerStyle(size, color, label)

Đặt kiểu dấu đánh dấu sẽ dùng khi tạo dấu đánh dấu mới. Những điểm đánh dấu đã được 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',
);

Thông số

TênLoạiMô tả
sizeStringMột giá trị hằng số từ MarkerSize.
colorStringMột chuỗi ở định dạng "0xrrggbb" hoặc một giá trị hằng số từ Color.
labelStringMột chuỗi chứa một ký tự duy nhất từ A đến Z hoặc từ 0 đến 9.

Cầu thủ trả bóng

StaticMap – Thực thể bản đồ này, để liên kết.

Xem thêm


setMobile(useMobileTiles)

Đặt xem có sử dụng các bộ ô 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);

Thông số

TênLoạiMô tả
useMobileTilesBooleanCó sử dụng ô trên thiết bị di động hay không.

Cầu thủ trả bóng

StaticMap – Thực thể bản đồ này, để liên kết.


setPathStyle(weight, color, fillColor)

Đặt kiểu đường dẫn sẽ dùng khi tạo đường dẫn mới. Những đường dẫn đã được 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',
);

Thông số

TênLoạiMô tả
weightIntegerChiều rộng của các đường, tính bằng pixel.
colorStringMàu đường kẻ, dưới dạng một chuỗi có định dạng "0xrrggbb" hoặc một giá trị hằng số từ Color.
fillColorStringMàu nền, một chuỗi có định dạng "0xrrggbb" hoặc một giá trị hằng số từ Color.

Cầu thủ trả bóng

StaticMap – Thực thể bản đồ này, để liên kết.

Xem thêm


setSize(width, height)

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

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

Thông số

TênLoạiMô tả
widthIntegerChiều rộng của hình ảnh, tính bằng pixel.
heightIntegerChiều cao của hình ảnh tính bằng pixel.

Cầu thủ trả bóng

StaticMap – Thực thể bản đồ này, để liên kết.

Xem thêm


setZoom(zoom)

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

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

Thông số

TênLoạiMô tả
zoomIntegerMột giá trị từ 0 đến 21 (bao gồm cả 2 giá trị này).

Cầu thủ trả bóng

StaticMap – Thực thể bản đồ này, để liên kết.

Xem thêm