Directions (deprecated)

Lớp DirectionsService

google.maps.DirectionsService lớp
thư viện "routes"

Ngừng hoạt động: google.maps.DirectionsService sẽ ngừng hoạt động kể từ ngày 25 tháng 2 năm 2026. Hiện tại, chúng tôi chưa có kế hoạch ngừng cung cấp google.maps.DirectionsService và sẽ tiếp tục cung cấp các bản sửa lỗi cho mọi sự cố hồi quy nghiêm trọng. Chúng tôi sẽ thông báo ít nhất 12 tháng trước khi ngừng hỗ trợ. Vui lòng truy cập vào https://developers.google.com/maps/legacy để biết thêm thông tin.

const {DirectionsService} = await google.maps.importLibrary("routes");

Hàm dựng
DirectionsService	DirectionsService() Tham số: Không có Tạo một thực thể mới của DirectionsService để gửi truy vấn đường đi đến máy chủ của Google.

Phương thức
route	route(request[, callback]) Tham số: request: DirectionsRequest callback: function(DirectionsResult optional, DirectionsStatus): void optional Giá trị trả về: Promise<DirectionsResult> Đưa ra yêu cầu tìm đường đi.

Giao diện DirectionsRequest

google.maps.DirectionsRequest giao diện

Một truy vấn đường đi sẽ được gửi đến DirectionsService.

Thuộc tính
destination	Loại: string|LatLng|Place|LatLngLiteral Vị trí của điểm đến. Bạn có thể chỉ định giá trị này dưới dạng một chuỗi cần được mã hoá địa lý, hoặc LatLng, hoặc Place. Bắt buộc.
origin	Loại: string|LatLng|Place|LatLngLiteral Vị trí xuất xứ. Bạn có thể chỉ định giá trị này dưới dạng một chuỗi cần được mã hoá địa lý, hoặc LatLng, hoặc Place. Bắt buộc.
travelMode	Loại: TravelMode Loại định tuyến được yêu cầu. Bắt buộc.
avoidFerries không bắt buộc	Loại: boolean optional Nếu là true, hãy hướng dẫn dịch vụ Đường đi tránh phà nếu có thể. Không bắt buộc.
avoidHighways không bắt buộc	Loại: boolean optional Nếu là 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 không bắt buộc	Loại: boolean optional Nếu true, hãy hướng dẫn dịch vụ Chỉ đường tránh các đường có thu phí nếu có thể. Không bắt buộc.
drivingOptions không bắt buộc	Loại: DrivingOptions optional 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 có hiệu lực đối với các phương thức di chuyển khác.
language không bắt buộc	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 không bắt buộc	Loại: boolean optional Nếu bạn đặ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 không bắt buộc	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 không bắt buộc	Loại: string optional Mã vùng được dùng làm tiêu chí 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 hai ký tự ccTLD ("miền cấp cao nhất"). Hầu hết các mã ccTLD đều giống với mã ISO 3166-1, ngoại trừ một số trường hợp ngoại lệ đá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 Liên hiệp Anh và Bắc Ireland").
transitOptions không bắt buộc	Loại: TransitOptions optional Chế độ cài đặt chỉ áp dụng cho các yêu cầu có travelMode là TRANSIT. Đối tượng này sẽ không có hiệu lực đối với các phương thức di chuyển khác.
unitSystem không bắt buộc	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 không bắt buộc	Loại: Array<DirectionsWaypoint> optional Mảng các điểm tham chiếu trung gian. Đường đi được tính từ điểm xuất phát đế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 tham chiếu tối đa được phép. Điểm tham chiếu không được hỗ trợ cho đường đi bằng phương tiện công cộng. Không bắt buộc.

Hằng số DirectionsStatus

google.maps.DirectionsStatus hằng số
thư viện "routes"

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.

