Directions

DirectionsService

Lớp google.maps.DirectionsService

Dịch vụ để tính toán chỉ đường 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 API JavaScript Maps.
DirectionsService
DirectionsService()
Tham số: Không có
Tạo một thực thể mới của DirectionsService để gửi truy vấn chỉ đường đến các máy chủ của Google.
route
route(request[, callback])
Các thông số: 
Giá trị trả về:  Promise<DirectionsResult>
Đưa ra yêu cầu tìm kiếm chỉ đường.

Giao diện DirectionsRequest

Giao diện google.maps.DirectionsRequest

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

Hằng số DirectionsStatus

Hằng số google.maps.DirectionsStatus

Trạng thái được DirectionsService trả về khi hoàn tất lệnh gọi đến route(). Hãy chỉ định các biến 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 API JavaScript Maps.
INVALID_REQUEST DirectionsRequest đã cung cấp không hợp lệ.
MAX_WAYPOINTS_EXCEEDED Đã cung cấp quá nhiều DirectionsWaypoint trong DirectionsRequest. Xem hướng dẫn dành cho nhà phát triển để biết số đ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 này 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 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

Giao diện google.maps.DirectionsResult

Phản hồi về đường đi đượ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 DirectionsRenderer hoặc phân tích cú pháp và tự kết xuất đối tượng. 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 Nền tảng Google Maps. Xin lưu ý rằng mặc dù kết quả "giống JSON" nhưng không hoàn toàn là JSON vì nó gián tiếp bao gồm các đối tượng LatLng.
request
GuidelinesRequest đã tạo ra kết quả này.
routes
Một mảng DirectionsRoute, mỗi mảng chứa thông tin về các chân và các bước của thành phần đó. Sẽ chỉ có một tuyến trừ phi DirectionsRequest được tạo với provideRouteAlternatives và đặt thành true.
available_travel_modes optional
Loại:  Array<TravelMode> optional
Chứa một loạt các phương tiện đi lại hiện có. Trường này được trả về khi yêu cầu chỉ định phương tiện đi lại và không có kết quả. Mảng này chứa các phương tiện đi lại hiện có ở các quốc gia của tập hợp điểm tham chiếu cho trước. Trường này không được trả về nếu một hoặc nhiều điểm tham chiếu là "qua điểm tham chiếu".
geocoded_waypoints optional
Loại:  Array<DirectionsGeocodedWaypoint> optional
Một mảng DirectionsGeocodedWaypoint, mỗi mảng chứa thông tin về mã hoá địa lý điểm gốc, điểm đến và điểm tham chiếu.

Lớp DirectionsRenderer

Lớp google.maps.DirectionsRenderer

Hiển thị các chỉ đường nhận đượ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 API JavaScript Maps.
DirectionsRenderer
DirectionsRenderer([opts])
Các thông số: 
Tạo trình kết xuất đồ hoạ với các tuỳ chọn cho trước. Đường đi có thể được kết xuất 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).
getDirections
getDirections()
Tham số: Không có
Giá trị trả về:  DirectionsResult
Trả về tập hợp hướng 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 đồ nơi 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 hiển thị DirectionsResult.
getRouteIndex
getRouteIndex()
Tham số: Không có
Giá trị trả về:  number
Trả về chỉ mục tuyến hiện tại (dựa trên 0) mà đối tượng DirectionsRenderer này sử dụng.
setDirections
setDirections(directions)
Các thông số: 
Giá trị trả lại hàng: Không có
Thiết lập trình kết xuất để sử dụng kết quả từ DirectionsService. Việc đặt một nhóm chỉ đường hợp lệ theo cách này sẽ hiển thị chỉ đường 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)
Các thông số: 
Giá trị trả lại hàng: 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á thông tin đường đi khỏi bản đồ.
setOptions
setOptions(options)
Các thông số: 
Giá trị trả lại hàng: Không có
Thay đổi các tuỳ chọn cài đặt của DirectionsRenderer này sau khi khởi chạy.
setPanel
setPanel(panel)
Các thông số: 
Giá trị trả lại hàng: Không có
Phương thức này kết xuất hướng trong <div>. Truyền null để xoá nội dung khỏi bảng điều khiển.
setRouteIndex
setRouteIndex(routeIndex)
Các thông số: 
  • routeIndex:  number
Giá trị trả lại hàng: Không có
Đặt chỉ mục (dựa trên 0) của tuyến trong đối tượng DirectionsResult để kết xuất. Theo mặc định, tuyến đầ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 hướng được kết xuất thay đổi, khi DirectionsResult mới được đặt hoặc khi người dùng hoàn tất thao tác kéo thay đổi vào đường dẫn chỉ đường.

