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 DirectionsRendererOptions

google.maps.DirectionsRendererOptionsgiao diện

Đối tượng này xác định các thuộc tính có thể được đặt trên một đối tượng DirectionsRenderer.
directions optional
Loại:  DirectionsResult optional
Đường đi để hiển thị trên bản đồ và/hoặc trong bảng <div>, được truy xuất dưới dạng đối tượng DirectionsResult từ DirectionsService.
draggable optional
Loại:  boolean optional
Nếu true, cho phép người dùng kéo và sửa đổi đường dẫn của các tuyến đường do DirectionsRenderer này kết xuất.
hideRouteList optional
Loại:  boolean optional
Mặc định: false
Thuộc tính này cho biết liệu trình kết xuất có cung cấp danh sách các tuyến đường mà người dùng có thể chọn trong bảng điều hướng hay không.
infoWindow optional
Loại:  InfoWindow optional
InfoWindow để hiển thị thông tin văn bản khi người dùng nhấp vào một điểm đánh dấu. Nội dung hiện có trong cửa sổ thông tin sẽ bị ghi đè và vị trí của cửa sổ này sẽ được di chuyển. Nếu bạn không chỉ định cửa sổ thông tin, DirectionsRenderer sẽ tạo và sử dụng cửa sổ thông tin riêng. Thuộc tính này sẽ bị bỏ qua nếu bạn đặt suppressInfoWindows thành true.
map optional
Loại:  Map optional
Bản đồ để hiển thị đường đi.
markerOptions optional
Loại:  MarkerOptions optional
Các lựa chọn cho điểm đánh dấu. Tất cả các điểm đánh dấu do DirectionsRenderer hiển thị sẽ sử dụng các lựa chọn này.
panel optional
Loại:  HTMLElement optional
<div> để hiển thị các bước chỉ đường.
polylineOptions optional
Loại:  PolylineOptions optional
Các lựa chọn cho đường nhiều đoạn. Tất cả các đường nhiều đoạn do DirectionsRenderer kết xuất sẽ sử dụng các lựa chọn này.
preserveViewport optional
Loại:  boolean optional
Mặc định: false
Nếu bạn đặt lựa chọn này thành true hoặc chưa bao giờ đặt tâm và mức thu phóng của bản đồ, thì bản đồ đầu vào sẽ được đặt ở giữa và thu phóng theo hộp giới hạn của tập hợp chỉ đường này.
routeIndex optional
Loại:  number optional
Chỉ mục của tuyến đường trong đối tượng DirectionsResult. Giá trị mặc định là "0".
suppressBicyclingLayer optional
Loại:  boolean optional
Ngăn chặn việc kết xuất BicyclingLayer khi có yêu cầu chỉ đường cho xe đạp.
suppressInfoWindows optional
Loại:  boolean optional
Ngăn việc hiển thị cửa sổ thông tin.
suppressMarkers optional
Loại:  boolean optional
Ngăn chặn việc hiển thị các điểm đánh dấu.
suppressPolylines optional
Loại:  boolean optional
Ngăn kết xuất nhiều đường.

Giao diện DirectionsWaypoint

google.maps.DirectionsWaypointgiao diện

DirectionsWaypoint đại diện cho một vị trí giữa điểm khởi hành và điểm đến mà chuyến đi phải đi qua.
location optional
Loại:  string|LatLng|LatLngLiteral|Place optional
Vị trí điểm tham chiếu. Có thể là một chuỗi địa chỉ, LatLng hoặc Place. Không bắt buộc.
stopover optional
Loại:  boolean optional
Mặc định: true
Nếu true, thì tức là điểm đánh dấu này là một điểm dừng giữa điểm khởi hành và điểm đến. Điều này có tác dụng chia tuyến đường thành 2 chặng. Nếu false, cho biết tuyến đường nên được điều chỉnh để đi qua điểm tham chiếu này, nhưng không được chia thành 2 chặng. Điều này rất hữu ích nếu bạn muốn tạo một tuyến đường để phản hồi thao tác kéo điểm tham chiếu của người dùng trên bản đồ.