Bạn cũng có thể sử dụng các hằng số này dưới dạng chuỗi. Trong TypeScript, giá trị cố định kiểu chuỗi được xác định bằng loại DirectionsStatusString.

const {DirectionsStatus} = await google.maps.importLibrary("routes");

Hằng số
INVALID_REQUEST	DirectionsRequest được cung cấp không hợp lệ.
MAX_WAYPOINTS_EXCEEDED	Quá nhiều DirectionsWaypoint được cung cấp trong DirectionsRequest. Hãy xem hướng dẫn dành cho nhà phát triển để biết số lượng điểm tham chiế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 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 thể xử lý yêu cầu chỉ đường do lỗi phía 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 xuất phát và điểm đến.

Giao diện DirectionsResult

google.maps.DirectionsResult giao diện

Phản hồi về đường đi được truy xuất từ máy chủ đường đi. Bạn có thể kết xuất các thành phần này bằng DirectionsRenderer hoặc phân tích cú pháp đối tượng này rồi tự kết xuất. Bạn phải hiển thị các cảnh báo và bản quyền như đã nêu trong Điều khoản dịch vụ của Google Maps Platform. Xin lưu ý rằng mặc dù kết quả này "giống JSON", nhưng đây không hoàn toàn là JSON vì nó gián tiếp bao gồm các đối tượng LatLng.

Thuộc tính
request	Loại: DirectionsRequest DirectionsRequest đã tạo ra kết quả này.
routes	Loại: Array<DirectionsRoute> Một mảng DirectionsRoute, mỗi mảng chứa thông tin về các chặng và bước tạo nên mảng đó. Sẽ chỉ có một tuyến đường trừ phi DirectionsRequest được tạo bằng provideRouteAlternatives được đặt thành true.
available_travel_modes không bắt buộc	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 phương thức di chuyển và không nhận được kết quả. Mảng này chứa các phương tiện di chuyển có sẵn ở các quốc gia của tập hợp đ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 tham chiếu là "điểm tham chiếu trung gian".
geocoded_waypoints không bắt buộc	Loại: Array<DirectionsGeocodedWaypoint> optional Một mảng DirectionsGeocodedWaypoint, mỗi mảng chứa thông tin về mã hoá địa lý của điểm xuất phát, điểm đến và điểm tham chiếu.

Lớp DirectionsRenderer

google.maps.DirectionsRenderer class
extends MVCObject
library "routes"

Ngừng hoạt động: google.maps.DirectionsRenderer sẽ ngừng hoạt động kể từ ngày 25 tháng 2 năm 2026. Hiện tại, google.maps.DirectionsRenderer chưa có lịch ngừng hoạt động và sẽ tiếp tục nhận được các bản sửa lỗi cho mọi lỗi hồi quy nghiêm trọng. Chúng tôi sẽ thông báo ít nhất 12 tháng trước khi ngừng hỗ trợ. Vui lòng truy cập vào https://developers.google.com/maps/legacy để biết thêm thông tin.

const {DirectionsRenderer} = await google.maps.importLibrary("routes");

Hàm dựng
DirectionsRenderer	DirectionsRenderer([opts]) Tham số: opts: DirectionsRendererOptions optional Tạo trình kết xuất bằng các tuỳ chọn đã cho. Đường đi có thể được hiển thị trên bản đồ (dưới dạng lớp phủ hình ảnh) 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).

