Directions

Lớp DirectionsService

Lớp google.maps.DirectionsService

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 phần Thư viện trong API Maps JavaScript.
DirectionsService
DirectionsService()
Thông 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.
route
route(request[, callback])
Thông số: 
Giá trị trả về:  Promise<DirectionsResult>
Đưa ra yêu cầu tìm kiếm đường đi.

Giao diện DirectionsRequest

Giao diện google.maps.DirectionsRequest

Truy vấn đường đi sẽ được gửi đến DirectionsService.
destination
Loại:  string|LatLng|Place|LatLngLiteral
Vị trí của đích đế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 optional
Loại:  boolean optional
Nếu true, hãy hướng dẫn dịch vụ Đường đi 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 khi 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 các đường có trạm thu phí khi 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 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ề (khi 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, DirectionsService sẽ cố gắng sắp xếp lại các điểm trung gian được cung cấp để giảm thiểu chi phí tổng thể của tuyến đường. Nếu các điểm trung gian đượ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 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 độ lệch 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 mã ccTLD 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 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 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 di chuyển khác.
unitSystem optional
Loại:  UnitSystem optional
Mặc định: Hệ đơn vị được sử dụng ở quốc gia xuất xứ.
Hệ đơ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 trung gian. Đường đi được tính toán từ điểm xuất phát đến điểm đến thông qua từng điểm trung gian 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 trung gian tối đa được phép. Điểm trung gian không được hỗ trợ 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 hằng này theo giá trị hoặc bằng cách sử dụng tên của hằng. 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 phần Thư viện trong API Maps JavaScript.
INVALID_REQUEST DirectionsRequest được cung cấp không hợp lệ.
MAX_WAYPOINTS_EXCEEDED Đã 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 trung gian 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 trung gian.
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 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 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ủ đường đi. Bạn có thể kết xuất các đối tượng này bằng DirectionsRenderer hoặc tự phân tích cú pháp và kết xuất đối tượng này. Bạn phải đăng cảnh báo và thông tin 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 "giống JSON", nhưng không phải là JSON nghiêm ngặt vì kết quả này gián tiếp bao gồm các đối tượng LatLng.
request
DirectionsRequest đã trả về kết quả này.
routes
Một mảng DirectionsRoute, mỗi DirectionsRoute chứa thông tin về các chân và bước tạo nên DirectionsRoute đó. Sẽ chỉ có một tuyến đường trừ phi DirectionsRequest được tạo với 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 tiện di chuyển có sẵn. Trường này được trả về khi một yêu cầu chỉ định một phương thức di chuyển và không nhận được kết quả nào. Mảng này chứa các phương thức di chuyển có sẵn ở các quốc gia của tập hợp điểm trung gian nhất định. Trường này không được trả về nếu một hoặc nhiều điểm trung gian là "thông qua điểm trung gian".
geocoded_waypoints optional
Loại:  Array<DirectionsGeocodedWaypoint> optional
Một mảng DirectionsGeocodedWaypoint, mỗi DirectionsGeocodedWaypoint chứa thông tin về việc mã hoá địa lý của điểm xuất phát, điểm đến và điểm trung gian.

Lớp DirectionsRenderer

Lớp google.maps.DirectionsRenderer

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

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ể được đặt trên đối tượng DirectionsRenderer.
directions optional
Loại:  DirectionsResult optional
Chỉ đường để 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 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 optional
Loại:  boolean optional
Mặc định: false
Thuộc tính này cho biết 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 đ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 sổ thông tin hiện tại sẽ bị ghi đè và vị trí của cửa sổ sẽ được di chuyển. Nếu 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ị thông tin đường đi.
markerOptions optional
Loại:  MarkerOptions optional
Các tuỳ 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 tuỳ chọn này.
panel optional
Loại:  HTMLElement optional
<div> để hiển thị các bước chỉ dẫn.
polylineOptions optional
Loại:  PolylineOptions optional
Các tuỳ chọn cho đường đa tuyến. Tất cả các đường đa tuyến 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 chưa bao giờ đặt tâm và tỷ lệ thu phóng của bản đồ, thì bản đồ đầu vào sẽ được căn giữa và thu phóng đến hộp giới hạn của bộ hướng dẫn 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
Ngăn chặn việc kết xuất BicyclingLayer khi có yêu cầu chỉ đường đi xe đạp.
suppressInfoWindows optional
Loại:  boolean optional
Ngăn hiển thị cửa sổ thông tin.
suppressMarkers optional
Loại:  boolean optional
Ngăn hiển thị điểm đánh dấu.
suppressPolylines optional
Loại:  boolean optional
Ngăn hiển thị các đường đa tuyến.

Giao diện DirectionsWaypoint

Giao diện google.maps.DirectionsWaypoint

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.
location optional
Loại:  string|LatLng|LatLngLiteral|Place optional
Vị trí điểm tham chiếu. Có thể là 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 trung gian 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 là false, cho biết tuyến đường phải đi qua điểm trung gian 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 việc người dùng kéo các điểm trung gian trên bản đồ.

Giao diện DirectionsGeocodedWaypoint

Giao diện google.maps.DirectionsGeocodedWaypoint

Một điểm trung gian được mã hoá địa lý.
partial_match optional
Loại:  boolean optional
Liệu trình chuyển đổi địa lý có trả về kết quả khớp chính xác với điểm trung gian ban đầu hay không, mặc dù 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 liên kết với điểm trung gian. 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 về API Địa điểm.
types optional
Loại:  Array<string> optional
Một mảng chuỗi biểu thị loại của 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

Giao diện google.maps.DirectionsRoute

Một tuyến đường chứa một nhóm 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 phải là JSON nghiêm ngặt 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 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 DirectionsLeg chứa thông tin về các bước tạo nên DirectionsLeg đó. Sẽ có một chặng cho mỗi điểm dừng chân hoặc điểm đến được chỉ định. 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 DirectionsLeg.
overview_path
Loại:  Array<LatLng>
Một mảng các LatLng đại diện cho toàn bộ lộ trình của tuyến này. Đường dẫn được đơn giản hoá để phù hợp với các ngữ cảnh cần một số ít đỉnh (chẳng hạn như URL API Bản đồ tĩnh).
overview_polyline
Loại:  string
Đại diện hình nhiều đường được mã hoá của tuyến đường trong overview_path. Đường đa tuyến này là đường dẫn gần đúng (được làm mượt) của các hướng dẫn thu được.
summary
Loại:  string
Chứa nội dung mô tả ngắn gọn về 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 hướng dẫn này.
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 trung gian đầu vào. Ví dụ: nếu dữ liệu đầu vào là:
  Nguồn gốc: Los Angeles
  Điểm trung gian: Dallas, Bangor, Phoenix
  Đích đến: New York
và dữ liệu đầu ra được tối ưu hoá được sắp xếp như sau:
  Nguồn gốc: Los Angeles
  Điểm trung gian: Phoenix, Dallas, Bangor
  Đích đến: New York
thì trường này sẽ là Array chứa các giá trị [2, 0, 1]. Xin lưu ý rằng việc đánh số các điểm trung gian được tính từ 0.
Nếu bất kỳ điểm trung gian đầu vào nào có stopover được đặt thành false, thì trường này sẽ trống, vì không thể tối ưu hoá tuyến đường 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 các yêu cầu đi 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 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 không phải là JSON nghiêm ngặt 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ỉ của điểm đến của chặng này. Nội dung này được đọc nguyên trạng. Đừng phân tích cú pháp địa chỉ đã đị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 giao thông 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ý. Giá trị này 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 đích đế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 đọc nguyên trạng. Đừng phân tích cú pháp địa chỉ đã đị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 giao thông 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 điểm xuất phát thực tế được mã hoá địa lý. Điểm này có thể khác với start_location của bước đầu tiên nếu, ví dụ: đường không nằm gần điểm xuất phát của chặng này.
steps
Một mảng DirectionsStep, mỗi DirectionsStep chứa thông tin về từng bước trong chặng này.
traffic_speed_entry
Loại:  Array<?>
Thông tin về tốc độ giao thông dọc theo tuyến đường.
via_waypoints
Loại:  Array<LatLng>
Một mảng các điểm trung gian không phải điểm dừng chân dọc theo chặng bay 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 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 khớp với 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 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 của chặng này. 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 bay này. Thuộc tính này có thể là undefined vì thời lượng có thể không xác định.
duration_in_traffic optional
Loại:  Duration optional
Tổng thời lượng của chặng này, có tính đến điều kiện giao thông do thuộc tính trafficModel cho biết. Thuộc tính này có thể là undefined vì thời lượng có thể không xác định.

Giao diện DirectionsStep

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 không phải là JSON nghiêm ngặt 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
Biểu diễn đường đa tuyến tính được mã hoá của bước. Đây là đường dẫn ước tính (đã 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 trình tự LatLng mô tả tiến trình của bước này. Đây là đường dẫn ước tính (đã 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à chúng tôi có thể ra mắt các giá trị mới mà không cần thông báo trước.
path
Loại:  Array<LatLng>
Một trình tự LatLng mô tả tiến trình của bước này. Đây là đường dẫn ước tính (đã 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 tiện di chuyển được sử 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 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.
polyline optional
Loại:  DirectionsPolyline optional
Chứa một đối tượng có một thuộc tính duy nhất là "điểm", chứa đường đa tuyến được mã hoá thể hiện bước. Đường đa tuyến này là đường dẫn ước chừng (đã 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 phần không phải là phương tiện công cộng của tuyến đường công cộng.
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ừ phi phương thức 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ế độ đ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ả đường đa tuyến của DirectionsStep.
points
Loại:  string
Một đường đa tuyến tính được mã hoá.

Giao diện Place (Đặt)

Giao diện google.maps.Place

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, điểm tham quan 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ả bằng đị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 đ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 gửi đến API Địa điểm, 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 API Địa chỉ. Để biết thêm thông tin, hãy xem 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 điểm tham quan). Ví dụ: "Quay, Tầng trên, Trạm hành khách quốc tế 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, lỗi sẽ xảy ra.

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. Chỉ định các hằng này theo giá trị hoặc bằng cách sử dụng tên của hằng. 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 phần Thư viện trong API Maps JavaScript.
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 bằ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ế độ 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 đố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ệ. 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 trong tương lai. Ngày này không được là ngày 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 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 lượng lưu lượng truy cập. Được chỉ định trong DirectionsRequest hoặc DistanceMatrixRequest. Chỉ định các hằng này theo giá trị hoặc bằng cách sử dụng tên của hằng. 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 phần Thư viện trong API Maps JavaScript.
BEST_GUESS Sử dụng dữ liệu lưu lượng truy cập trong quá khứ để ước tính thời gian lưu lượng truy cập một cách chính xác nhất.
OPTIMISTIC Sử dụng dữ liệu lưu lượng truy cập trước đây để ước tính thời lượng lưu lượng truy cập một cách lạc quan.
PESSIMISTIC Sử dụng dữ liệu lưu lượng truy cập trong quá khứ để ước tính mức thấp nhất 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 sẽ đượ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 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ì 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 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 optional
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. 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 optional
Loại:  TransitRoutePreference optional
Lựa chọn ưu tiên có thể làm sai lệch lựa chọn tuyến 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

Hằng số google.maps.TransitMode

Phương thức giao thông hợp lệ, ví dụ: xe buýt có thể được chỉ định trong TransitOptions. Chỉ định các hằng này theo giá trị hoặc bằng cách sử dụng tên của hằng. 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 phần Thư viện trong API Maps JavaScript.
BUS Chỉ định xe buýt làm 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àm 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 phương tiện công cộng hợp lệ có thể được chỉ định trong TransitOptions. Chỉ định các hằng này theo giá trị hoặc bằng cách sử dụng tên của hằng. 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 phần Thư viện trong API Maps JavaScript.
FEWER_TRANSFERS Chỉ định rằng tuyến đường được tính toán nên ưu tiên số lượng phương tiện chuyển đổi có hạn.
LESS_WALKING Chỉ định rằng tuyến đường được tính toán nên ưu tiên số lượng đi bộ có 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 ISO 4217 cho biết đơn vị tiền tệ mà giá vé được thể hiện.
value
Loại:  number
Giá trị bằng số của giá vé, được thể hiện trong currency đã cho.

Giao diện TransitDetails

Giao diện google.maps.TransitDetails

Thông tin chi tiết về thời gian khởi hành, đến và phương tiện công cộng được sử dụng trong bước này.
arrival_stop
Loại:  TransitStop
Trạm đế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
Trạ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
Giờ 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 đi trên tuyến 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 sử dụng trong bước này.
num_stops
Loại:  number
Số điểm dừng trên bước này. Bao gồm điểm đế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 trình và bảng 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 tàu đô thị. Văn bản này xác định riêng một chuyến đi trong một ngày hoạt động.

Giao diện TransitStop

Giao diện google.maps.TransitStop

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

Giao diện TransitLine

Giao diện google.maps.TransitLine

Thông tin về tuyến phương tiện công cộng vận hành bước đi lại 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 sắc 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ụ: xe lửa hoặc xe buýt.

Giao diện TransitAgency

Giao diện google.maps.TransitAgency

Thông tin về công ty vận tải vận hành một 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.
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ề phương tiện hoạt động trên một tuyến phương tiện 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 tuyến 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 trong khu vực này thay vì biểu tượng chung hơn.
name
Loại:  string
Tên của loại phương tiện công cộng này, 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

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 phần Thư viện trong API Maps JavaScript.
BUS Xe buýt.
CABLE_CAR Xe hoạt động trên cáp, thường là trên mặt đất. Cáp treo 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 bằng cáp.
GONDOLA_LIFT Một chiếc 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 Tàu một ray.
OTHER 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 bằng xe buýt có khả năng đón và trả khách ở bất cứ đâu trên tuyến đường của xe. Thường thì xe 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 phần Thư viện trong API Maps JavaScript.
IMPERIAL Chỉ định rằng khoảng cách trong DirectionsResult phải được thể hiện bằng đơn vị đo lường theo hệ thống Anh.
METRIC Chỉ định rằng khoảng cách trong DirectionsResult phải được thể hiện bằng đơn vị đo lường mét.

Giao diện Distance (Khoảng cách)

Giao diện google.maps.Distance

Biểu thị khoảng cách dưới dạng giá trị số và chuỗi hiển thị.
text
Loại:  string
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 Duration (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
Giá trị thời lượng được biểu thị dưới dạng chuỗi.
value
Loại:  number
Thời lượng tính bằng giây.

Giao diện Time (Thời gian)

Giao diện google.maps.Time

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 đại diện cho 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 đ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ụ: "Hoa Kỳ/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 Ngày JavaScript.

Hằng số DirectionsTravelMode

Hằng số google.maps.DirectionsTravelMode

Hằng số DirectionsUnitSystem

Hằng số google.maps.DirectionsUnitSystem