Giao diện DirectionsGeocodedWaypoint

google.maps.DirectionsGeocodedWaypointgiao diện

Một điểm tham chiếu duy nhất được mã hoá địa lý.
partial_match optional
Loại:  boolean optional
Cho dù trình mã hoá địa lý không trả về kết quả khớp chính xác cho điểm tham chiếu ban đầu, nhưng vẫn có thể khớp một phần của địa chỉ được yêu cầu.
place_id optional
Loại:  string optional
Mã địa điểm được liên kết với điểm đánh dấu. Mã địa điểm giúp xác định riêng một địa điểm trong cơ sở dữ liệu của Google Địa điểm và trên Google Maps. Tìm hiểu thêm về Mã địa điểm trong hướng dẫn dành cho nhà phát triển Places API.
types optional
Loại:  Array<string> optional
Một mảng gồm các chuỗi biểu thị loại phần tử được trả về đã được mã hoá địa lý. Để biết danh sách các chuỗi có thể có, hãy tham khảo phần Các loại thành phần địa chỉ trong Hướng dẫn dành cho nhà phát triển.

Giao diện DirectionsRoute

google.maps.DirectionsRoutegiao diện

Một tuyến đường duy nhất chứa một nhóm chặng trong DirectionsResult. Xin lưu ý rằng mặc dù đối tượng này có "dạng JSON", nhưng không phải là JSON theo đúng nghĩa, vì đối tượng này bao gồm trực tiếp và gián tiếp các đối tượng LatLng.
bounds
Loại:  LatLngBounds
Ranh giới của tuyến đường này.
copyrights
Loại:  string
Văn bản bản quyền sẽ xuất hiện cho tuyến đường này.
legs
Loại:  Array<DirectionsLeg>
Một mảng gồm các DirectionsLeg, mỗi DirectionsLeg chứa thông tin về các bước mà mảng đó bao gồm. Mỗi điểm dừng chân hoặc đích đến được chỉ định sẽ có một chặng. Vì vậy, một tuyến đường không có điểm dừng chân sẽ chứa một DirectionsLeg và một tuyến đường có một điểm dừng chân sẽ chứa hai điểm.
overview_path
Loại:  Array<LatLng>
Một mảng gồm các LatLng đại diện cho toàn bộ khoá học của tuyến đường này. Đường dẫn này được đơn giản hoá để phù hợp trong những ngữ cảnh cần một số ít đỉnh (chẳng hạn như URL của Static Maps API).
overview_polyline
Loại:  string
Biểu thị bằng chuỗi nhiều đường được mã hoá của tuyến đường trong overview_path. Đường nhiều đường này là đường dẫn gần đúng (được làm mịn) của chỉ đường thu được.
summary
Loại:  string
Chứa nội dung mô tả ngắn bằng văn bản cho tuyến đường, phù hợp để đặt tên và phân biệt tuyến đường với các tuyến đường thay thế.
warnings
Loại:  Array<string>
Cảnh báo sẽ xuất hiện khi chỉ đường.
waypoint_order
Loại:  Array<number>
Nếu optimizeWaypoints được đặt thành true, trường này sẽ chứa hoán vị được sắp xếp lại của các điểm tham chiếu đầu vào. Ví dụ: nếu đầu vào là:
  Điểm xuất phát: Los Angeles
  Điểm dừng chân: Dallas, Bangor, Phoenix
  Điểm đến: New York
và đầu ra được tối ưu hoá được sắp xếp như sau:
  Điểm xuất phát: Los Angeles
  Điểm dừng chân: Phoenix, Dallas, Bangor
  Điểm đến: New York