Phương thức
getDirections	getDirections() Tham số: Không có Giá trị trả về: DirectionsResult|null Trả về tập hợp đường đi hiện tại của trình kết xuất.
getMap	getMap() Tham số: Không có Giá trị trả về: Map|null 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> nơi DirectionsResult được hiển thị.
getRouteIndex	getRouteIndex() Tham số: Không có Giá trị trả về: number Trả về chỉ mục tuyến đường hiện tại (bắt đầu từ 0) mà đối tượng DirectionsRenderer này đang sử dụng.
setDirections	setDirections(directions) Tham số: directions: DirectionsResult optional 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 tập hợp đường đi hợp lệ theo cách này sẽ hiển thị đường đi 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ố: map: Map optional Giá trị trả về: Không có Phương thức này chỉ định bản đồ mà đường đi sẽ được hiển thị. Truyền null để xoá đường đi khỏi bản đồ.
setOptions	setOptions(options) Tham số: options: DirectionsRendererOptions optional Giá trị trả về: Không có Thay đổi chế độ cài đặt của DirectionsRenderer này sau khi khởi chạy.
setPanel	setPanel(panel) Tham số: panel: HTMLElement optional Giá trị trả về: Không có Phương thức này hiển thị đường đi trong <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 cần hiển thị. Theo mặc định, tuyến đường đầu tiên trong mảng sẽ được hiển thị.
Được kế thừa: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

Sự kiện
directions_changed	function() Đối số: Không có Sự kiện này được kích hoạt khi đường đi được kết xuất thay đổi, khi DirectionsResult mới được đặt hoặc khi người dùng hoàn tất việc kéo thay đổi đối với đường đi.

Giao diện DirectionsRendererOptions

google.maps.DirectionsRendererOptions giao diện

Đối tượng này xác định các thuộc tính có thể đặt trên đối tượng DirectionsRenderer.

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

Giao diện DirectionsWaypoint

google.maps.DirectionsWaypoint giao diện

DirectionsWaypoint đại diện cho một vị trí giữa điểm xuất phát và điểm đến mà chuyến đi sẽ đi qua.

Thuộc tính
location không bắt buộc	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 không bắt buộc	Loại: boolean optional Mặc định: true Nếu true, cho biết điểm tham chiếu này là một điểm dừng giữa điểm xuất phát và điểm đến. Điều này có tác dụng chia tuyến đường thành hai chặng. Nếu false, cho biết rằng tuyến đường nên được ưu tiên đi qua điểm tham chiếu này, nhưng không được chia thành hai 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.DirectionsGeocodedWaypoint giao diện

Một điểm tham chiếu được mã hoá địa lý.

Thuộc tính
partial_match không bắt buộc	Loại: boolean optional Liệu bộ mã hoá địa lý có trả về kết quả khớp chính xác cho điểm tham chiếu ban đầu hay không, mặc dù bộ mã hoá địa lý có thể khớp một phần địa chỉ được yêu cầu.
place_id không bắt buộc	Loại: string optional Mã địa điểm liên kết với điểm tham chiế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 không bắt buộc	Loại: Array<string> optional Một mảng chuỗi biểu thị loại phần tử được mã hoá địa lý được trả về. Để 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.DirectionsRoute giao diện

Một tuyến đường duy nhất chứa một tập hợp các chặng trong DirectionsResult. Xin lưu ý rằng mặc dù đối tượng này "giống JSON", nhưng không hoàn toàn là JSON, vì đối tượng này trực tiếp và gián tiếp bao gồm các đối tượng LatLng.

Thuộc tính
bounds	Loại: LatLngBounds Ranh giới cho tuyến đường này.
copyrights	Loại: string Văn bản bản quyền sẽ hiển thị cho tuyến đường này.
legs	Loại: Array<DirectionsLeg> Một mảng DirectionsLeg, mỗi mảng chứa thông tin về các bước tạo nên mảng đó. Sẽ có một chặng cho mỗi điểm tham chiếu hoặc điểm đến được chỉ định. Vì vậy, một tuyến đường không có điểm tham chiếu dừng chân sẽ chứa một DirectionsLeg và một tuyến đường có một điểm tham chiếu dừng chân sẽ chứa hai.
overview_path	Loại: Array<LatLng> Một mảng LatLng đại diện cho toàn bộ lộ trình của tuyến đường này. Đường dẫn được đơn giản hoá để phù hợp với những bối cảnh cần có một số lượng nhỏ đỉnh (chẳng hạn như URL của API Maps tĩnh).
overview_polyline	Loại: string Biểu diễn hình nhiều đường được mã hoá của tuyến đường trong overview_path. Hình nhiều đường này là một đường đi gần đúng (đã được làm mượt) của đường đi 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 hiển thị các đường đi này.
waypoint_order	Loại: Array<number> Nếu optimizeWaypoints được đặt thành true, thì 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 dữ liệu đầu vào là:   Điểm xuất phát: Los Angeles   Điểm tham chiếu: Dallas, Bangor, Phoenix   Điểm đến: New York và dữ liệu đầu ra được tối ưu hoá theo thứ tự như sau:   Điểm xuất phát: Los Angeles   Điểm tham chiếu: 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 việc đánh số điểm tham chiếu bắt đầu 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 áp dụng cho các truy vấn như vậy.
fare không bắt buộc	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 yêu cầu về phương tiện công cộng.

