Directions

Lớp DirectionsService

Lớp google.maps.DirectionsService

Một dịch vụ để tính toán đường đi giữa hai hoặc nhiều địa điểm.

Truy cập bằng cách gọi const {DirectionsService} = await google.maps.importLibrary("routes").
Xem Thư viện trong Maps JavaScript API.
DirectionsService
DirectionsService()
Tham số:  Không có
Tạo một phiên bản mới của DirectionsService để gửi các truy vấn chỉ đường đến máy chủ của Google.
route
route(request[, callback])
Tham số: 
Giá trị trả về:  Promise<DirectionsResult>
Đưa ra yêu cầu tìm đường.

Giao diện DirectionsRequest

google.maps.DirectionsRequestgiao diện

Một cụm từ tìm kiếm chỉ đường sẽ được gửi đến DirectionsService.
destination
Loại:  string|LatLng|Place|LatLngLiteral
Vị trí của điểm đến. Bạn có thể chỉ định tham số này dưới dạng một chuỗi cần được mã hoá địa lý, hoặc một LatLng, hoặc một Place. Bắt buộc.
origin
Loại:  string|LatLng|Place|LatLngLiteral
Vị trí xuất xứ. Bạn có thể chỉ định tham số này dưới dạng một chuỗi cần được mã hoá địa lý, hoặc một LatLng, hoặc một Place. Bắt buộc.
travelMode
Loại:  TravelMode
Loại định tuyến được yêu cầu. Bắt buộc.
avoidFerries optional
Loại:  boolean optional
Nếu true, hướng dẫn dịch vụ Chỉ đường tránh phà khi có thể. Không bắt buộc.
avoidHighways optional
Loại:  boolean optional
Nếu true, hãy hướng dẫn dịch vụ Chỉ đường tránh đường cao tốc nếu có thể. Không bắt buộc.
avoidTolls optional
Loại:  boolean optional
Nếu true, hãy hướng dẫn dịch vụ Đường đi tránh đường thu phí khi có thể. Không bắt buộc.
drivingOptions optional
Loại:  DrivingOptions optional
Các chế độ cài đặt chỉ áp dụng cho những yêu cầu có travelMode là DRIVING. Đối tượng này sẽ không ảnh hưởng đến các phương thức di chuyển khác.
language optional
Loại:  string optional
Giá trị nhận dạng ngôn ngữ cho ngôn ngữ mà kết quả sẽ được trả về (nếu có thể). Xem danh sách ngôn ngữ được hỗ trợ.
optimizeWaypoints optional
Loại:  boolean optional
Nếu được đặt thành true, thì DirectionsService sẽ cố gắng sắp xếp lại các điểm tham chiếu trung gian được cung cấp để giảm thiểu tổng chi phí của tuyến đường. Nếu các điểm tham chiếu được tối ưu hoá, hãy kiểm tra DirectionsRoute.waypoint_order trong phản hồi để xác định thứ tự mới.
provideRouteAlternatives optional
Loại:  boolean optional
Có nên cung cấp các tuyến đường thay thế hay không. Không bắt buộc.
region optional
Loại:  string optional
Mã khu vực được dùng làm hệ số thiên vị cho các yêu cầu mã hoá địa lý. Mã khu vực chấp nhận giá trị gồm 2 ký tự ccTLD ("miền cấp cao nhất"). Hầu hết mã ccTLD đều giống với mã ISO 3166-1, ngoại trừ một số trường hợp đáng chú ý. Ví dụ: ccTLD của Vương quốc Anh là "uk" (.co.uk) trong khi mã ISO 3166-1 của quốc gia này là "gb" (về mặt kỹ thuật là cho thực thể "Vương quốc Anh và Bắc Ireland").
transitOptions optional
Loại:  TransitOptions optional
Các chế độ cài đặt chỉ áp dụng cho những yêu cầu có travelMode là TRANSIT. Đối tượng này sẽ không ảnh hưởng đến các phương thức di chuyển khác.
unitSystem optional
Loại:  UnitSystem optional
Mặc định: Hệ thống đơn vị được sử dụng ở quốc gia xuất xứ.
Hệ đơn vị ưu tiên dùng khi hiển thị khoảng cách.
waypoints optional
Loại:  Array<DirectionsWaypoint> optional
Mảng gồm các điểm tham chiếu trung gian. Đường đi được tính từ điểm bắt đầu đến điểm đến thông qua từng điểm tham chiếu trong mảng này. Hãy xem hướng dẫn dành cho nhà phát triển để biết số lượng điểm đánh dấu tối đa được phép. Không hỗ trợ điểm trung gian cho chỉ đường bằng phương tiện công cộng. Không bắt buộc.

Hằng số DirectionsStatus

Hằng số google.maps.DirectionsStatus

Trạng thái do DirectionsService trả về khi hoàn tất lệnh gọi đến route(). Chỉ định các giá trị này theo giá trị hoặc bằng cách sử dụng tên của hằng số. Ví dụ: 'OK' hoặc google.maps.DirectionsStatus.OK.