thì trường này sẽ là một Array chứa các giá trị [2, 0, 1]. Xin lưu ý rằng các điểm đánh dấu được đánh số từ 0.
Nếu bất kỳ điểm tham chiếu đầu vào nào có stopover được đặt thành false, thì trường này sẽ trống vì tính năng tối ưu hoá tuyến đường không dùng được cho những truy vấn như vậy.
fare optional
Loại:  TransitFare optional
Tổng giá vé cho toàn bộ chuyến đi bằng phương tiện công cộng. Chỉ áp dụng cho các yêu cầu về phương tiện công cộng.

Giao diện DirectionsLeg

google.maps.DirectionsLeggiao diện

Một chặng bao gồm một nhóm các bước trong một DirectionsResult. Một số trường trong chặng có thể không được trả về cho tất cả các yêu cầu. 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 bao gồm trực tiếp và gián tiếp các đối tượng LatLng.
end_address
Loại:  string
Địa chỉ của điểm đến trong chặng này. Bạn nên đọc nội dung này như hiện trạng. Đừng phân tích cú pháp địa chỉ được định dạng theo cách lập trình.
end_location
Loại:  LatLng
DirectionsService tính toán đường đi giữa các vị trí bằng cách sử dụng phương tiện di chuyển gần nhất (thường là đường bộ) tại vị trí bắt đầu và kết thúc. end_location cho biết đích đến thực tế đã được mã hoá địa lý, có thể khác với end_location của bước cuối cùng nếu, chẳng hạn như, đường không gần với đích đến của chặng này.
start_address
Loại:  string
Địa chỉ của điểm khởi hành của chặng bay này. Bạn nên đọc nội dung này như hiện trạng. Đừng phân tích cú pháp địa chỉ được định dạng theo cách lập trình.
start_location
Loại:  LatLng
DirectionsService tính toán đường đi giữa các vị trí bằng cách sử dụng phương tiện di chuyển gần nhất (thường là đường bộ) tại vị trí bắt đầu và kết thúc. start_location cho biết vị trí thực tế được mã hoá địa lý, có thể khác với start_location của bước đầu tiên nếu, chẳng hạn như đường không gần với điểm bắt đầu của chặng này.
steps
Một mảng gồm các DirectionsStep, mỗi DirectionsStep chứa thông tin về từng bước riêng lẻ trong chặng này.
traffic_speed_entry
Loại:  Array<*>
Thông tin về tốc độ giao thông dọc theo chặng đường.
via_waypoints
Loại:  Array<LatLng>
Một mảng các điểm tham chiếu không phải là điểm dừng chân dọc theo chặng này, được chỉ định trong yêu cầu ban đầu.

Không dùng nữa trong các tuyến đường thay thế. Phiên bản 3.27 sẽ là phiên bản cuối cùng của API bổ sung via_waypoints trong các tuyến đường thay thế.

Khi sử dụng Dịch vụ chỉ đường để triển khai chỉ đường có thể kéo, bạn nên tắt tính năng kéo các tuyến đường thay thế. Chỉ tuyến đường chính mới có thể kéo được. Người dùng có thể kéo tuyến đường chính cho đến khi tuyến đường đó khớp với một tuyến đường thay thế.
arrival_time optional
Loại:  Time optional
Thời gian đến ước tính cho chặng này. Chỉ áp dụng cho các yêu cầu TRANSIT.
departure_time optional
Loại:  Time optional
Thời gian khởi hành ước tính cho chặng này. Chỉ áp dụng cho các yêu cầu TRANSIT.
distance optional
Loại:  Distance optional
Tổng quãng đường mà chặng này đi được. Thuộc tính này có thể không được xác định vì khoảng cách có thể không xác định.
duration optional
Loại:  Duration optional
Tổng thời lượng của chặng này. Thuộc tính này có thể là undefined vì bạn có thể không biết thời lượng.
duration_in_traffic optional
Loại:  Duration optional
Tổng thời lượng của chặng này, có tính đến tình trạng giao thông được chỉ ra bằng thuộc tính trafficModel. Thuộc tính này có thể là undefined vì bạn có thể không biết thời lượng.