Giao diện DirectionsLeg

google.maps.DirectionsLeg giao diện

Một chặng duy nhất bao gồm một tập hợp các bước trong 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 "giống JSON", nhưng đây không hoàn toàn là JSON vì kết quả này trực tiếp và gián tiếp bao gồm các đối tượng LatLng.

Thuộc tính
end_address	Loại: string Địa chỉ của điểm đến của chặng này. Nội dung này được dùng để đọc nguyên trạng. Đừng phân tích cú pháp địa chỉ được định dạng theo phương thức 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í xuất phát và vị trí kết thúc. end_location cho biết điểm đế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, ví dụ: đường không ở gần điểm đến của chặng này.
start_address	Loại: string Địa chỉ của điểm xuất phát của chặng này. Nội dung này được dùng để đọc nguyên trạng. Đừng phân tích cú pháp địa chỉ được định dạng theo phương thức 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í xuất phát và vị trí kết thúc. start_location cho biết điểm xuất phát 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, ví dụ: đường không ở gần điểm xuất phát của chặng này.
steps	Loại: Array<DirectionsStep> Một mảng DirectionsStep, mỗi mảng chứa thông tin về từng bước trong chặng này.
traffic_speed_entry	Không dùng nữa: Mảng này sẽ luôn trống. Loại: Array<*> Thông tin về tốc độ giao thông dọc theo chặng.
via_waypoints	Loại: Array<LatLng> Một mảng các điểm tham chiếu không phải điểm dừng 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 thêm via_waypoints bổ sung vào các tuyến đường thay thế. Khi sử dụng Dịch vụ chỉ đường để triển khai tính năng 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ỉ có thể kéo tuyến đường chính. 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 không bắt buộc	Loại: Time optional Thời gian đến dự kiến cho chặng này. Chỉ áp dụng cho các yêu cầu TRANSIT.
departure_time không bắt buộc	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 không bắt buộc	Loại: Distance optional Tổng quãng đường của chặng này. Thuộc tính này có thể không xác định được vì có thể không biết khoảng cách.
duration không bắt buộc	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ì thời lượng có thể không xác định được.
duration_in_traffic không bắt buộc	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ỉ định bằng thuộc tính trafficModel. Thuộc tính này có thể là undefined vì thời lượng có thể không xác định được.

Giao diện DirectionsStep

google.maps.DirectionsStep giao diện

Một DirectionsStep duy nhất trong DirectionsResult. Một số trường có thể undefined. Xin lưu ý rằng mặc dù đối tượng này "giống JSON", nhưng không hoàn toàn là JSON vì đối tượng này trực tiếp bao gồm các đối tượng LatLng.