Giao diện DirectionsRendererOptions

Giao diện google.maps.DirectionsRendererOptions

Đối tượng này xác định các thuộc tính có thể đặt trên đối tượng DirectionsRenderer.
directions optional
Loại:  DirectionsResult optional
Đường đi sẽ 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 optional
Loại:  boolean optional
Nếu là true, hãy cho phép người dùng kéo và sửa đổi đường dẫn của các tuyến 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 được hiển thị trong bảng điều khiển chỉ đườ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 của cửa sổ thông tin hiện có sẽ bị ghi đè và vị trí của cửa sổ đó sẽ bị 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 đồ nơi để hiển thị chỉ đường.
markerOptions optional
Loại:  MarkerOptions optional
Tuỳ chọn cho điểm đánh dấu. Tất cả các điểm đánh dấu do DirectionsRenderer kết xuất sẽ sử dụng các tuỳ 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
Tuỳ chọn hình nhiều đường. Tất cả hình nhiều đường do DirectionsRenderer kết xuất sẽ sử dụng các tuỳ chọn này.
preserveViewport optional
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 đồ không bao giờ được đặt, thì bản đồ đầu vào sẽ được căn giữa và thu phóng tới hộp giới hạn của tập hợp hướng này.
routeIndex optional
Loại:  number optional
Chỉ mục của tuyến trong đối tượng DirectionsResult. Giá trị mặc định là "0".
suppressBicyclingLayer optional
Loại:  boolean optional
Loại bỏ quá trình kết xuất BicyclingLayer khi có yêu cầu chỉ đường đi xe đạp.
suppressInfoWindows optional
Loại:  boolean optional
Chặn hiển thị cửa sổ thông tin.
suppressMarkers optional
Loại:  boolean optional
Chặn hiển thị điểm đánh dấu.
suppressPolylines optional
Loại:  boolean optional
Ngăn chặn việc kết xuất hình nhiều đường.

Giao diện DirectionsWaypoint

Giao diện google.maps.DirectionsWaypoint

DirectionsWaypoint thể hiện vị trí giữa điểm khởi hành và điểm đến, nơi chuyến đi sẽ được định tuyến.
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 là true, cho biết điểm tham chiếu này là một điểm dừng giữa điểm gốc và điểm đến. Việc này có tác dụng chia tuyến đường thành hai chân. Nếu giá trị là false, hãy cho biết rằng tuyến đường nên đi qua điểm tham chiếu này, nhưng không được chia thành hai chân. Đ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 các điểm tham chiếu kéo người dùng trên bản đồ.

Giao diện DirectionsGeocodedWaypoint

Giao diện google.maps.DirectionsGeocodedWaypoint

Một điểm tham chiếu được mã hoá địa lý duy nhất.
partial_match optional
Loại:  boolean optional
Liệu bộ mã hoá địa lý có trả về kết quả trùng khớp hoàn toàn cho điểm tham chiếu ban đầu hay không, mặc dù bộ mã hoá có thể khớp một phần đị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 tham chiếu. Mã địa điểm xác định duy nhất một địa điểm trong cơ sở dữ liệu 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 cho nhà phát triển Places API.
types optional
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ể sử dụng, hãy tham khảo phần 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

Giao diện google.maps.DirectionsRoute

Một tuyến duy nhất chứa một tập hợp chân trong DirectionsResult. Xin lưu ý rằng mặc dù đối tượng này "giống JSON", nhưng nó 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.
bounds
Loại:  LatLngBounds
Các giới hạn của tuyến này.
copyrights
Loại:  string
Văn bản về bản quyền sẽ được 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 cấu thành. Sẽ có một chặng cho mỗi điểm dừng hoặc điểm đến được chỉ định. Vì vậy, tuyến đường không có điểm dừng sẽ chứa một DirectionsLeg và một tuyến đường có một điểm dừng sẽ chứa hai điểm dừng.
overview_path
Loại:  Array<LatLng>
Một mảng LatLng đại diện cho toàn bộ quá trình của tuyến này. Đường dẫn được đơn giản hoá để phù hợp trong các ngữ cảnh yêu cầu số lượng đỉnh nhỏ (chẳng hạn như URL của Static Maps API).
overview_polyline
Loại:  string
Một bản trình bày nhiều đường được mã hoá của tuyến 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 các hướng kết quả.
summary
Loại:  string
Chứa đoạn mô tả ngắn bằng văn bản về tuyến đường, phù hợp để đặt tên và phân biệt tuyến đường với các lựa chọn thay thế.
warnings
Loại:  Array<string>
Cảnh báo sẽ được hiển thị khi cho thấy các chỉ đường này.
waypoint_order
Loại:  Array<number>
Nếu bạn đặt optimizeWaypoints thành true, trường này sẽ chứa hoán vị 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à:
Nguồn gốc: Los Angeles
Điểm tham chiếu: Los Angeles, Bangor, Phoenix
Điểm đến: New York
và kết quả được tối ưu hoá được sắp xếp như sau:
Nguồn gốc: Los Angeles
Điểm tham chiếu: Phoenix, Los Angeles
Điểm đến: New York
, thì trường này sẽ là một Array chứa các giá trị [2, 0, 1]. Lưu ý rằng việc đánh số điểm tham chiếu được đánh số dựa trên 0.
Nếu bất kỳ điểm đầ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 không dùng được cho các 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 yêu cầu về phương tiện công cộng.