Giao diện DirectionsStep

google.maps.DirectionsStepgiao diện

Một DirectionsStep duy nhất trong DirectionsResult. Một số trường có thể là undefined. Xin lưu ý rằng mặc dù đối tượng này có "dạng JSON", nhưng không phải là JSON theo đúng nghĩa, vì đối tượng này trực tiếp bao gồm các đối tượng LatLng.
encoded_lat_lngs
Loại:  string
Một biểu thị hình nhiều đường được mã hoá của bước. Đây là đường dẫn gần đúng (được làm mượt) của bước.
end_location
Loại:  LatLng
Vị trí kết thúc của bước này.
end_point
Loại:  LatLng
Vị trí kết thúc của bước này.
instructions
Loại:  string
Hướng dẫn cho bước này.
lat_lngs
Loại:  Array<LatLng>
Một chuỗi LatLng mô tả diễn biến của bước này. Đây là đường dẫn gần đúng (được làm mượt) của bước.
maneuver
Loại:  string
Chứa hành động cần thực hiện cho bước hiện tại (turn-left, merge, straight, v.v.). Các giá trị có thể thay đổi và các giá trị mới có thể được giới thiệu mà không cần thông báo trước.
path
Loại:  Array<LatLng>
Một chuỗi LatLng mô tả diễn biến của bước này. Đây là đường dẫn gần đúng (được làm mượt) của bước.
start_location
Loại:  LatLng
Vị trí bắt đầu của bước này.
start_point
Loại:  LatLng
Vị trí bắt đầu của bước này.
travel_mode
Loại:  TravelMode
Phương thức di chuyển được dùng trong bước này.
distance optional
Loại:  Distance optional
Quãng đường của bước này. Thuộc tính này có thể là undefined vì khoảng cách có thể không xác định.
duration optional
Loại:  Duration optional
Thời gian cần thiết để thực hiện bước này (tính bằng giây và ở dạng văn bản). Thuộc tính này có thể là undefined vì bạn có thể không biết thời lượng.
polyline optional
Loại:  DirectionsPolyline optional
Chứa một đối tượng có một thuộc tính duy nhất là "points", chứa một biểu thị đường nhiều đường được mã hoá của bước. Đường nhiều đoạn này là đường dẫn gần đúng (được làm mịn) của bước.
steps optional
Loại:  Array<DirectionsStep> optional
Các bước phụ của bước này. Được chỉ định cho các đoạn đường không phải là đường dành cho phương tiện công cộng của tuyến đường dành cho phương tiện công cộng.
transit optional
Loại:  TransitDetails optional
Thông tin chi tiết về bước này dành riêng cho phương tiện công cộng. Thuộc tính này sẽ không được xác định trừ phi chế độ di chuyển của bước này là TRANSIT.
transit_details optional
Loại:  TransitDetails optional
Thông tin chi tiết liên quan đến bước này nếu chế độ di chuyển là TRANSIT.

Giao diện DirectionsPolyline

google.maps.DirectionsPolylinegiao diện

Một đối tượng chứa thuộc tính points để mô tả đường nhiều đoạn của một DirectionsStep.
points
Loại:  string
Một đường nhiều đường được mã hoá.

Giao diện Địa điểm

google.maps.Placegiao diện