Thuộc tính
encoded_lat_lngs	Loại: string Biểu diễn 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	Không dùng nữa: Vui lòng sử dụng DirectionsStep.end_location. 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	Không dùng nữa: Vui lòng sử dụng DirectionsStep.path. Loại: Array<LatLng> Một chuỗi LatLng mô tả quá trình 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 đưa ra mà không cần thông báo trước.
path	Loại: Array<LatLng> Một chuỗi LatLng mô tả quá trình 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	Không dùng nữa: Vui lòng sử dụng DirectionsStep.start_location. 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 sử dụng trong bước này.
distance không bắt buộc	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 được.
duration không bắt buộc	Loại: Duration optional Thời gian thông thường 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ì thời lượng có thể không xác định được.
polyline không bắt buộc	Không dùng nữa: Vui lòng sử dụng DirectionsStep.encoded_lat_lngs. 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 biểu thị hình nhiều đường được mã hoá của bước. Hình nhiều đường này là đường đi gần đúng (đã được làm mượt) của bước.
steps không bắt buộc	Loại: Array<DirectionsStep> optional Các bước phụ của bước này. Được chỉ định cho các đoạn không phải là phương tiện công cộng của tuyến phương tiện công cộng.
transit không bắt buộc	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 phương thức di chuyển của bước này là TRANSIT.
transit_details không bắt buộc	Loại: TransitDetails optional Thông tin chi tiết liên quan đến bước này nếu phương tiện di chuyển là TRANSIT.

Giao diện DirectionsPolyline

google.maps.DirectionsPolyline giao diện

Một đối tượng chứa thuộc tính points để mô tả hình nhiều đường của DirectionsStep.

Thuộc tính
points	Loại: string Hình nhiều đường được mã hoá.

Giao diện Place

google.maps.Place giao diện

Chứa thông tin cần thiết để tìm, xác định hoặc mô tả một địa điểm cho DirectionsRequest hoặc DistanceMatrixRequest. Trong bối 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.

Thuộc tính
location không bắt buộc	Loại: LatLng|LatLngLiteral optional LatLng của thực thể được mô tả theo địa điểm này.
placeId không bắt buộc	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ừ bất kỳ yêu cầu nào đế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 gửi đế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 không bắt buộc	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ề một cụm từ tìm kiếm: "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 không đảm bảo độ chính xác của việc 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

google.maps.TravelMode hằng số
thư viện "routes"

Các phương tiện đi lại hợp lệ có thể được chỉ định trong DirectionsRequest cũng như các phương tiện đi lại đượ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.

Bạn cũng có thể sử dụng các hằng số này dưới dạng chuỗi. Trong TypeScript, giá trị cố định kiểu chuỗi được xác định bằng loại TravelModeString.

const {TravelMode} = await google.maps.importLibrary("routes");

Hằng số
BICYCLING	Chỉ định yêu cầu về đường đi xe đạp.
DRIVING	Chỉ định yêu cầu về đường lái xe.
TRANSIT	Chỉ định yêu cầu về đường đi bằng phương tiện công cộng.
TWO_WHEELER	Lưu ý: Chỉ có trong kênh thử nghiệm Beta. Chỉ định yêu cầu về đường đi cho xe hai bánh.
WALKING	Chỉ định yêu cầu về đường đi bộ.

Giao diện DrivingOptions

google.maps.DrivingOptions giao diện

Định cấu hình DirectionsRequest khi chế độ di chuyển được đặt thành DRIVING.

Thuộc tính
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 đối tượng Date. Đối tượng Date đo lường 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 giá trị này để DrivingOptions hợp lệ. Thời gian khởi hành phải được đặt thành thời gian hiện tại hoặc một thời điểm trong tương lai. Ngày này không được là ngày trong quá khứ.
trafficModel không bắt buộc	Loại: TrafficModel optional Giả định ưu tiên cần sử dụng khi dự đoán thời gian di chuyển trong tình trạng giao thông. Mặc định là BEST_GUESS.

Hằng số TrafficModel

google.maps.TrafficModel hằng số
thư viện "routes"

Các giả định cần sử dụng khi dự đoán thời gian di chuyển trong tình trạng giao thông. Đượ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.

