Lớp 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 phần Thư viện trong Maps JavaScript API.
Hàm dựng | |
---|---|
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 chỉ đường đến máy chủ Google. |
Phương pháp | |
---|---|
route |
route(request[, callback]) Thông số:
Giá trị trả về:
Promise<DirectionsResult> Tạo 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
.
Thuộc tính | |
---|---|
destination |
Loại:
string|LatLng|Place|LatLngLiteral Vị trí xuất hiện. Điều này có thể được chỉ định dưới dạng một chuỗi cần được mã hóa địa lý, một LatLng hoặc một Place . Bắt buộc. |
origin |
Loại:
string|LatLng|Place|LatLngLiteral Vị trí xuất xứ. Điều này có thể được chỉ định dưới dạng một chuỗi cần được mã hóa địa lý, một LatLng hoặc một Place . Bắt buộc. |
travelMode |
Loại:
TravelMode Loại yêu cầu định tuyến. 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 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ụ 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 những yêu cầu có travelMode là DRIVING . Đối tượng này sẽ không ảnh hưởng đến các phương tiện đi lại 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 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 tuyến đường thay thế hay không. Không bắt buộc. |
region optional |
Loại:
string optional Mã vùng được dùng làm xu hướng yêu cầu mã hóa đị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 mã ccTLD giống với mã ISO 3166-1, 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à thực thể của "Vương quốc Anh và Bắc Ireland"). |
transitOptions optional |
Loại:
TransitOptions optional Chế độ cài đặt chỉ áp dụng cho những yêu cầu trong đó travelMode là thuận lợi. Đố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ị được sử dụng ở quốc gia xuất xứ.
Hệ thống đơn vị ưa thích để sử dụng khi hiển thị khoảng cách. |
waypoints optional |
Loại:
Array<DirectionsWaypoint> optional Mảng điểm trung gian trung gian. Chỉ đường được tính từ điểm khởi hành đế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 cho phép. Hệ thống không hỗ trợ điểm tham chiếu cho chỉ đường phương tiện. 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 tới route()
. Bạn có thể chỉ định các giá trị này theo giá trị hoặc bằng cách 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 phần Thư viện trong Maps JavaScript API.
Các hằng số | |
---|---|
INVALID_REQUEST |
DirectionsRequest được cung cấp không hợp lệ. |
MAX_WAYPOINTS_EXCEEDED |
Bạn đã 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 cho phép. |
NOT_FOUND |
Không thể mã hoá địa lý ít nhất một trong số 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 thể 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 chỉ đường được truy xuất từ máy chủ chỉ đường. Bạn có thể kết xuất các lớp này bằng cách sử dụng DirectionsRenderer
hoặc phân tích cú pháp đối tượng này và tự hiển thị đối tượng. Bạn phải hiển thị cảnh báo và bản quyền như được ghi chú 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 kết quả này không nghiêm ngặt JSON vì nó gián tiếp bao gồm các đối tượng LatLng
.
Thuộc tính | |
---|---|
routes |
Loại:
Array<DirectionsRoute> Một mảng DirectionsRoute s, mỗi phần chứa thông tin về chân và các bước tạo. Sẽ chỉ có một tuyến đường trừ phi DirectionsRequest được thực hiện với provideRouteAlternatives được đặ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 có sẵn. Trường này được trả về khi một yêu cầu chỉ định chế độ đi lại và không nhận được kết quả nào. Mảng này chứa các phương tiện đi lại có thể sử dụng ở các quốc gia của tập hợp điểm tham chiếu nhất định. Trường này sẽ 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 nhóm chứa thông tin về việc mã hóa địa lý nguồn gốc, điểm đến và điểm tham chiếu. |
Lớp DirectionsRenderer
Lớp google.maps.DirectionsRenderer
Hiển thị thông tin chỉ đường lấy 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 Maps JavaScript API.
Hàm dựng | |
---|---|
DirectionsRenderer |
DirectionsRenderer([opts]) Thông số:
Tạo trình kết xuất với các tùy chọn cho sẵn. Thông tin đường đi có thể hiển thị trên bản đồ (dưới dạng lớp phủ hình ảnh) hoặc có thể hiển thị thêm 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 pháp | |
---|---|
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> mà 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 đường hiện tại (dựa trên 0) mà đối tượng DirectionsRenderer này sử dụng. |
setDirections |
setDirections(directions) Thông số:
Giá trị trả về: Không có
Thiết lập để trình kết xuất sử dụng kết quả từ DirectionsService . Việc thiết lập một tập hợp các chỉ đường hợp lệ theo cách này sẽ hiển thị thông tin chỉ đường trên bản đồ và bảng điều khiển mà trình kết xuất đã chỉ định. |
setMap |
setMap(map) Thông số:
Giá trị trả về: Không có
Phương thức này chỉ định bản đồ mà các hướng sẽ được hiển thị. Đi qua null để xóa thông tin đường đi khỏi bản đồ. |
setOptions |
setOptions(options) Thông số:
Giá trị trả về: Không có
Thay đổi các tuỳ chọn 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ị các hướng trong <div> . Truyền null để xoá nội dung khỏi bảng điều khiển. |
setRouteIndex |
setRouteIndex(routeIndex) Thông số:
Giá trị trả về: Không có
Đặt chỉ mục (dựa trên 0) của tuyến đường trong đối tượng DirectionsResult để hiển thị. Theo mặc định, tuyến đầu tiên trong mảng sẽ hiển thị. |
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 thông tin đường đi đã 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 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
.
Thuộc tính | |
---|---|
directions optional |
Loại:
DirectionsResult optional Thông tin đườ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 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 mà 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 liệu trình kết xuất có cung cấp danh sách các tuyến đường mà người dùng có thể chọn trong bảng điều 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 trong cửa sổ thông tin hiện có sẽ bị ghi đè và vị trí của nó bị di chuyển. Nếu bạn không chỉ định cửa sổ thông tin, thì 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 đồ: sẽ hiển thị thông tin đường đi trên đó. |
markerOptions optional |
Loại:
MarkerOptions optional Các tùy 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ỉ đường. |
polylineOptions optional |
Loại:
PolylineOptions optional Các lựa chọn cho hình nhiều đường. Tất cả hình nhiều đường do DirectionsRenderer hiển thị 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 tùy chọn này thành true hoặc tâm của bản đồ và mức thu phóng chưa được đặt, thì bản đồ đầu vào sẽ được căn giữa và thu phóng vào hộp giới hạn của tập hợp đường đi này. |
routeIndex optional |
Loại:
number optional Chỉ mục của tuyến đường trong đối tượng DirectionsResult . Giá trị mặc định là "0". |
suppressBicyclingLayer optional |
Loại:
boolean optional Đình chỉ việc kết xuất BicyclingLayer khi có yêu cầu chỉ đường đi xe đạp. |
suppressInfoWindows optional |
Loại:
boolean optional Chặn hoạt động kết xuất cửa sổ thông tin. |
suppressMarkers optional |
Loại:
boolean optional Ngăn việc kết xuất các điểm đánh dấu. |
suppressPolylines optional |
Loại:
boolean optional Ngăn hiển thị nhiều đường. |
Giao diện DirectionsWaypoint
Giao diện google.maps.DirectionsWaypoint
DirectionsWaypoint
thể hiện vị trí giữa điểm bắt đầu và điểm đến mà bạn định tuyến chuyến đi.
Thuộc tính | |
---|---|
location optional |
Loại:
string|LatLng|LatLngLiteral|Place optional Vị trí điểm tham chiếu. Có thể là một chuỗi địa chỉ, LatLng hoặc Place . Không bắt buộc. |
stopover optional |
Loại:
boolean optional Mặc định:
true Nếu true , cho biết điểm tham chiếu này là điểm dừng giữa điểm khởi hành và điểm đến. Cách này có tác dụng tách tuyến đường thành hai chân. Nếu false , cho biết tuyến đường nên có xu hướng đi qua điểm tham chiếu này, nhưng không được chia thành hai chân. Việc này rất hữu ích nếu bạn muốn tạo tuyến đường để phản hồi các điểm tham chiếu kéo của 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ã hóa địa lý duy nhất.
Thuộc tính | |
---|---|
partial_match optional |
Loại:
boolean optional Liệu bộ mã hoá dữ liệu có không 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á có thể so khớp một phần của địa chỉ đã yêu cầu. |
place_id optional |
Loại:
string optional Mã địa điểm 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 về API Địa điểm. |
types optional |
Loại:
Array<string> optional Một mảng chuỗi biểu thị loại phần tử đã được mã hóa địa lý được trả về. Để biết danh sách các chuỗi có thể xảy ra, hãy tham khảo mục 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 duy nhất chứa một nhóm các chân trong DirectionsResult
. Xin lưu ý rằng mặc dù đối tượng này giống "JSON", nhưng đối tượng này không hoàn toàn ở dạng 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 Các giới hạn cho tuyến đường này. |
copyrights |
Loại:
string Văn bản có bản quyền sẽ xuất hiện trên tuyến đường này. |
legs |
Loại:
Array<DirectionsLeg> Một mảng DirectionsLeg , mỗi nhóm chứa thông tin về các bước tạo thành phần. Sẽ có một chặng cho mỗi điểm dừng hoặc điểm đến được chỉ định. Do đó, tuyến đường không có điểm tham chiếu sẽ chứa một DirectionsLeg và tuyến có 1 điểm tham chiếu sẽ chứa 2. |
overview_path |
Một mảng LatLng đại diện cho toàn bộ tuyến đường này. Đường dẫn được đơn giản hoá để phù hợp với ngữ cảnh yêu cầu một số ít đỉnh (chẳng hạn như URL của API Maps tĩnh). |
overview_polyline |
Loại:
string Nội dung biểu diễn đa hình đã mã hoá của tuyến đường trong Overview_path. Hình nhiều đường này là một đường dẫn gần đúng (được làm mượt) của các hướng kết quả. |
summary |
Loại:
string Chứa thông tin mô tả bằng văn bản ngắn cho 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> Hiển thị cảnh báo khi hiển thị các hướng dẫn này. |
waypoint_order |
Loại:
Array<number> Nếu bạn đặt optimizeWaypoints thành true , trường này sẽ chứa phép hoán vị được sắp xếp lại của các điểm tham chiếu đầu vào. Ví dụ: nếu đầu vào là:Nguồn gốc: Los Angeles Điểm tham chiếu: Dallas, Bangor, Phoenix Điểm đến: New York và kết quả đầu ra được tối ưu hóa được sắp xếp như sau: Nguồn gốc: Los Angeles Điểm tham chiếu: Phoenix, Dallas, Bangor Đích: New York thì trường này sẽ là Array chứa các giá trị [2, 0, 1]. Lưu ý rằng việc đánh số điểm tham chiếu là dựa trên 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 hóa tuyến đường không được hỗ trợ cho các truy vấn đó. |
fare optional |
Loại:
TransitFare optional Tổng giá vé cho toàn bộ chuyến đi bằng phương tiện công cộng. Chỉ áp dụng cho các yêu cầu về phương tiện công cộng. |
Giao diện DirectionsLeg
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 phần 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ả này "giống JSON", nhưng kết quả này không nghiêm ngặt JSON vì nó 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 này. Nội dung này sẽ được đọc nguyên trạng. Đừng dùng phương pháp lập trình để phân tích cú pháp địa chỉ được định dạng. |
end_location |
Loại:
LatLng DirectionsService tính toán đường đi giữa các địa điểm 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 đã được mã hóa thực tế, có thể khác với end_location của bước cuối cùng, chẳng hạn như khi đường không ở gần đích của chân này. |
start_address |
Loại:
string Địa chỉ xuất xứ của chân này. Nội dung này sẽ được đọc nguyên trạng. Đừng dùng phương pháp lập trình để phân tích cú pháp địa chỉ được định dạng. |
start_location |
Loại:
LatLng DirectionsService tính toán đường đi giữa các địa điểm 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 nguồn gốc thực tế đã được mã hóa địa lý, có thể khác với start_location của bước đầu tiên, chẳng hạn như đường không gần nguồn gốc của chân này. |
steps |
Loại:
Array<DirectionsStep> Một mảng DirectionsStep , mỗi nhóm chứa thông tin về các bước riêng lẻ trong chặng này. |
|
Loại:
Array<?> Thông tin về tốc độ giao thông dọc theo chân. |
via_waypoints |
Một loạt các điểm trung gian không dừng dọc theo chân này, đã được chỉ định trong yêu cầu ban đầu. Không dùng nữa trong các tuyến khác. Phiên bản 3.27 sẽ là phiên bản cuối cùng của API bổ sung thêm 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ế. 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 đó khớp với một tuyến đường 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 OFAC. |
departure_time optional |
Loại:
Time optional Thời gian khởi hành dự kiến của chặng này. Chỉ áp dụng cho các yêu cầu OFAC. |
distance optional |
Loại:
Distance optional Tổng quãng đường mà chân này đã đi được. Có thể thuộc tính này chưa được xác định vì khoảng cách có thể không xác định. |
duration optional |
Loại:
Duration optional Tổng thời lượng của chặng này. Thuộc tính này có thể là undefined vì 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 tình trạng giao thông) của tài sản trafficModel . 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 đây không phải là JSON hoàn toàn 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 Nội dung biểu diễn đa hình đã 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. |
|
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. |
|
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.). Giá trị có thể thay đổi và giá trị mới có thể được giới thiệu mà không cần thông báo trước. |
path |
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. |
|
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 đã sử dụng trong bước này. |
distance optional |
Loại:
Distance optional Quãng đường mà bạn đã đi được ở bước này. Cơ sở lưu trú này có thể có giá trị 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 để 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. |
|
Loại:
DirectionsPolyline optional Chứa một đối tượng có một thuộc tính duy nhất, "điểm", chứa một giá trị biểu diễn đa dòng đã mã hoá của bước. Hình nhiều đường này là một đường dẫn 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 mục không phải phương tiện công cộng của các tuyến phương tiện công cộng. |
transit optional |
Loại:
TransitDetails optional Thông tin chi tiết của từng phương tiện công cộng về bước này. Thuộc tính này sẽ không xác định trừ khi chế độ đ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ả nhiều đường liên kết của DirectionsStep
.
Thuộc tính | |
---|---|
points |
Loại:
string Một polyline được mã hoá. |
Giao diện Place
Giao diện google.maps.Place
Chứa thông tin cần thiết để xác định vị trí, xác định hoặc mô tả địa điểm của 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
.
Thuộc tính | |
---|---|
location optional |
Loại:
LatLng|LatLngLiteral optional LatLng của thực thể được mô tả tại đị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ư một 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 Google Maps. Xin lưu ý rằng placeId là cách chính xác nhất để xác định một địa điểm. Nếu có thể, bạn nên chỉ định placeId thay vì query . Bạn có thể truy xuất mã địa điểm từ mọi yêu cầu đến API địa điểm, chẳng hạn như TextSearch. Bạn cũng có thể truy xuất mã địa điểm từ yêu cầu được gửi đến API mã hóa đị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 ví dụ về cụm từ tìm kiếm là "Quay, Tầng 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 vào 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
. Bạn có thể chỉ định các giá trị này theo giá trị hoặc bằng cách 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 phần Thư viện trong Maps JavaScript API.
Các hằng số | |
---|---|
BICYCLING |
Chỉ định một yêu cầu chỉ đường đi xe đạp. |
DRIVING |
Chỉ định một yêu cầu chỉ đường lái xe. |
TRANSIT |
Chỉ định một yêu cầu chỉ đường phương tiện. |
WALKING |
Chỉ định yêu cầu chỉ đường đi bộ. |
Giao diện DriveOptions
Giao diện google.maps.DrivingOptions
Định cấu hình DirectionsRequest
khi chế độ đi lại đượ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 là đối tượng Date . Đối tượng Date đo thời gian tính bằng mili giây kể từ ngày 1 tháng 1 năm 1970. Bạn phải chỉ định thuộc tính này thì DrivingOptions mới 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. 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 trong lưu lượng truy cập. Được chỉ định trong DirectionsRequest
hoặc DistanceMatrixRequest
. Bạn có thể chỉ định các giá trị này theo giá trị hoặc bằng cách 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 phần Thư viện trong Maps JavaScript API.
Các 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 thời gian lưu lượng truy cập. |
OPTIMISTIC |
Sử dụng dữ liệu lưu lượng truy cập trong quá khứ để ướ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 từ trước đến nay để ước tính cụ thể về thời lượng truy cập. |
Giao diện TransitOptions
Giao diện google.maps.TransitOptions
Đối tượng TransOptions có được đưa vào DirectionsRequest
khi chế độ di chuyển được đặt thành ĐI.
Thuộc tính | |
---|---|
arrivalTime optional |
Loại:
Date optional Thời gian đến mong muốn cho tuyến đường, được chỉ định là đối tượng Date. Đối tượng Ngày đo thời gian tính bằng mili giây kể từ ngày 1 tháng 1 năm 1970. Nếu bạn chỉ định thời gian đến, thì thời gian khởi hành sẽ bị bỏ qua. |
departureTime optional |
Loại:
Date optional Giờ khởi hành mong muốn cho tuyến đường, được chỉ định là đối tượng Date. Đối tượng Ngày đo thời gian tính bằng mili giây kể từ ngày 1 tháng 1 năm 1970. Nếu cả thời gian khởi hành và thời gian đến đều không được chỉ định, thì thời gian sẽ được giả định là "hiện tại". |
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 xe lửa. Nếu bạn không đưa ra lựa chọn ưu tiên nào, API sẽ trả về tuyến đường tốt nhất mặc định. |
routingPreference optional |
Loại:
TransitRoutePreference optional Một tùy chọn có thể thiên về lựa chọn tuyến đường chuyển tuyến, 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 nào, API sẽ trả về tuyến đường tốt nhất mặc định. |
Hằng số TransitMode
Hằng số google.maps.TransitMode
Phương tiện công cộng hợp lệ, ví dụ: xe buýt có thể được chỉ định trong TransitOptions
. Bạn có thể chỉ định các giá trị này theo giá trị hoặc bằng cách 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 phần Thư viện trong Maps JavaScript API.
Các hằng số | |
---|---|
BUS |
Chỉ định xe buýt làm phương tiện công cộng ưa thích. |
RAIL |
Chỉ định đường sắt làm phương tiện công cộng ưa thích. |
SUBWAY |
Chỉ định tàu điện ngầm làm phương thức di chuyển yêu thích. |
TRAIN |
Chỉ định tàu là phương tiện công cộng ưu tiên. |
TRAM |
Chỉ định xe điện làm phương tiện công cộng ưu tiên. |
Hằng số TransitRoutePreference
Hằng số google.maps.TransitRoutePreference
Loại tuyến đường phương tiện hợp lệ có thể được chỉ định trong TransitOptions
. Bạn có thể chỉ định các giá trị này theo giá trị hoặc bằng cách 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 phần Thư viện trong Maps JavaScript API.
Các hằng số | |
---|---|
FEWER_TRANSFERS |
Chỉ định rằng tuyến đã tính cần ưu tiên một số lần chuyển. |
LESS_WALKING |
Chỉ định rằng tuyến đường được tính toán nên thích đi bộ 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ệ.
Thuộc tính | |
---|---|
currency |
Loại:
string Mã đơn vị tiền tệ theo ISO 4217 cho biết đơn vị tiền tệ của giá vé được thể hiện. |
value |
Loại:
number Giá trị số của giá vé được thể hiện bằng currency . |
Giao diện TransitDetails
Giao diện google.maps.TransitDetails
Thông tin chi tiết về chuyến 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 của bước 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 là đối tượng Thời gian. |
departure_stop |
Loại:
TransitStop Điểm dừng khởi hành của bước 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 làm đối tượng Thời gian. |
headsign |
Loại:
string Hướng di chuyển trên tuyến đường này, như đượ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 đ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 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, chẳng hạn như để xác định số hiệu tàu cho các chuyến đi bằng phương tiện công cộng. Văn bản này xác định riêng một chuyến đi trong một ngày bảo dưỡng. |
Giao diện TransitStop
Giao diện google.maps.TransitStop
Thông tin chi tiết về trạm dừng hoặc trạm 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 trạ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 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 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 được sử dụng trong bảng hiệu cho đường phương tiện này, được biểu thị dưới dạng chuỗi hex. |
icon |
Loại:
string URL của biểu tượng được 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 dòng 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 được sử dụng trong bảng hiệu cho đường phương tiện này, được biểu thị dưới dạng chuỗi hex. |
url |
Loại:
string URL của đại lý dành riêng cho dòng 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 TransitAgent
Giao diện google.maps.TransitAgency
Thông tin về đại lý vận hành một 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 đại lý phương tiện công cộng. |
Giao diện TransitXe
Giao diện google.maps.TransitVehicle
Thông tin về xe hoạt động trên tuyến phương tiện công cộng.
Thuộc tính | |
---|---|
icon |
Loại:
string URL cho biểu tượng tương ứng với loại xe được sử dụng trên dòng này. |
local_icon |
Loại:
string URL cho 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 cho loại phương tiện công cộng này, ví dụ: "Train" hoặc "Bus". |
type |
Loại:
VehicleType Loại phương tiện được sử dụng (ví dụ: xe lửa, xe buýt hoặc phà). |
Hằng số XeType
Hằng số google.maps.VehicleType
Các giá trị có thể áp dụng 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 Maps JavaScript API.
Các hằng số | |
---|---|
BUS |
Xe buýt. |
CABLE_CAR |
Xe hoạt động bằng cáp, thường là trên mặt đất. Cáp treo trên không có thể thuộc loại GONDOLA_LIFT . |
COMMUTER_TRAIN |
Tuyến đường đi làm. |
FERRY |
Chuyến phà. |
FUNICULAR |
Một phương tiện được kéo lên bằng dốc bằng cáp. |
GONDOLA_LIFT |
Cáp treo. |
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 điện một ray. |
OTHER |
Phương tiện khác. |
RAIL |
Đường sắt. |
SHARE_TAXI |
Taxi đi chung là một loại phương tiện xe buýt có khả năng trả khách và đón khách ở bất cứ đâu trên tuyến đường. Xe buýt nhỏ thường đi chung xe buýt. |
SUBWAY |
Tàu điện ngầm. |
TRAM |
Dải đèn đường 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 phần Thư viện trong Maps JavaScript API.
Các hằng số | |
---|---|
IMPERIAL |
Chỉ định rằng khoảng cách trong DirectionsResult phải được biểu thị bằng đơn vị hệ Anh. |
METRIC |
Chỉ định các khoảng cách trong DirectionsResult phải được thể hiện bằng đơn vị chỉ số. |
Giao diện 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ị.
Thuộc tính | |
---|---|
text |
Loại:
string Biểu thị chuỗi của 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ị.
Thuộc tính | |
---|---|
text |
Loại:
string Biểu thị chuỗi của 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, chuỗi đã bản địa hoá và múi giờ.
Thuộc tính | |
---|---|
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 điểm dừng phương tiện. |
time_zone |
Loại:
string Múi giờ mà điểm dừng này nằm. 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_York". |
value |
Loại:
Date Thời gian xuất phát hoặc đến nơi khác, được chỉ định là đố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