Chứa thông tin cần thiết để xác định vị trí, nhận dạng hoặc mô tả một địa điểm cho DirectionsRequest hoặc DistanceMatrixRequest. Trong ngữ cảnh này, "địa điểm" có nghĩa là một doanh nghiệp, địa điểm yêu thích hoặc vị trí địa lý. Để tìm nạp thông tin về một địa điểm, hãy xem PlacesService.
location optional
Loại:  LatLng|LatLngLiteral optional
LatLng của thực thể được mô tả theo địa điểm này.
placeId optional
Loại:  string optional
Mã địa điểm của địa điểm (chẳng hạn như doanh nghiệp hoặc địa điểm yêu thích). Mã địa điểm là giá trị nhận dạng duy nhất của một địa điểm trong cơ sở dữ liệu của Google Maps. Xin lưu ý rằng placeId là cách chính xác nhất để xác định một địa điểm. Nếu có thể, bạn nên chỉ định placeId thay vì query. Bạn có thể truy xuất mã địa điểm từ mọi yêu cầu đến Places API, chẳng hạn như TextSearch. Bạn cũng có thể truy xuất mã địa điểm từ các yêu cầu đến Geocoding API. Để biết thêm thông tin, hãy xem bài viết tổng quan về mã địa điểm.
query optional
Loại:  string optional
Cụm từ tìm kiếm mô tả địa điểm (chẳng hạn như doanh nghiệp hoặc địa điểm yêu thích). Ví dụ về truy vấn là "Quay, Upper Level, Overseas Passenger Terminal 5 Hickson Road, The Rocks NSW". Nếu có thể, bạn nên chỉ định placeId thay vì query. API này không đảm bảo độ chính xác khi phân giải chuỗi truy vấn thành một địa điểm. Nếu bạn cung cấp cả placeId và query, thì sẽ xảy ra lỗi.

Hằng số TravelMode

Hằng số google.maps.TravelMode

Các phương tiện di chuyển hợp lệ có thể được chỉ định trong DirectionsRequest cũng như các phương tiện di chuyển được trả về trong DirectionsStep. 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ụ: 'BICYCLING' hoặc google.maps.TravelMode.BICYCLING.

Truy cập bằng cách gọi const {TravelMode} = await google.maps.importLibrary("routes").
Xem Thư viện trong Maps JavaScript API.
BICYCLING Chỉ định một yêu cầu chỉ đường đi xe đạp.
DRIVING Chỉ định một yêu cầu chỉ đường lái xe.
TRANSIT Chỉ định một yêu cầu về đường đi bằng phương tiện công cộng.
BetaTWO_WHEELER Chỉ định một yêu cầu về đường đi cho xe mô tô hai bánh.
WALKING Chỉ định một yêu cầu chỉ đường đi bộ.

Giao diện DrivingOptions

google.maps.DrivingOptionsgiao diện

Định cấu hình DirectionsRequest khi chế độ di chuyển được đặt thành DRIVING.
departureTime
Loại:  Date
Thời gian khởi hành mong muốn cho tuyến đường, được chỉ định dưới dạng một đối tượng Date. Đối tượng Date đo thời gian tính bằng mili giây kể từ ngày 1 tháng 1 năm 1970. Bạn phải chỉ định thuộc tính này để DrivingOptions hợp lệ. Bạn phải đặt thời gian khởi hành là thời gian hiện tại hoặc một thời gian nào đó trong tương lai. Ngày này không được là một ngày trong quá khứ.
trafficModel optional
Loại:  TrafficModel optional
Giả định ưu tiên được dùng khi dự đoán thời lượng trong lưu lượng truy cập. Mặc định là BEST_GUESS.

Hằng số TrafficModel

Hằng số google.maps.TrafficModel

Các giả định cần sử dụng khi dự đoán thời gian di chuyển trong điều kiện giao thông thực tế. Được chỉ định trong DirectionsRequest hoặc DistanceMatrixRequest. 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ụ: 'bestguess' hoặc google.maps.TrafficModel.BEST_GUESS.

Truy cập bằng cách gọi const {TrafficModel} = await google.maps.importLibrary("routes").
Xem Thư viện trong Maps JavaScript API.
BEST_GUESS Sử dụng dữ liệu lưu lượng truy cập trong quá khứ để ước tính chính xác nhất thời gian bị kẹt xe.
OPTIMISTIC Sử dụng dữ liệu lưu lượng truy cập trước đây để đưa ra một ước tính lạc quan về thời lượng lưu lượng truy cập.
PESSIMISTIC Sử dụng dữ liệu lưu lượng truy cập trong quá khứ để đưa ra một ước tính bi quan về thời gian lưu lượng truy cập sẽ diễn ra.