Bạn cũng có thể sử dụng các hằng số này dưới dạng chuỗi. Trong TypeScript, giá trị cố định kiểu chuỗi được xác định bằng loại TrafficModelString.

const {TrafficModel} = await google.maps.importLibrary("routes");

Hằng số
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 di chuyển trong tình trạng giao thông hiện tại.
OPTIMISTIC	Sử dụng dữ liệu lưu lượng truy cập trước đây để đưa ra thông tin ước tính khả quan về thời gian di chuyển trong tình trạng giao thông hiện tại.
PESSIMISTIC	Sử dụng dữ liệu lưu lượng truy cập trước đây để đưa ra thông tin ước tính thận trọng về thời gian di chuyển trong tình trạng giao thông hiện tại.

Giao diện TransitOptions

google.maps.TransitOptions giao diện

Đối tượng TransitOptions cần đưa vào DirectionsRequest khi phương thức di chuyển được đặt thành TRANSIT.

Thuộc tính
arrivalTime không bắt buộc	Loại: Date optional Thời gian đến mong muốn cho tuyến đường, được chỉ định dưới dạng đối tượng Date. Đối tượng Date đo lường 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ời gian khởi hành sẽ bị bỏ qua.
departureTime không bắt buộc	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 Date. Đối tượng Date đo lường 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 hoặc thời gian đến, thì thời gian được giả định là "bây giờ".
modes không bắt buộc	Loại: Array<TransitMode> optional Một hoặc nhiều phương tiện công cộng ư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, API sẽ trả về tuyến đường tốt nhất mặc định.
routingPreference không bắt buộc	Loại: TransitRoutePreference optional Lựa chọn ưu tiên có thể ảnh hưởng đến việc chọn tuyến đường đi bằng phương tiện công cộng, chẳng hạn như ít đi bộ hơn. Nếu bạn không đưa ra lựa chọn ưu tiên, API sẽ trả về tuyến đường tốt nhất mặc định.

Hằng số TransitMode

google.maps.TransitMode hằng số
thư viện "routes"

Chế độ 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.

Bạn cũng có thể sử dụng các hằng số này dưới dạng chuỗi. Trong TypeScript, giá trị cố định kiểu chuỗi được xác định bằng loại TransitModeString.

const {TransitMode} = await google.maps.importLibrary("routes");

Hằng số
BUS	Chỉ định xe buýt là phương tiện công cộng ưu tiên.
LIGHT_RAIL	Lưu ý: Chỉ có trong kênh thử nghiệm Beta. Chỉ định xe đ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 hoả 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

google.maps.TransitRoutePreference hằng số
thư viện "routes"

Loại tuyến phương tiện công cộng hợp lệ 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ụ: 'LESS_WALKING' hoặc google.maps.TransitRoutePreference.LESS_WALKING.

Bạn cũng có thể sử dụng các hằng số này dưới dạng chuỗi. Trong TypeScript, giá trị cố định kiểu chuỗi được xác định bằng loại TransitRoutePreferenceString.

const {TransitRoutePreference} = await google.maps.importLibrary("routes");

Hằng số
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 hạn chế.
LESS_WALKING	Chỉ định rằng tuyến đường được tính toán nên ưu tiên đi bộ ít.

Giao diện TransitFare

google.maps.TransitFare giao diện

Giá vé của DirectionsRoute bao gồm giá trị và đơn vị tiền tệ.

Thuộc tính
currency	Loại: string Mã tiền tệ theo ISO 4217 cho biết đơn vị tiền tệ của giá vé.
text	Loại: string Giá trị của giá vé, được biểu thị bằng currency đã cho, dưới dạng 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.TransitDetails giao 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.

Thuộc tính
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 Time.
departure_stop	Loại: TransitStop Điểm 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 Time.
headsign	Loại: string Hướng di chuyển trên tuyến này, như được đánh dấu trên phương tiện 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 xe 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 sử 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 chỉ dẫn để xác định chuyến đi bằng 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 tàu đi lại. Văn bản xác định duy nhất một chuyến đi trong một ngày dịch vụ.