Truy cập bằng cách gọi const {DirectionsStatus} = await google.maps.importLibrary("routes").
Xem Thư viện trong Maps JavaScript API.
INVALID_REQUEST DirectionsRequest bạn cung cấp không hợp lệ.
MAX_WAYPOINTS_EXCEEDED Bạn đã cung cấp quá nhiều DirectionsWaypoint trong DirectionsRequest. Hãy xem hướng dẫn dành cho nhà phát triển để biết số lượng điểm đánh dấu tối đa được phép.
NOT_FOUND Không thể mã hoá địa lý ít nhất một trong các điểm xuất phát, điểm đến hoặc điểm tham chiếu.
OK Phản hồi chứa một DirectionsResult hợp lệ.
OVER_QUERY_LIMIT Trang web đã vượt quá giới hạn yêu cầu trong một khoảng thời gian quá ngắn.
REQUEST_DENIED Trang web không được phép sử dụng dịch vụ chỉ đường.
UNKNOWN_ERROR Không xử lý được yêu cầu chỉ đường do lỗi máy chủ. Yêu cầu có thể thành công nếu bạn thử lại.
ZERO_RESULTS Không tìm thấy tuyến đường nào giữa điểm khởi hành và điểm đến.

Giao diện DirectionsResult

google.maps.DirectionsResultgiao diện

Phản hồi chỉ đường được truy xuất từ máy chủ chỉ đường. Bạn có thể kết xuất các đối tượng này bằng cách sử dụng DirectionsRenderer hoặc phân tích cú pháp đối tượng này và tự kết xuất. Bạn phải hiển thị cảnh báo và bản quyền như được nêu trong Điều khoản dịch vụ của Nền tảng Google Maps. Xin lưu ý rằng mặc dù kết quả này có "dạng JSON", nhưng không phải là JSON theo đúng nghĩa, vì kết quả này gián tiếp bao gồm các đối tượng LatLng.
request
DirectionsRequest đã tạo ra kết quả này.
routes
Một mảng gồm các DirectionsRoute, mỗi DirectionsRoute chứa thông tin về các đoạn đường và bước mà đoạn đường đó bao gồm. Chỉ có một tuyến đường, trừ phi DirectionsRequest được tạo khi provideRouteAlternatives được đặt thành true.
available_travel_modes optional
Loại:  Array<TravelMode> optional
Chứa một mảng các phương thức di chuyển có sẵn. Trường này được trả về khi một yêu cầu chỉ định chế độ di chuyển và không nhận được kết quả. Mảng này chứa các chế độ di chuyển có sẵn ở các quốc gia trong nhóm điểm tham chiếu đã cho. Trường này sẽ không được trả về nếu một hoặc nhiều điểm đánh dấu là "điểm đánh dấu trung gian".
geocoded_waypoints optional
Loại:  Array<DirectionsGeocodedWaypoint> optional
Một mảng gồm các DirectionsGeocodedWaypoint, mỗi DirectionsGeocodedWaypoint chứa thông tin về hoạt động mã hoá địa lý của điểm xuất phát, điểm đến và điểm tham chiếu.

Lớp DirectionsRenderer

Lớp google.maps.DirectionsRenderer

Kết xuất chỉ đường lấy được từ DirectionsService.

Lớp này mở rộng MVCObject.

Truy cập bằng cách gọi const {DirectionsRenderer} = await google.maps.importLibrary("routes").
Xem Thư viện trong Maps JavaScript API.
DirectionsRenderer
DirectionsRenderer([opts])
Tham số: 
Tạo trình kết xuất bằng các lựa chọn đã cho. Đường đi có thể được hiển thị trên bản đồ (dưới dạng lớp phủ trực quan) hoặc trên bảng điều khiển <div> (dưới dạng hướng dẫn bằng văn bản).
getDirections
getDirections()
Tham số:  Không có
Giá trị trả về:  DirectionsResult
Trả về nhóm chỉ dẫn hiện tại của trình kết xuất.
getMap
getMap()
Tham số:  Không có
Giá trị trả về:  Map
Trả về bản đồ mà DirectionsResult được kết xuất.
getPanel
getPanel()
Tham số:  Không có
Giá trị trả về:  HTMLElement|null
Trả về bảng điều khiển <div> mà DirectionsResult được kết xuất.
getRouteIndex
getRouteIndex()
Tham số:  Không có
Giá trị trả về:  number
Trả về chỉ mục tuyến đường hiện tại (dựa trên 0) mà đối tượng DirectionsRenderer này đang sử dụng.
setDirections
setDirections(directions)
Tham số: 
Giá trị trả về:  Không có
Đặt trình kết xuất để sử dụng kết quả từ DirectionsService. Việc đặt một bộ chỉ dẫn hợp lệ theo cách này sẽ hiển thị chỉ dẫn trên bản đồ và bảng điều khiển được chỉ định của trình kết xuất.
setMap
setMap(map)
Tham số: 
Giá trị trả về:  Không có
Phương thức này chỉ định bản đồ mà chỉ đường sẽ được hiển thị. Truyền null để xoá chỉ đường khỏi bản đồ.
setOptions
setOptions(options)
Tham số: 
Giá trị trả về:  Không có
Thay đổi chế độ cài đặt lựa chọn của DirectionsRenderer này sau khi khởi tạo.
setPanel
setPanel(panel)
Tham số: 
Giá trị trả về:  Không có
Phương thức này hiển thị đường đi trong một <div>. Truyền null để xoá nội dung khỏi bảng điều khiển.
setRouteIndex
setRouteIndex(routeIndex)
Tham số: 
  • routeIndex:  number
Giá trị trả về:  Không có
Đặt chỉ mục (bắt đầu từ 0) của tuyến đường trong đối tượng DirectionsResult để hiển thị. Theo mặc định, tuyến đường đầu tiên trong mảng sẽ được hiển thị.
Kế thừa: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
directions_changed
function()
Đối số:  Không có
Sự kiện này được kích hoạt khi chỉ dẫn được kết xuất thay đổi, khi một DirectionsResult mới được đặt hoặc khi người dùng hoàn tất việc kéo một thay đổi vào đường dẫn chỉ dẫn.

Giao diện