Giao diện DirectionsLeg

Giao diện google.maps.DirectionsLeg

Một chân bao gồm một tập hợp các bước trong DirectionsResult. Một số trường ở chân có thể không được trả về cho tất cả yêu cầu. Xin lưu ý rằng mặc dù kết quả "giống JSON", nhưng kết quả nà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.
end_address
Loại:  string
Địa chỉ đích đến của chặng này. Nội dung này được dùng để đọc nguyên trạng. Không được phân tích cú pháp địa chỉ được định dạng theo 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 đi lại gần nhất (thường là đường) 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, ví dụ: nếu con đường không gần đích đến của chặng này.
start_address
Loại:  string
Địa chỉ nguồn gốc của chân này. Nội dung này được dùng để đọc nguyên trạng. Không được phân tích cú pháp địa chỉ được định dạng theo 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 đi lại gần nhất (thường là đường) tại vị trí bắt đầu và kết thúc. start_location cho biết nguồn gốc thực tế được mã hoá địa lý, có thể khác với start_location của bước đầu tiên, ví dụ như nếu đường không gần gốc của chân này.
steps
Một mảng DirectionsStep, mỗi mảng chứa thông tin về các bước riêng lẻ trong chân này.
traffic_speed_entry
Loại:  Array<?>
Thông tin về tốc độ giao thông dọc theo chân.
via_waypoints
Loại:  Array<LatLng>
Một mảng các điểm tham chiếu không đ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 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 thay thế.

Khi sử dụng Dịch vụ chỉ đường để triển khai các 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ế. Bạn 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 khác.
arrival_time optional
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 optional
Loại:  Time optional
Thời gian khởi hành dự kiến 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 đi này đã đi. Thuộc tính này có thể không 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ể undefined vì không xác định được 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 mà tài sản trafficModel chỉ định. Thuộc tính này có thể undefined vì không xác định được thời lượng.

Giao diện DirectionsStep (Đường đi)

Giao diện google.maps.DirectionsStep

Một DirectionsStep trong DirectionsResult. Một số trường có thể là undefined. Xin lưu ý rằng mặc dù đối tượng này "giống JSON", nhưng nó không hoàn toàn là JSON vì nó trực tiếp bao gồm các đối tượng LatLng.
encoded_lat_lngs
Loại:  string
Nội dung biểu diễn nhiều dòng được mã hoá của bước này. Đây là một đường dẫn gần đúng (được làm mịn) 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 thực hiện bước này.
lat_lngs
Loại:  Array<LatLng>
Một chuỗi LatLng mô tả tiến trình của bước này. Đây là một đường dẫn gần đúng (được làm mịn) của bước.
maneuver
Loại:  string
Chứa thao tác 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ó thể có các giá trị mới mà không cần thông báo trước.
path
Loại:  Array<LatLng>
Một chuỗi LatLng mô tả tiến trình của bước này. Đây là một đường dẫn gần đúng (được làm mịn) 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 tiện đi lại được sử dụng trong bước này.
distance optional
Loại:  Distance optional
Quãng đường mà bước này đã đi. Thuộc tính này có thể undefined vì khoảng cách có thể không xác định.
duration optional
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ể undefined vì không xác định được 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" (điểm) chứa nội dung biểu diễn hình nhiều đường được mã hoá của bước đó. Hình nhiều đường này là một đường đi gần đúng (được làm mượt) 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 không phải phương tiện công cộng của các tuyến đường chuyển tuyến.
transit optional
Loại:  TransitDetails optional
Thông tin chi tiết dành riêng cho phương tiện công cộng về bước này. Thuộc tính này sẽ không được xác định trừ khi phương tiện đi lại 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 phương tiện đi lại là TRANSIT.

