Class StaticMap

StaticMap

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

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

// Create a map centered on Times Square.
var 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.
var 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 (var i = 0; i < corners.length; i++) {
  map.addAddress(corners[i]);
}
// All static map URLs require an API key.
var url = map.getMapUrl() + "&key=YOUR_API_KEY";

Xem thêm

Phương thức

Phương thứcLoại 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 điểm đánh dấu vào bản đồ bằng cách sử dụng một điểm (vĩ độ/lng).
addMarker(address)StaticMapThêm điểm đánh dấu vào bản đồ bằng cách sử dụng địa chỉ.
addPath(points)StaticMapThêm đường dẫn vào bản đồ bằng cách sử dụng một mảng điểm.
addPath(polyline)StaticMapThêm đường dẫn vào bản đồ bằng hình nhiều đường được mã hoá.
addPoint(latitude, longitude)StaticMapThêm một điểm mới (vĩ độ/lng) vào định nghĩa đường dẫn hiện tại.
addVisible(latitude, longitude)StaticMapThêm một vị trí điểm (vĩ độ/lng) phải hiển thị trên bản đồ.
addVisible(address)StaticMapThêm vị trí địa chỉ phải hiển thị trong bản đồ.
beginPath()StaticMapBắt đầu một quy trình định nghĩa đường dẫn mới.
clearMarkers()StaticMapXóa bộ điểm đánh dấu hiện tại.
clearPaths()StaticMapXoá tập hợp đường dẫn hiện tại.
clearVisibles()StaticMapXóa nhóm vị trí hiển thị hiện tại.
endPath()StaticMapHoàn tất định nghĩa đường dẫn bắt đầu bằng startedPath().
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 được 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 bản đồ bằng cách sử dụng một điểm (vĩ độ/lng).
setCenter(address)StaticMapĐặt trung tâm của bản đồ bằng cách sử dụ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 của hình ảnh bản đồ.
setLanguage(language)StaticMapĐặt ngôn ngữ dùng cho văn bản trên bản đồ (nơi có avaialbe).
setMapType(mapType)StaticMapĐặt loại bản đồ sẽ được 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 có hoặc không sử dụng bộ ô dành riêng cho thiết bị di độ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 to được 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.
var map = Maps.newStaticMap()
    .beginPath()
    .addAddress('New York, NY')
    .addAddress('Boston, MA')
    .endPath();

Tham số

TênLoạiMô tả
addressStringĐị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 cách sử dụng một điểm (vĩ độ/lng). 

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

Tham 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 — Bản sao bản đồ này, để tạo chuỗi.

Xem thêm

addMarker(address)

Thêm đ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.
var map = Maps.newStaticMap().addMarker('76 9th Ave, New York NY');

Tham số

TênLoạiMô tả
addressStringĐịa chỉ tại đị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

addPath(points)

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

// Creates a map and adds a path from New York to Boston.
var map = Maps.newStaticMap()
    .addPath([40.714353, -74.005973, 42.358431, -71.059773]);

Tham số

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

Cầu thủ trả bóng

StaticMap — Bản sao bản đồ này, để tạo chuỗi.

addPath(polyline)

Thêm đường dẫn vào bản đồ bằng hình nhiều đường được mã hoá. 

// Creates a map and adds a path from New York to Boston.
var polyline = Maps.encodePolyline([40.714353, -74.005973, 42.358431, -71.059773]);
var map = Maps.newStaticMap().addPath(polyline);

Tham số

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

Cầu thủ trả bóng

StaticMap — Bản sao bản đồ này, để tạo chuỗi.

addPoint(latitude, longitude)

