Cho phép truy xuất đường đi giữa các vị trí.
Ví dụ bên dưới cho thấy cách bạn có thể sử dụng lớp này để xem đường đi từ Quảng trường Thời đại đến Công viên Trung tâm, trước tiên dừng lại ở Trung tâm Lincoln, lập biểu đồ vị trí và đường đi trên bản đồ, rồi gửi bản đồ đó qua email.
// Get the directions. const directions = Maps.newDirectionFinder() .setOrigin('Times Square, New York, NY') .addWaypoint('Lincoln Center, New York, NY') .setDestination('Central Park, New York, NY') .setMode(Maps.DirectionFinder.Mode.DRIVING) .getDirections(); const route = directions.routes[0]; // Set up marker styles. let markerLetterCode = 'A'.charCodeAt(); // Add markers to the map. const map = Maps.newStaticMap(); for (let i = 0; i < route.legs.length; i++) { const leg = route.legs[i]; if (i === 0) { // Add a marker for the start location of the first leg only. map.setMarkerStyle( Maps.StaticMap.MarkerSize.MID, Maps.StaticMap.Color.GREEN, String.fromCharCode(markerLetterCode), ); map.addMarker(leg.start_location.lat, leg.start_location.lng); markerLetterCode++; } map.setMarkerStyle( Maps.StaticMap.MarkerSize.MID, Maps.StaticMap.Color.GREEN, String.fromCharCode(markerLetterCode), ); map.addMarker(leg.end_location.lat, leg.end_location.lng); markerLetterCode++; } // Add a path for the entire route. map.addPath(route.overview_polyline.points); // Send the map in an email. const toAddress = Session.getActiveUser().getEmail(); MailApp.sendEmail( toAddress, 'Directions', `Please open: ${map.getMapUrl()}&key=YOUR_API_KEY`, { htmlBody: 'See below.<br/><img src="cid:mapImage">', inlineImages: { mapImage: Utilities.newBlob(map.getMapImage(), 'image/png'), }, }, );
Xem thêm
Phương thức
Phương thức | Loại dữ liệu trả về | Mô tả ngắn |
---|---|---|
add | Direction | Thêm một điểm trung gian mà tuyến đường phải đi qua, bằng cách sử dụng một điểm (lat/lng). |
add | Direction | Thêm một điểm trung gian mà tuyến đường phải đi qua, bằng cách sử dụng địa chỉ. |
clear | Direction | Xoá tập hợp điểm trung gian hiện tại. |
get | Object | Lấy thông tin chỉ đường bằng cách sử dụng điểm xuất phát, điểm đến và các tuỳ chọn khác đã đặt. |
set | Direction | Đặt xem có trả về các tuyến đường thay thế hay không, thay vì chỉ trả về tuyến đường có thứ hạng cao nhất (mặc định là false). |
set | Direction | Đặt thời gian đến mong muốn (nếu có). |
set | Direction | Đặt xem có tránh một số loại hạn chế nhất định hay không. |
set | Direction | Đặt thời gian khởi hành mong muốn (nếu có). |
set | Direction | Đặt vị trí kết thúc để tính toán đường đi đến đó, bằng cách sử dụng một điểm (lat/lng). |
set | Direction | Đặt vị trí kết thúc để tính toán đường đi bằng địa chỉ. |
set | Direction | Đặt ngôn ngữ sẽ dùng cho chỉ đường. |
set | Direction | Đặt phương thức di chuyển (mặc định là lái xe). |
set | Direction | Đặt xem có tối ưu hoá tuyến đường đã cung cấp hay không bằng cách sắp xếp lại các điểm trung gian theo thứ tự hiệu quả hơn (mặc định là false). |
set | Direction | Đặt vị trí xuất phát để tính toán đường đi, bằng cách sử dụng một điểm (lat/lng). |
set | Direction | Đặt vị trí xuất phát để tính toán đường đi, bằng cách sử dụng địa chỉ. |
set | Direction | Đặt một khu vực để sử dụng khi diễn giải tên vị trí. |
Tài liệu chi tiết
add Waypoint(latitude, longitude)
Thêm một điểm trung gian mà tuyến đường phải đi qua, bằng cách sử dụng một điểm (lat/lng).
// Creates a DirectionFinder with a wapoint at Lincoln Center. const directionFinder = Maps.newDirectionFinder().addWaypoint( 40.772628, -73.984243, );
Tham số
Tên | Loại | Mô tả |
---|---|---|
latitude | Number | Vĩ độ của điểm trung gian. |
longitude | Number | Kinh độ của điểm trung gian. |
Cầu thủ trả bóng
Direction
– Đối tượng DirectionFinder để hỗ trợ việc tạo chuỗi lệnh gọi.
add Waypoint(address)
Thêm một điểm trung gian mà tuyến đường phải đi qua, bằng cách sử dụng địa chỉ.
// Creates a DirectionFinder with a wapoint at Lincoln Center. const directionFinder = Maps.newDirectionFinder().addWaypoint( 'Lincoln Center, New York, NY', );
Tham số
Tên | Loại | Mô tả |
---|---|---|
address | String | Địa chỉ. |
Cầu thủ trả bóng
Direction
– Đối tượng DirectionFinder để hỗ trợ việc tạo chuỗi lệnh gọi.
clear Waypoints()
Xoá tập hợp điểm trung gian hiện tại.
const directionFinder = Maps.newDirectionFinder(); // ... // Do something interesting here ... // ... // Remove all waypoints added with addWaypoint(). directionFinder.clearWaypoints();
Cầu thủ trả bóng
Direction
– đối tượng DirectionFinder để hỗ trợ việc tạo chuỗi lệnh gọi
get Directions()
Lấy thông tin chỉ đường bằng cách sử dụng điểm xuất phát, điểm đến và các tuỳ chọn khác đã đặt.
// Logs how long it would take to walk from Times Square to Central Park. const directions = Maps.newDirectionFinder() .setOrigin('Times Square, New York, NY') .setDestination('Central Park, New York, NY') .setMode(Maps.DirectionFinder.Mode.WALKING) .getDirections(); Logger.log(directions.routes[0].legs[0].duration.text);
Cầu thủ trả bóng
Object
– một đối tượng JSON chứa tập hợp các tuyến đường cho chỉ dẫn, như mô tả tại đây
Xem thêm
set Alternatives(useAlternatives)
Đặt xem có trả về các tuyến đường thay thế hay không, thay vì chỉ trả về tuyến đường có thứ hạng cao nhất (mặc định là false). Nếu đúng, mảng routes
của đối tượng thu được có thể chứa nhiều mục nhập.
// Creates a DirectionFinder with alternative routes enabled. const directionFinder = Maps.newDirectionFinder().setAlternatives(true);
Tham số
Tên | Loại | Mô tả |
---|---|---|
use | Boolean | true để trả về các tuyến đường thay thế, false nếu không |
Cầu thủ trả bóng
Direction
– đối tượng DirectionFinder để hỗ trợ việc tạo chuỗi lệnh gọi
set Arrive(time)
Đặt thời gian đến mong muốn (nếu có).
// Creates a DirectionFinder with an arrival time of 2 hours from now. const now = new Date(); const arrive = new Date(now.getTime() + 2 * 60 * 60 * 1000); const directionFinder = Maps.newDirectionFinder().setArrive(arrive);
Tham số
Tên | Loại | Mô tả |
---|---|---|
time | Date | thời gian đến |
Cầu thủ trả bóng
Direction
– đối tượng DirectionFinder để hỗ trợ việc tạo chuỗi lệnh gọi
Xem thêm
set Avoid(avoid)
Đặt xem có tránh một số loại hạn chế nhất định hay không.
// Creates a DirectionFinder that avoid highways. const directionFinder = Maps.newDirectionFinder().setAvoid( Maps.DirectionFinder.Avoid.HIGHWAYS, );
Tham số
Tên | Loại | Mô tả |
---|---|---|
avoid | String | một giá trị không đổi từ Avoid |
Cầu thủ trả bóng
Direction
– đối tượng DirectionFinder để hỗ trợ việc tạo chuỗi lệnh gọi
Xem thêm
set Depart(time)
Đặt thời gian khởi hành mong muốn (nếu có).
// Creates a DirectionFinder with a departure time of 1 hour from now. const now = new Date(); const depart = new Date(now.getTime() + 1 * 60 * 60 * 1000); const directionFinder = Maps.newDirectionFinder().setDepart(depart);
Tham số
Tên | Loại | Mô tả |
---|---|---|
time | Date | thời gian khởi hành |
Cầu thủ trả bóng
Direction
– Đối tượng DirectionFinder để hỗ trợ việc tạo chuỗi lệnh gọi.
Xem thêm
set Destination(latitude, longitude)
Đặt vị trí kết thúc để tính toán đường đi đến đó, bằng cách sử dụng một điểm (lat/lng).
// Creates a DirectionFinder with the destination set to Central Park. const directionFinder = Maps.newDirectionFinder().setDestination( 40.777052, -73.975464, );
Tham số
Tên | Loại | Mô tả |
---|---|---|
latitude | Number | vĩ độ của vị trí kết thúc |
longitude | Number | kinh độ của vị trí kết thúc |
Cầu thủ trả bóng
Direction
– đối tượng DirectionFinder để hỗ trợ việc tạo chuỗi lệnh gọi
set Destination(address)
Đặt vị trí kết thúc để tính toán đường đi bằng địa chỉ.
// Creates a DirectionFinder with the destination set to Central Park. const directionFinder = Maps.newDirectionFinder().setDestination( 'Central Park, New York, NY', );
Tham số
Tên | Loại | Mô tả |
---|---|---|
address | String | địa chỉ kết thúc |
Cầu thủ trả bóng
Direction
– đối tượng DirectionFinder để hỗ trợ việc tạo chuỗi lệnh gọi
set Language(language)
Đặt ngôn ngữ sẽ dùng cho chỉ đường.
// Creates a DirectionFinder with the language set to French. const directionFinder = Maps.newDirectionFinder().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
Direction
– đối tượng DirectionFinder để hỗ trợ việc tạo chuỗi lệnh gọi
Xem thêm
set Mode(mode)
Đặt phương thức di chuyển (mặc định là lái xe).
// Creates a DirectionFinder with the mode set to walking. const directionFinder = Maps.newDirectionFinder().setMode( Maps.DirectionFinder.Mode.WALKING, );
Tham số
Tên | Loại | Mô tả |
---|---|---|
mode | String | một giá trị không đổi từ Mode |
Cầu thủ trả bóng
Direction
– đối tượng DirectionFinder để hỗ trợ việc tạo chuỗi lệnh gọi
Xem thêm
set Optimize Waypoints(optimizeOrder)
Đặt xem có tối ưu hoá tuyến đường đã cung cấp hay không bằng cách sắp xếp lại các điểm trung gian theo thứ tự hiệu quả hơn (mặc định là false).
// Creates a DirectionFinder with wapoint optimization enabled. const directionFinder = Maps.newDirectionFinder().setOptimizeWaypoints(true);
Tham số
Tên | Loại | Mô tả |
---|---|---|
optimize | Boolean | true để tối ưu hoá đơn đặt hàng hoặc false nếu không |
Cầu thủ trả bóng
Direction
– đối tượng DirectionFinder để hỗ trợ việc tạo chuỗi lệnh gọi
Xem thêm
set Origin(latitude, longitude)
Đặt vị trí xuất phát để tính toán đường đi, sử dụng một điểm (lat/lng).
// Creates a DirectionFinder with the origin set to Times Square. const directionFinder = Maps.newDirectionFinder().setOrigin( 40.759011, -73.984472, );
Tham số
Tên | Loại | Mô tả |
---|---|---|
latitude | Number | vĩ độ của vị trí bắt đầu |
longitude | Number | kinh độ của vị trí bắt đầu |
Cầu thủ trả bóng
Direction
– đối tượng DirectionFinder để hỗ trợ việc tạo chuỗi lệnh gọi
set Origin(address)
Đặt vị trí xuất phát để tính toán đường đi, bằng cách sử dụng địa chỉ.
// Creates a DirectionFinder with the origin set to Times Square. const directionFinder = Maps.newDirectionFinder().setOrigin( 'Times Square, New York, NY', );
Tham số
Tên | Loại | Mô tả |
---|---|---|
address | String | địa chỉ bắt đầu |
Cầu thủ trả bóng
Direction
– thực thể DirectionFinder để tạo điều kiện cho việc tạo chuỗi lệnh gọi
set Region(region)
Đặt một khu vực để sử dụng khi diễn giải tên vị trí. Mã khu vực được hỗ trợ tương ứng với các ccTLD mà Google Maps hỗ trợ. Ví dụ: mã khu vực "uk" tương ứng với "maps.google.co.uk".
// Creates a DirectionFinder with the region set to France. const directionFinder = Maps.newDirectionFinder().setRegion('fr');
Tham số
Tên | Loại | Mô tả |
---|---|---|
region | String | mã vùng cần sử dụng |
Cầu thủ trả bóng
Direction
– đối tượng DirectionFinder để hỗ trợ việc tạo chuỗi lệnh gọi