Trang này được dịch bởi Cloud Translation API.

Class 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