Thêm một điểm mới (vĩ độ/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.
var map = Maps.newStaticMap()
    .beginPath()
    .addPoint(40.714353, -74.005973)
    .addPoint(42.358431, -71.059773)
    .endPath();

Tham số

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

Cầu thủ trả bóng

StaticMap — Bản sao bản đồ này, để tạo chuỗi.

addVisible(latitude, longitude)

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

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

Tham số

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

Cầu thủ trả bóng

StaticMap — Bản sao bản đồ này, để tạo chuỗi.

Xem thêm

addVisible(address)

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

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

Tham số

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

Cầu thủ trả bóng

StaticMap — Bản sao bản đồ này, để tạo chuỗi.

Xem thêm

beginPath()

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

// Creates a map and adds a path from New York to Boston.
var 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()

Xóa bộ điểm đánh dấu hiện tại. 

var 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. 

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

Xóa nhóm vị trí hiển thị hiện tại. 

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

Cầu thủ trả bóng

StaticMap — Bản sao bản đồ này, để tạo chuỗi.

endPath()

Hoàn tất định nghĩa đường dẫn bắt đầu bằng StartedPath(). 

// Creates a map and adds a path from New York to Boston.
var map = Maps.newStaticMap()
    .beginPath()
    .addAddress('New York, NY')
    .addAddress('Boston, MA')
    .endPath();

Cầu thủ trả bóng

StaticMap — Bản sao 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 sang loại nội dung được chỉ định. Chiến dịch này sẽ thêm đuôi tệp thích hợp vào tên tệp (ví dụ: "myfile.pdf"). Tuy nhiên, việc này giả định rằng phần tên tệp tiếp sau dấu chấm cuối cùng (nếu có) là phần tên tệp hiện có tiện ích mở rộng cần được thay thế. Do đó, "ShoppingList.12.25.2014" 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 Google Dịch vụ. Các miền Google Workspace mới tạo có thể tạm thời bị áp dụng quy định nghiêm ngặt hơn hạn mức.

Tham 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, bất kỳ hình ảnh nào có định dạng 'image/bmp', 'image/gif', 'image/jpeg' hoặc 'image/png' cũng hợp lệ. Đối với tài liệu trên 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.
var map = Maps.newStaticMap().setCenter('Times Square, New York, NY');
DocsList.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 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.

Nói chung, hãy ưu tiên sử dụng getBlob() để có thể tương tác đơn giản hơn với những người dùng khác luôn miễn phí. 

// Creates a map centered on Times Square and saves it to Google Drive.
var map = Maps.newStaticMap().setCenter('Times Square, New York, NY');
DocsList.createFile(Utilities.newBlob(map.getMapImage(), 'image/png', 'map.png'));

Cầu thủ trả bóng

Byte[] — Hình ảnh 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.
var 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 bản đồ bằng cách sử dụng một điểm (vĩ độ/lng). 

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

Tham số

TênLoạiMô tả
latitudeNumberVĩ độ của tâm.
longitudeNumberKinh độ 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

setCenter(address)

Đặt trung tâm của bản đồ bằng cách sử dụng một địa chỉ. 

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

Tham số

TênLoạiMô tả
addressStringĐị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

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 đ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".
var map = Maps.newStaticMap()
    .setCustomMarkerStyle('http://www.example.com/marker.png', false);

Tham số

TênLoạiMô tả
imageUrlStringChỉ định một URL để sử 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 PNG.
useShadowBooleanCho biết điểm đánh dấu phải có bóng, dựa vào hình ảnh vùng hiển thị và độ mờ/độ trong suốt của vùng đó.

Cầu thủ trả bóng

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

Xem thêm

setFormat(format)

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

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

Tham số

TênLoạiMô tả
formatStringMột giá trị không đổi từ Format.

Cầu thủ trả bóng

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

Xem thêm

setLanguage(language)

Đặt ngôn ngữ dùng cho văn bản trên bản đồ (nơi có avaialbe). 

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

Tham số

TênLoạiMô tả
languageStringGiá 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

setMapType(mapType)

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

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

Tham số

TênLoạiMô tả
mapTypeStringMột giá trị không đổi từ Type.

Cầu thủ trả bóng

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

Xem thêm

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 đã được thêm không bị ảnh hưởng. 

// Creates a map with markers set to be medium sized, black, and labeled with the number "1".
var map = Maps.newStaticMap()
    .setMarkerStyle(Maps.StaticMap.MarkerSize.MID, Maps.StaticMap.Color.BLACK , '1');

Tham số

TênLoạiMô tả
sizeStringMột giá trị không đổi từ MarkerSize.
colorStringMột chuỗi có định dạng "0xrrggbb" hoặc một giá trị không đổi từ Color.
labelStringMộ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

setMobile(useMobileTiles)

Đặt có hoặc không sử dụng bộ ô dành riêng cho thiết bị di động. 

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

Tham số

TênLoạiMô tả
useMobileTilesBooleanCó sử dụng ô dành cho 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. Những đường dẫn đã được thêm vào thì 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.
var map = Maps.newStaticMap()
    .setPathStyle(1, Maps.StaticMap.Color.BLACK , 'red');

Tham số

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

Cầu thủ trả bóng

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

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.
var map = Maps.newStaticMap().setSize(400, 300);

Tham 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 — Phiên bản bản đồ này, để tạo chuỗi.

Xem thêm

setZoom(zoom)

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

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

Tham số

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

Cầu thủ trả bóng

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

Xem thêm