Giao diện DirectionsPolyline

Giao diện google.maps.DirectionsPolyline

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

Giao diện Place (Địa điểm)

Giao diện google.maps.Place

Chứa thông tin cần thiết để định vị, xác định 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ể mà địa điểm này mô tả.
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ừ bất kỳ yêu cầu nào đến Places API, chẳng hạn như TextSearch. Bạn cũng có thể lấy mã địa điểm từ các yêu cầu gửi tới API mã hoá địa lý. Để 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ư một doanh nghiệp hoặc địa điểm yêu thích). Một cụm từ tìm kiếm ví dụ: "Quay, Cấp trên, Nhà ga hành khách nước ngoài số 5 Đường Hickson, 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 đến 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 đ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. Hãy chỉ định các biến 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 API JavaScript Maps.
BICYCLING Chỉ định yêu cầu chỉ đường đi xe đạp.
DRIVING Chỉ định yêu cầu chỉ đường lái xe.
TRANSIT Chỉ định yêu cầu chỉ đường phương tiện công cộng.
WALKING Chỉ định yêu cầu chỉ đường đi bộ.

Giao diện DrivingOptions

Giao diện google.maps.DrivingOptions

Định cấu hình DirectionsRequest khi chế độ đi lại đượ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 đối tượng Date. Đối tượng Date đo thời gian theo 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 thì DrivingOptions mới hợp lệ. Bạn phải đặt thời gian khởi hành thành thời gian hiện tại hoặc một thời điểm nào đó trong tương lai. Nó không được là trong quá khứ.
trafficModel optional
Loại:  TrafficModel optional
Giả định ưu tiên sử 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 sử dụng khi dự đoán thời lượng trong lưu lượng truy cập. Được chỉ định như một phần của DirectionsRequest hoặc DistanceMatrixRequest. Hãy chỉ định các biến 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 API JavaScript Maps.
BEST_GUESS Sử dụng dữ liệu lưu lượng truy cập trước đây để ước tính chính xác nhất thời gian dành cho lưu lượng truy cập.
OPTIMISTIC Sử dụng dữ liệu lưu lượng truy cập trước đây để ước tính khả 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 trước đây để ước tính không đáng kể về thời lượng lưu lượng truy cập.

Giao diện TransitOptions

Giao diện google.maps.TransitOptions

Đối tượng TransitOptions cần được đưa vào DirectionsRequest khi chế độ đi lại được đặt thành TRANSIT.
arrivalTime optional
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 Ngày. Đối tượng Ngày đo lường thời gian theo 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 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 Ngày đo lường thời gian theo 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à "bây giờ".
modes optional
Loại:  Array<TransitMode> optional
Một hoặc nhiều phương thức di chuyển ưa thích, chẳng hạn như xe buýt hoặc tàu hoả. Nếu không có lựa chọn ưu tiên nào, API sẽ trả về tuyến mặc định tốt nhất.
routingPreference optional
Loại:  TransitRoutePreference optional
Một lựa chọn ưu tiên có thể thiên về lựa chọn tuyến đường phương tiện công cộng, chẳng hạn như ít đi bộ hơn. Nếu không có lựa chọn ưu tiên nào, API sẽ trả về tuyến mặc định tốt nhất.

Hằng số TransitMode

Hằng số google.maps.TransitMode

Chế độ phương tiện hợp lệ, ví dụ: xe buýt có thể được chỉ định trong TransitOptions. Hãy chỉ định các biến 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 API JavaScript Maps.
BUS Chỉ định xe buýt làm phương thức di chuyển ưu tiên.
RAIL Chỉ định đường sắt làm phương thức di chuyển ưu tiên.
SUBWAY Chỉ định tàu điện ngầm làm phương thức di chuyển ưu tiên.
TRAIN Chỉ định tàu hoả làm phương thức di chuyển ưa thích.
TRAM Chỉ định xe điện làm phương thức di chuyển ưu tiên.

Hằng số TransitRoutePreference

Hằng số google.maps.TransitRoutePreference

Loại tuyến đường chuyển tuyến hợp lệ có thể được chỉ định trong TransitOptions. Hãy chỉ định các biến 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 API JavaScript Maps.
FEWER_TRANSFERS Chỉ định rằng tuyến đã tính toán nên được chuyển với số lượng hạn chế.
LESS_WALKING Chỉ định rằng tuyến đường được tính toán nên ưu tiên đi bộ giới hạn.

Giao diện TransitFare