TransitStop giao diện

google.maps.TransitStop giao diện

Thông tin chi tiết về một trạm dừng hoặc nhà ga phương tiện công cộng.

Thuộc tính
location	Loại: LatLng Vị trí của điểm dừng này.
name	Loại: string Tên của trạm phương tiện công cộng này.

Giao diện TransitLine

google.maps.TransitLine giao diện

Thông tin về tuyến phương tiện công cộng vận hành bước đi bằng phương tiện công cộng này.

Thuộc tính
agencies	Loại: Array<TransitAgency> Công ty vận tải điều 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 chuỗi thập lục phân.
icon	Loại: string URL của 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 phương tiện công cộng này, ví dụ: "8 Avenue Local".
short_name	Loại: string Tên ngắn của tuyến phương tiện 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 chuỗi thập lục phân.
url	Loại: string URL của công ty vận tải 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.TransitAgency giao 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.

Thuộc tính
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.
url	Loại: string URL của công ty vận tải.

Giao diện TransitVehicle

google.maps.TransitVehicle giao diện

Thông tin về phương tiện hoạt động trên một tuyến phương tiện công cộng.

Thuộc tính
icon	Loại: string URL của biểu tượng tương ứng với loại phương tiện được sử dụng trên tuyến này.
local_icon	Loại: string URL của biểu tượng tương ứng với loại phương tiện đượ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

google.maps.VehicleType hằng số
thư viện "routes"

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

Bạn cũng có thể sử dụng các hằng số này dưới dạng chuỗi. Trong TypeScript, giá trị cố định kiểu chuỗi được xác định bằng loại VehicleTypeString.

const {VehicleType} = await google.maps.importLibrary("routes");

Hằng số
BUS	Doanh nghiệp.
CABLE_CAR	Phương tiện vận hành 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	Một chiếc xe được kéo lên dốc cao bằng cáp.
GONDOLA_LIFT	Cáp treo trên không.
HEAVY_RAIL	Tàu điện 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	Tàu điện một ray.
OTHER	Xe khác.
RAIL	Đường sắt.
SHARE_TAXI	Xe 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 cứ đâu trên tuyến đường của xe. Taxi đi chung thường sử dụng xe buýt nhỏ.
SUBWAY	Xe điện ngầm.
TRAM	Xe điện trên mặt đất.
TROLLEYBUS	Xe buýt điện.

UnitSystem UnitSystem

google.maps.UnitSystem hằng số
thư viện "core"

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

const {UnitSystem} = await google.maps.importLibrary("core");

Hằng số
IMPERIAL	Chỉ định rằng khoảng cách trong DirectionsResult phải được biểu thị bằng đơn vị đo lường Anh.
METRIC	Chỉ định rằng khoảng cách trong DirectionsResult phải được biểu thị bằng đơn vị hệ mét.

Giao diện Distance

google.maps.Distance giao diện

Biểu thị khoảng cách dưới dạng giá trị số và chuỗi hiển thị.

Thuộc tính
text	Loại: string Biểu thị giá trị khoảng cách dưới dạng chuỗi, 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 Duration

google.maps.Duration giao diện

Biểu thị thời lượng dưới dạng giá trị số và chuỗi hiển thị.

Thuộc tính
text	Loại: string Giá trị biểu thị 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 Time

google.maps.Time giao diện

Biểu thị thời gian dưới dạng đối tượng Date, chuỗi được bản địa hoá và múi giờ.

Thuộc tính
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 điểm dừng phương tiện công cộng.
time_zone	Loại: string Múi giờ của điểm dừng này. Giá trị này là tên của múi giờ được xác đị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, được chỉ định dưới dạng đối tượng Date của JavaScript.