Giao diện TransitOptions

google.maps.TransitOptionsgiao diện

Đối tượng TransitOptions sẽ được đưa vào một DirectionsRequest khi chế độ di chuyển được đặt thành TRANSIT.
arrivalTime optional
Loại:  Date optional
Thời gian đến dự kiến của tuyến đường, được chỉ định dưới dạng đối tượng Ngày. Đối tượng Date đo thời gian tính bằng mili giây kể từ ngày 1 tháng 1 năm 1970. Nếu bạn chỉ định thời gian đến, thì thời gian khởi hành sẽ bị bỏ qua.
departureTime optional
Loại:  Date optional
Thời gian khởi hành mong muốn cho tuyến đường, được chỉ định dưới dạng đối tượng Ngày. Đối tượng Date đo thời gian tính bằng mili giây kể từ ngày 1 tháng 1 năm 1970. Nếu bạn không chỉ định thời gian khởi hành và thời gian đến, thì thời gian được giả định là "hiện tại".
modes optional
Loại:  Array<TransitMode> optional
Một hoặc nhiều phương tiện giao thông công cộng mà bạn ưu tiên, chẳng hạn như xe buýt hoặc tàu hoả. Nếu bạn không đưa ra lựa chọn ưu tiên nào, API sẽ trả về tuyến đường tốt nhất mặc định.
routingPreference optional
Loại:  TransitRoutePreference optional
Một lựa chọn ưu tiên có thể ảnh hưởng đến việc chọn tuyến đường phương tiện công cộng, chẳng hạn như ít đi bộ. Nếu bạn không đưa ra lựa chọn ưu tiên nào, API sẽ trả về tuyến đường tốt nhất mặc định.

Hằng số TransitMode

Hằng số google.maps.TransitMode

Phương tiện công cộng hợp lệ, ví dụ: xe buýt có thể được chỉ định trong TransitOptions. 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ụ: 'BUS' hoặc google.maps.TransitMode.BUS.

Truy cập bằng cách gọi const {TransitMode} = await google.maps.importLibrary("routes").
Xem Thư viện trong Maps JavaScript API.
BUS Chỉ định xe buýt là phương tiện công cộng ưu tiên.
BetaLIGHT_RAIL Chỉ định tàu điện là phương tiện công cộng ưu tiên.
RAIL Chỉ định đường sắt là phương tiện công cộng ưu tiên.
SUBWAY Chỉ định tàu điện ngầm là phương tiện công cộng ưu tiên.
TRAIN Chỉ định tàu là phương tiện công cộng ưu tiên.
TRAM Chỉ định xe điện là phương tiện công cộng ưu tiên.

Hằng số TransitRoutePreference

Hằng số google.maps.TransitRoutePreference

Loại tuyến đường quá cảnh hợp lệ có thể được chỉ định trong một TransitOptions. 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ụ: 'LESS_WALKING' hoặc google.maps.TransitRoutePreference.LESS_WALKING.

Truy cập bằng cách gọi const {TransitRoutePreference} = await google.maps.importLibrary("routes").
Xem Thư viện trong Maps JavaScript API.
FEWER_TRANSFERS Chỉ định rằng tuyến đường được tính toán nên ưu tiên số lần chuyển phương tiện có giới hạn.
LESS_WALKING Chỉ định rằng tuyến đường được tính toán nên ưu tiên việc đi bộ trong phạm vi cho phép.

Giao diện TransitFare

google.maps.TransitFaregiao diện

Giá vé của DirectionsRoute bao gồm giá trị và đơn vị tiền tệ.
currency
Loại:  string
Mã đơn vị tiền tệ theo tiêu chuẩn ISO 4217 cho biết đơn vị tiền tệ mà giá vé được thể hiện.
text
Loại:  string
Giá trị của giá vé, được biểu thị bằng currency đã cho, dưới dạng một chuỗi.
value
Loại:  number
Giá trị bằng số của giá vé, được thể hiện bằng currency đã cho.

