Class DirectionFinder

DirectionFinder

Cho phép truy xuất thông tin chỉ đường giữa các vị trí.
Ví dụ dưới đây 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, xác định vị trí và lối đi trên bản đồ rồi gửi bản đồ trong email.

// Get the directions.
var 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();
var route = directions.routes[0];

// Set up marker styles.
var markerSize = Maps.StaticMap.MarkerSize.MID;
var markerColor = Maps.StaticMap.Color.GREEN
var markerLetterCode = 'A'.charCodeAt();

// Add markers to the map.
var map = Maps.newStaticMap();
for (var i = 0; i < route.legs.length; i++) {
  var leg = route.legs[i];
  if (i == 0) {
    // Add a marker for the start location of the first leg only.
    map.setMarkerStyle(markerSize, markerColor, String.fromCharCode(markerLetterCode));
    map.addMarker(leg.start_location.lat, leg.start_location.lng);
    markerLetterCode++;
  }
  map.setMarkerStyle(markerSize, markerColor, 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.
var 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

• API Chỉ đường của Google

Phương thức

Phương thức	Loại dữ liệu trả về	Mô tả ngắn
addWaypoint(latitude, longitude)	DirectionFinder	Thêm một điểm tham chiếu mà tuyến đường phải đi qua, sử dụng một điểm (vĩ độ/lng).
addWaypoint(address)	DirectionFinder	Thêm một điểm tham chiếu mà tuyến đường phải đi qua bằng cách sử dụng một địa chỉ.
clearWaypoints()	DirectionFinder	Xóa tập hợp điểm tham chiếu hiện tại.
getDirections()	Object	Xem đường đi bằng cách sử dụng điểm khởi hành, điểm đến và các tuỳ chọn khác đã được đặt.
setAlternatives(useAlternatives)	DirectionFinder	Đặt xem có trả về các tuyến đường thay thế hay không, thay vì chỉ trả về tuyến đường được xếp hạng cao nhất tuyến (mặc định là false).
setArrive(time)	DirectionFinder	Đặt thời gian đến mong muốn (nếu có).
setAvoid(avoid)	DirectionFinder	Đặt xem có tránh một số loại hạn chế nhất định hay không.
setDepart(time)	DirectionFinder	Đặt thời gian khởi hành mong muốn (nếu có).
setDestination(latitude, longitude)	DirectionFinder	Đặt vị trí cuối cùng để tính chỉ đường, sử dụng một điểm (vĩ độ/lng).
setDestination(address)	DirectionFinder	Đặt vị trí cuối cùng để tính chỉ đường đến, bằng cách sử dụng một địa chỉ.
setLanguage(language)	DirectionFinder	Đặt ngôn ngữ dùng cho chỉ đường.
setMode(mode)	DirectionFinder	Đặt chế độ đi lại (mặc định là lái xe).
setOptimizeWaypoints(optimizeOrder)	DirectionFinder	Đặ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 tham chiếu theo cách đơn đặt hàng có hiệu quả (mặc định là false).
setOrigin(latitude, longitude)	DirectionFinder	Đặt vị trí bắt đầu mà từ đó để tính chỉ đường, sử dụng một điểm (vĩ độ/lng).
setOrigin(address)	DirectionFinder	Đặt vị trí bắt đầu mà từ đó dùng để tính chỉ đường, bằng địa chỉ.
setRegion(region)	DirectionFinder	Đặ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

addWaypoint(latitude, longitude)

Thêm một điểm tham chiếu mà tuyến đường phải đi qua, sử dụng một điểm (vĩ độ/lng).

// Creates a DirectionFinder with a wapoint at Lincoln Center.
var directionFinder = Maps.newDirectionFinder().addWaypoint(40.772628, -73.984243);

Tham số

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

Cầu thủ trả bóng

DirectionFinder – Đối tượng DirectionFinder hỗ trợ tạo chuỗi lệnh gọi.

---

addWaypoint(address)

Thêm một điểm tham chiếu mà tuyến đường phải đi qua bằng cách sử dụng một địa chỉ.

// Creates a DirectionFinder with a wapoint at Lincoln Center.
var 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

DirectionFinder – Đối tượng DirectionFinder hỗ trợ tạo chuỗi lệnh gọi.

---

clearWaypoints()

Xóa tập hợp điểm tham chiếu hiện tại.

var directionFinder = Maps.newDirectionFinder()
// ...
// Do something interesting here ...
// ...
// Remove all waypoints added with addWaypoint().
directionFinder.clearWaypoints();

Cầu thủ trả bóng

DirectionFinder – đối tượng DirectionFinder để hỗ trợ tạo chuỗi lệnh gọi

---

getDirections()

Xem đường đi bằng cách sử dụng điểm khởi hành, điểm đến và các tuỳ chọn khác đã được đặt.

// Logs how long it would take to walk from Times Square to Central Park.
var 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 chỉ đường, như được mô tả tại đây

Xem thêm

• API Chỉ đường của Google

---

setAlternatives(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 xếp hạng cao nhất tuyến (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 alernative routes enabled.
var directionFinder = Maps.newDirectionFinder().setAlternatives(true);

Tham số

Tên	Loại	Mô tả
useAlternatives	Boolean	true để trả về các tuyến thay thế, nếu không thì trả về false

Cầu thủ trả bóng

DirectionFinder – đối tượng DirectionFinder để hỗ trợ tạo chuỗi lệnh gọi

---

setArrive(time)

Đặt thời gian đến mong muốn (nếu có).

// Creates a DirectionFinder with an arrival time of 2 hours from now.
var now = new Date();
var arrive = new Date(now.getTime() + (2 * 60 * 60 * 1000));
var 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

DirectionFinder – đối tượng DirectionFinder để hỗ trợ tạo chuỗi lệnh gọi

Xem thêm

• API Chỉ đường của Google

---

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

DirectionFinder – đối tượng DirectionFinder để hỗ trợ tạo chuỗi lệnh gọi

Xem thêm

• API Chỉ đường của Google

---

setDepart(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.
var now = new Date();
var depart = new Date(now.getTime() + (1 * 60 * 60 * 1000));
var 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

DirectionFinder – Đối tượng DirectionFinder hỗ trợ tạo chuỗi lệnh gọi.

Xem thêm

• API Chỉ đường của Google

---

setDestination(latitude, longitude)

Đặt vị trí cuối cùng để tính chỉ đường, sử dụng một điểm (vĩ độ/lng).

// Creates a DirectionFinder with the destination set to Central Park.
var 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

DirectionFinder – đối tượng DirectionFinder để hỗ trợ tạo chuỗi lệnh gọi

---

setDestination(address)

Đặt vị trí cuối cùng để tính chỉ đường đến, bằng cách sử dụng một địa chỉ.

// Creates a DirectionFinder with the destination set to Central Park.
var directionFinder = Maps.newDirectionFinder().setDestination('Central Park, New York, NY');

Tham số

Tên	Loại	Mô tả
address	String	địa chỉ cuối

Cầu thủ trả bóng

DirectionFinder – đối tượng DirectionFinder để hỗ trợ tạo chuỗi lệnh gọi

---

setLanguage(language)

Đặt ngôn ngữ dùng cho chỉ đường.

// Creates a DirectionFinder with the language set to French.
var 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

DirectionFinder – đối tượng DirectionFinder để hỗ trợ tạo chuỗi lệnh gọi

Xem thêm

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

---

setMode(mode)

Đặt chế độ đi lại (mặc định là lái xe).

// Creates a DirectionFinder with the mode set to walking.
var 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

DirectionFinder – đối tượng DirectionFinder để hỗ trợ tạo chuỗi lệnh gọi

Xem thêm

• API Chỉ đường của Google

---

setOptimizeWaypoints(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 tham chiếu theo cách đơn đặt hàng có hiệu quả (mặc định là false).

// Creates a DirectionFinder with wapoint optimization enabled.
var directionFinder = Maps.newDirectionFinder().setOptimizeWaypoints(true);

Tham số

Tên	Loại	Mô tả
optimizeOrder	Boolean	true để tối ưu hoá đơn đặt hàng hoặc false nếu không muốn tối ưu hoá đơn đặt hàng

Cầu thủ trả bóng

DirectionFinder – đối tượng DirectionFinder để hỗ trợ tạo chuỗi lệnh gọi

Xem thêm

• API Chỉ đường của Google

---

setOrigin(latitude, longitude)

Đặt vị trí bắt đầu mà từ đó để tính chỉ đường, sử dụng một điểm (vĩ độ/lng).

// Creates a DirectionFinder with the origin set to Times Square.
var 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

DirectionFinder – đối tượng DirectionFinder để hỗ trợ tạo chuỗi lệnh gọi

---

setOrigin(address)

Đặt vị trí bắt đầu mà từ đó dùng để tính chỉ đường, bằng địa chỉ.

// Creates a DirectionFinder with the origin set to Times Square.
var directionFinder = Maps.newDirectionFinder().setOrigin('Times Square, New York, NY');

Tham số

Tên	Loại	Mô tả
address	String	địa chỉ xuất phát

Cầu thủ trả bóng

DirectionFinder – thực thể DirectionFinder để hỗ trợ tạo chuỗi lệnh gọi

---

setRegion(region)

Đặt một khu vực để sử dụng khi diễn giải tên vị trí. Các mã vùng được hỗ trợ tương ứng với các ccTLD (miền cấp cao nhất theo mã quốc gia) mà Google Maps hỗ trợ. Ví dụ: mã vùng "uk" tương ứng với "maps.google.co.uk".

// Creates a DirectionFinder with the region set to France.
var directionFinder = Maps.newDirectionFinder().setRegion('fr');

Tham số

Tên	Loại	Mô tả
region	String	mã vùng để sử dụng

Cầu thủ trả bóng

DirectionFinder – đối tượng DirectionFinder để hỗ trợ tạo chuỗi lệnh gọi

Xem thêm

• API Chỉ đường của Google