Class DirectionFinder

Trình tìm hướng

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ứcLoại dữ liệu trả vềMô tả ngắn
addWaypoint(latitude, longitude)DirectionFinderThê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).
addWaypoint(address)DirectionFinderThêm một điểm trung gian mà tuyến đường phải đi qua, bằng cách sử dụng địa chỉ.
clearWaypoints()DirectionFinderXoá tập hợp điểm trung gian hiện tại.
getDirections()ObjectLấ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.
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ó thứ hạng cao nhất (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í kết thúc để tính toán đường đi đến đó, bằng cách sử dụng một điểm (lat/lng).
setDestination(address)DirectionFinderĐặt vị trí kết thúc để tính toán đường đi bằng địa chỉ.
setLanguage(language)DirectionFinderĐặt ngôn ngữ sẽ dùng cho chỉ đường.
setMode(mode)DirectionFinderĐặt phương thức di chuyển (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 trung gian theo thứ tự hiệu quả hơn (mặc định là false).
setOrigin(latitude, longitude)DirectionFinderĐặ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).
setOrigin(address)DirectionFinderĐặt vị trí xuất phát để tính toán đường đi, bằng cách sử dụ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 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ênLoạiMô tả
latitudeNumberVĩ độ của điểm trung gian.
longitudeNumberKinh độ của điểm trung gian.

Cầu thủ trả bóng

DirectionFinder – Đối tượng DirectionFinder để tạo điều kiện cho việc tạo chuỗi lệnh gọi.

addWaypoint(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ênLoạiMô tả
addressStringĐịa chỉ.

Cầu thủ trả bóng

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

clearWaypoints()

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

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

getDirections()

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

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ó 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ênLoạiMô tả
useAlternativesBooleantrue để trả về các tuyến đường thay thế, false nếu không

Cầu thủ trả bóng

DirectionFinder – đối tượng DirectionFinder để hỗ trợ việc 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.
const now = new Date();
const arrive = new Date(now.getTime() + 2 * 60 * 60 * 1000);
const directionFinder = Maps.newDirectionFinder().setArrive(arrive);

Tham số

TênLoạiMô tả
timeDatethời gian đến

Cầu thủ trả bóng

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

Xem thêm

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.
const directionFinder = Maps.newDirectionFinder().setAvoid(
    Maps.DirectionFinder.Avoid.HIGHWAYS,
);

Tham số

TênLoạiMô tả
avoidStringmột giá trị không đổi từ Avoid

Cầu thủ trả bóng

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

Xem thêm

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

Tham số

TênLoạiMô tả
timeDatethời gian khởi hành

Cầu thủ trả bóng

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

Xem thêm

setDestination(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ênLoạiMô tả
latitudeNumbervĩ độ của vị trí kết thúc
longitudeNumberkinh độ của vị trí kết thúc

Cầu thủ trả bóng

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

setDestination(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ênLoạiMô tả
addressStringđịa chỉ kết thúc

Cầu thủ trả bóng

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

setLanguage(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ênLoạiMô tả
languageStringgiá trị nhận dạng ngôn ngữ BCP-47

Cầu thủ trả bóng

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

Xem thêm

setMode(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ênLoạiMô tả
modeStringmột giá trị không đổi từ Mode

Cầu thủ trả bóng

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

Xem thêm

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 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ênLoạiMô tả
optimizeOrderBooleantrue để tối ưu hoá đơn đặt hàng hoặc false nếu không

Cầu thủ trả bóng

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

Xem thêm

setOrigin(latitude, longitude)

Đặ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). 

// Creates a DirectionFinder with the origin set to Times Square.
const directionFinder = Maps.newDirectionFinder().setOrigin(
    40.759011,
    -73.984472,
);

Tham số

TênLoạiMô tả
latitudeNumbervĩ độ của vị trí bắt đầu
longitudeNumberkinh độ của vị trí bắt đầu

Cầu thủ trả bóng

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

setOrigin(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ênLoạiMô tả
addressStringđịa chỉ bắt đầu

Cầu thủ trả bóng

DirectionFinder – thực thể DirectionFinder để tạo điều kiện cho việc 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í. 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ênLoạiMô tả
regionStringmã vùng cần sử dụng

Cầu thủ trả bóng

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

Xem thêm