Giao diện TransitDetails

google.maps.TransitDetailsgiao diện

Thông tin chi tiết về điểm khởi hành, điểm đến và phương tiện công cộng được sử dụng trong bước này.
arrival_stop
Loại:  TransitStop
Điểm dừng đến của bước đi phương tiện công cộng này.
arrival_time
Loại:  Time
Thời gian đến của bước này, được chỉ định dưới dạng đối tượng Thời gian.
departure_stop
Loại:  TransitStop
Điểm dừng khởi hành của bước đi phương tiện công cộng này.
departure_time
Loại:  Time
Thời gian khởi hành của bước này, được chỉ định dưới dạng đối tượng Thời gian.
headsign
Loại:  string
Hướng di chuyển trên tuyến đường này, được đánh dấu trên xe hoặc tại điểm dừng khởi hành.
headway
Loại:  number
Số giây dự kiến giữa các phương tiện tương đương tại điểm dừng này.
line
Loại:  TransitLine
Thông tin chi tiết về tuyến phương tiện công cộng được dùng trong bước này.
num_stops
Loại:  number
Số điểm dừng trong bước này. Bao gồm điểm dừng đến nhưng không bao gồm điểm dừng đi.
trip_short_name
Loại:  string
Văn bản xuất hiện trong lịch trình và bảng hiệu để xác định một chuyến đi phương tiện công cộng cho hành khách, ví dụ: để xác định số tàu cho các chuyến đi bằng tàu hoả đi làm. Văn bản này xác định duy nhất một chuyến đi trong một ngày dịch vụ.

Giao diện TransitStop

google.maps.TransitStopgiao diện

Thông tin chi tiết về một trạm hoặc bến xe buýt.
location
Loại:  LatLng
Vị trí của điểm dừng này.
name
Loại:  string
Tên của điểm dừng phương tiện công cộng này.

Giao diện TransitLine

google.maps.TransitLinegiao diện

Thông tin về tuyến đường công cộng vận hành bước đi bộ này.
agencies
Loại:  Array<TransitAgency>
Công ty vận tải vận hành tuyến phương tiện công cộng này.
color
Loại:  string
Màu thường dùng trong biển báo cho tuyến phương tiện công cộng này, được biểu thị dưới dạng một chuỗi thập lục phân.
icon
Loại:  string
URL của một biểu tượng liên kết với dòng này.
name
Loại:  string
Tên đầy đủ của tuyến giao thông công cộng này, ví dụ: "8 Avenue Local".
short_name
Loại:  string
Tên viết tắt của tuyến giao thông công cộng này, ví dụ: "E".
text_color
Loại:  string
Màu văn bản thường dùng trong biển báo cho tuyến phương tiện công cộng này, được biểu thị dưới dạng một chuỗi thập lục phân.
url
Loại:  string
URL của cơ quan dành riêng cho tuyến phương tiện công cộng này.
vehicle
Loại:  TransitVehicle
Loại phương tiện được sử dụng, ví dụ: tàu hoả hoặc xe buýt.

Giao diện TransitAgency

google.maps.TransitAgencygiao diện

Thông tin về một công ty vận hành tuyến phương tiện công cộng.
name
Loại:  string
Tên của công ty vận tải này.
phone
Loại:  string
Số điện thoại của công ty vận tải công cộng.
url
Loại:  string
URL của công ty vận tải.

Giao diện TransitVehicle

google.maps.TransitVehiclegiao diện

