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 đồ Quận nhà hát của Thành phố New York, bao gồm 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. 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ức | Kiểu dữ liệu trả về | Mô tả ngắn |
---|---|---|
addAddress(address) | StaticMap | Thêm địa chỉ mới vào định nghĩa đường dẫn hiện tại. |
addMarker(latitude, longitude) | StaticMap | 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ĩ độ/lng). |
addMarker(address) | StaticMap | Thêm một điểm đánh dấu vào bản đồ bằng cách sử dụng địa chỉ. |
addPath(points) | StaticMap | Thêm một đường dẫn vào bản đồ bằng cách sử dụ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 hình nhiều đường được mã hoá. |
addPoint(latitude, longitude) | StaticMap | Thêm một điểm mới (vĩ độ/lng) vào định nghĩa đường đi hiện tại. |
addVisible(latitude, longitude) | StaticMap | Thêm một vị trí điểm (vĩ độ/lng) phải hiển thị trên 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á bộ đ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 các 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 startPath(). |
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 được 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ột 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 cách sử dụng một điểm (vĩ độ/lng). |
setCenter(address) | StaticMap | Đặt 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ữ được sử dụng cho văn bản trên bản đồ (nơi có sẵn). |
setMapType(mapType) | StaticMap | Đặt loại bản đồ được hiển thị. |
setMarkerStyle(size, color, label) | StaticMap | Đặt kiểu đánh dấu để sử dụng khi tạo điểm đánh dấu mới. |
setMobile(useMobileTiles) | StaticMap | Đặt 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 đồ tính bằng 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 đị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();
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
address | String | Địa chỉ cần thêm. |
Cầu thủ trả bóng
StaticMap
– Thực thể bản đồ này, để tạo chuỗi.
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ĩ độ/lng).
// Creates a map and adds a marker at the specified coordinates. var map = Maps.newStaticMap().addMarker(40.741799, -74.004207);
Các tham số
Tên | Loại | Nội dung 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
– Thực thể bản đồ này, để tạo chuỗi.
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. var map = Maps.newStaticMap().addMarker('76 9th Ave, New York NY');
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
address | String | Địa chỉ để đặt điểm đánh dấu mới. |
Cầu thủ trả bóng
StaticMap
– Thực thể bản đồ này, để tạo chuỗi.
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 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]);
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
points | Number[] | Một mảng các cặp vĩ độ/kinh độ xác định đường đi. |
Cầu thủ trả bóng
StaticMap
– Thực thể 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 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);
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
polyline | String | Một hình nhiều đường đã mã hoá. |
Cầu thủ trả bóng
StaticMap
– Thực thể 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 đi 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();
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
latitude | Number | Vĩ độ của điểm. |
longitude | Number | Kinh độ của điểm. |
Cầu thủ trả bóng
StaticMap
– Thực thể 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)
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
latitude | Number | Vĩ độ của điểm. |
longitude | Number | Kinh độ của điểm. |
Cầu thủ trả bóng
StaticMap
– Thực thể bản đồ này, để tạo chuỗi.
Xem thêm
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. var map = Maps.newStaticMap() .addVisible('New York, NY') .addVisible('Boston, MA');
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
address | String | Địa chỉ phải hiển thị trên bản đồ. |
Cầu thủ trả bóng
StaticMap
– Thực thể bản đồ này, để tạo chuỗi.
Xem thêm
beginPath()
Bắt đầu định nghĩa đường dẫn mới. Các lệnh gọi đến addAddress()
và addPoint()
sẽ xác định từng đỉnh mới trong đường dẫn. Đường dẫn đã 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
– Thực thể bản đồ này, để tạo chuỗi.
clearMarkers()
Xoá 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
– Thực thể 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
– Thực thể bản đồ này, để tạo chuỗi.
clearVisibles()
Xoá tập hợp các 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
– Thực thể bản đồ này, để tạo chuỗi.
endPath()
Hoàn tất định nghĩa đường dẫn bắt đầu bằng startPath().
// 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
– Thực thể 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 được chỉ định. Phương thức này sẽ thêm phần mở rộng thích hợp vào tên tệp – ví dụ: "myfile.pdf". Tuy nhiên, giả định rằng phần tên tệp đứng sau dấu chấm gần nhất (nếu có) là một đuôi tệp hiện có 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 các Dịch vụ của Google. Các miền Google Workspace mới tạo có thể tạm thời tuân theo định mức nghiêm ngặt hơn.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
contentType | String | Loại MIME cần chuyển đổi. Đố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 có định dạng BMP, GIF, JPEG hoặc PNG, mọi giá trị 'image/bmp' , 'image/gif' , 'image/jpeg' hay 'image/png' 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
— Một 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, hãy ưu tiên sử dụng getBlob()
để có thể 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. 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[]
— Một 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. 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 của 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);
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
latitude | Number | Vĩ độ của trung tâm. |
longitude | Number | Kinh độ của trung tâm. |
Cầu thủ trả bóng
StaticMap
– Thực thể bản đồ này, để tạo chuỗi.
Xem thêm
setCenter(address)
Đặt 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');
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
address | String | Địa chỉ của trung tâm. |
Cầu thủ trả bóng
StaticMap
– Thực thể 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 đã đượ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". var map = Maps.newStaticMap() .setCustomMarkerStyle('http://www.example.com/marker.png', false);
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
imageUrl | String | Chỉ đị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. |
useShadow | Boolean | Cho biết rằng điểm đánh dấu phải có hiệu ứng 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, để 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);
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
format | String | Một giá trị không đổi từ Format . |
Cầu thủ trả bóng
StaticMap
– Thực thể bản đồ này, để tạo chuỗi.
Xem thêm
setLanguage(language)
Đặt ngôn ngữ được sử dụng cho văn bản trên bản đồ (nơi có sẵn).
// Creates a map with the language set to French. var map = Maps.newStaticMap().setLanguage('fr');
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
language | String | Giá trị nhận dạng ngôn ngữ BCP-47. |
Cầu thủ trả bóng
StaticMap
– Thực thể bản đồ này, để tạo chuỗi.
Xem thêm
setMapType(mapType)
setMarkerStyle(size, color, label)
Đặt kiểu đánh dấu để sử dụng khi tạo điểm đá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". var map = Maps.newStaticMap() .setMarkerStyle(Maps.StaticMap.MarkerSize.MID, Maps.StaticMap.Color.BLACK , '1');
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
size | String | Một giá trị không đổi từ MarkerSize . |
color | String | Một chuỗi ở định dạng "0xrrggbb" hoặc một giá trị không đổi từ Color . |
label | String | Một chuỗi chứa một ký tự đơn A-Z hoặc 0-9. |
Cầu thủ trả bóng
StaticMap
– Thực thể bản đồ này, để tạo chuỗi.
Xem thêm
setMobile(useMobileTiles)
Đặt 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. var map = Maps.newStaticMap().setMobile(true);
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
useMobileTiles | Boolean | Chọn có sử dụng ô dành cho thiết bị di động hay không. |
Cầu thủ trả bóng
StaticMap
– Thực thể 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 đã đượ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. var map = Maps.newStaticMap() .setPathStyle(1, Maps.StaticMap.Color.BLACK , 'red');
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
weight | Integer | Chiều rộng của các đường tính bằng pixel. |
color | String | Màu đường kẻ, dưới dạng một chuỗi ở định dạng "0xrrggbb" hoặc một giá trị không đổi từ Color . |
fillColor | String | Màu tô, một chuỗi ở định dạng "0xrrggbb" hoặc một giá trị không đổi từ Color . |
Cầu thủ trả bóng
StaticMap
– Thực thể 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 đồ tính bằng pixel.
// Creates a map 400px wide by 300px high. var map = Maps.newStaticMap().setSize(400, 300);
Các tham số
Tên | Loại | Nội dung 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
– Thực thể 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);
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
zoom | Integer | Một giá trị từ 0 đến 21 (tính cả 2 giá trị đầu cuối). |
Cầu thủ trả bóng
StaticMap
– Thực thể bản đồ này, để tạo chuỗi.