Giao diện google.maps.TransitFare

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ệ của giá vé.
value
Loại:  number
Giá trị bằng số của giá vé, biểu thị bằng currency cho trước.

Giao diện TransitDetails

Giao diện google.maps.TransitDetails

Thông tin chi tiết về điểm khởi hành, thời gian đến và phương thức di chuyển trong bước này.
arrival_stop
Loại:  TransitStop
Điểm dừng đến của chặng 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 này, vì nó được đánh dấu trên xe hoặc tại điểm khởi hành.
headway
Loại:  number
Số giây dự kiến giữa các xe tương đương tại trạm dừng này.
line
Loại:  TransitLine
Thông tin chi tiết về đường chuyển tuyến được sử dụng trong bước này.
num_stops
Loại:  number
Số điểm dừng ở bước này. Bao gồm điểm dừng đến, nhưng không bao gồm điểm khởi hành.
trip_short_name
Loại:  string
Văn bản xuất hiện trong lịch biểu và biển hiệu để 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 đi bằng đường sắt. Văn bản này xác định duy nhất một chuyến đi trong một ngày sử dụng dịch vụ.

Giao diện TransitStop

Giao diện google.maps.TransitStop

Thông tin chi tiết về một điểm dừng hoặc trạm phương tiện công cộng.
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 chuyển tuyến này.

Giao diện TransitLine

Giao diện google.maps.TransitLine

Thông tin về đường chuyển tuyến điều hành chặng chuyển tuyến này.
agencies
Loại:  Array<TransitAgency>
Công ty vận tải điều hành đường chuyển tuyến này.
color
Loại:  string
Màu sắc thường được sử 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 hex.
icon
Loại:  string
URL cho 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 đường chuyển tuyến này, ví dụ: "8 Avenue Local".
short_name
Loại:  string
Tên ngắn của đường chuyển tuyến 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 thể hiện dưới dạng một chuỗi hex.
url
Loại:  string
URL của đại lý dành riêng cho đường chuyển tuyến 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

Giao diện google.maps.TransitAgency

Thông tin về công ty vận hành đường chuyển tuyến.
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

Giao diện google.maps.TransitVehicle

Thông tin về xe đang hoạt động trên đường chuyển tuyến.
icon
Loại:  string
URL cho một biểu tượng tương ứng với loại phương tiện di chuyển 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 phương tiện được sử dụng tại khu vực này thay vì biểu tượng chung chung hơn.
name
Loại:  string
Tên cho loại xe Transit, ví dụ: "Tàu" 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

Giá trị có thể 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 API JavaScript Maps.
BUS Xe buýt.
CABLE_CAR Phương tiện vận hành bằng cáp, thường ở 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 bị cáp kéo lên dốc.
GONDOLA_LIFT Cáp treo trên không.
HEAVY_RAIL Đường sắt nặng.
HIGH_SPEED_TRAIN Tàu cao tốc.
INTERCITY_BUS Xe buýt liên thành phố.
METRO_RAIL Tàu điện.
MONORAIL Xe lửa chạy trên đường một ray.
OTHER Các loại xe khác.
RAIL Đường sắt.
SHARE_TAXI Taxi đi chung là một loại phương tiện vận tải xe buýt có khả năng trả khách và đón khách ở bất cứ đâu trên tuyến đường. Taxi đi chung thường sử dụng xe buýt nhỏ.
SUBWAY Tàu điện ngầm.
TRAM Phía trên đường sắt điện trên mặt đất.
TROLLEYBUS Xe điện.

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 API JavaScript Maps.
IMPERIAL Chỉ định rằng khoảng cách trong DirectionsResult phải được biểu thị bằng đơn vị hệ đ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 Khoảng cách

Giao diện google.maps.Distance

Biểu diễn 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 đại diện cho 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

Giao diện google.maps.Duration

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

Giao diện thời gian

Giao diện google.maps.Time

Biểu thị thời gian dưới dạng đối tượng Ngày, một chuỗi đã được bản địa hoá và múi giờ.
text
Loại:  string
Một chuỗi biểu thị giá trị thời gian. Thời gian được hiển thị theo múi giờ của điểm dừng chuyển tuyến.
time_zone
Loại:  string
Múi giờ của điểm dừng này. Giá trị là tên của múi giờ như được xác định trong Cơ sở dữ liệu múi giờ IANA, ví dụ: "America/New_xyz".
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 trong JavaScript.

Hằng số DirectionsTravelMode

Hằng số google.maps.DirectionsTravelMode

Hằng số DirectionsUnitSystem

Hằng số google.maps.DirectionsUnitSystem