Thông tin về phương tiện hoạt động trên một tuyến giao thông công cộng.
icon
Loại:  string
URL của một biểu tượng tương ứng với loại xe được sử dụng trên dòng này.
local_icon
Loại:  string
URL của một biểu tượng tương ứng với loại xe được sử dụng ở khu vực này thay vì biểu tượng chung chung hơn.
name
Loại:  string
Tên của loại TransitVehicle này, ví dụ: "Tàu hoả" hoặc "Xe buýt".
type
Loại:  VehicleType
Loại phương tiện được sử dụng, ví dụ: tàu hoả, xe buýt hoặc phà.

Hằng số VehicleType

Hằng số google.maps.VehicleType

Các giá trị có thể có cho loại xe.

Truy cập bằng cách gọi const {VehicleType} = await google.maps.importLibrary("routes").
Xem Thư viện trong Maps JavaScript API.
BUS Xe buýt.
CABLE_CAR Phương tiện hoạt động bằng cáp, thường là trên mặt đất. Cáp treo trên không có thể thuộc loại GONDOLA_LIFT.
COMMUTER_TRAIN Tàu chở khách đi làm.
FERRY Phà.
FUNICULAR Phương tiện được kéo lên dốc cao bằng cáp.
GONDOLA_LIFT Cáp treo trên không.
HEAVY_RAIL Đường sắt hạng nặng.
HIGH_SPEED_TRAIN Tàu cao tốc.
INTERCITY_BUS Xe buýt liên tỉnh.
METRO_RAIL Xe điện.
MONORAIL Xe lửa một ray.
OTHER Xe khác.
RAIL Đường sắt.
SHARE_TAXI Taxi đi chung là một loại hình vận tải bằng xe buýt, có thể đón và trả khách ở bất kỳ đâu trên tuyến đường. Thông thường, taxi đi chung sử dụng xe buýt nhỏ.
SUBWAY Xe điện ngầm.
TRAM Xe điện trên mặt đất.
TROLLEYBUS Xe điện bánh hơi.

Hằng số UnitSystem

Hằng số google.maps.UnitSystem

Các hệ thống đơn vị hợp lệ có thể được chỉ định trong DirectionsRequest.

Truy cập bằng cách gọi const {UnitSystem} = await google.maps.importLibrary("core").
Xem Thư viện trong Maps JavaScript API.
IMPERIAL Chỉ định rằng khoảng cách trong DirectionsResult phải được biểu thị bằng đơn vị đo lường của Anh.
METRIC Chỉ định rằng khoảng cách trong DirectionsResult phải được biểu thị bằng đơn vị đo lường.

Giao diện Distance

google.maps.Distancegiao diện

Biểu thị khoảng cách dưới dạng giá trị số và chuỗi hiển thị.
text
Loại:  string
Một chuỗi biểu thị giá trị khoảng cách, sử dụng UnitSystem được chỉ định trong yêu cầu.
value
Loại:  number
Khoảng cách tính bằng mét.

Giao diện Thời lượng

google.maps.Durationgiao diện

Biểu thị thời lượng dưới dạng giá trị số và chuỗi hiển thị.
text
Loại:  string
Giá trị biểu thị giá trị thời lượng ở dạng chuỗi.
value
Loại:  number
Thời lượng tính bằng giây.

Giao diện Thời gian

google.maps.Timegiao diện

Biểu thị thời gian dưới dạng đối tượng Ngày, chuỗi được bản địa hoá và múi giờ.
text
Loại:  string
Một chuỗi biểu thị giá trị của thời gian. Thời gian được hiển thị theo múi giờ của trạm dừng phương tiện công cộng.
time_zone
Loại:  string
Múi giờ của trạm dừng này. Giá trị này là tên của múi giờ theo quy định trong Cơ sở dữ liệu múi giờ IANA, ví dụ: "America/New_York".
value
Loại:  Date
Thời gian khởi hành hoặc đến này, được chỉ định dưới dạng đối tượng Ngày JavaScript.

Hằng số DirectionsTravelMode

Hằng số google.maps.DirectionsTravelMode

Hằng số DirectionsUnitSystem

Hằng số google.maps.DirectionsUnitSystem