Directions

Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.

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.

Khi sử dụng v=beta, bạn có thể truy cập vào bằng cách gọi const {DirectionsService} = await google.map.importLibrary("routes"). Xem phần Thư viện trong Maps JavaScript API.

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.
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.

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ó travelModeDRIVING. Đố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.

Khi sử dụng v=beta, bạn có thể truy cập vào bằng cách gọi const {DirectionsStatus} = await google.map.importLibrary("routes"). Xem phần Thư viện trong Maps JavaScript API.

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.

routes
Một mảng DirectionsRoutes, 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
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.

Khi sử dụng v=beta, bạn có thể truy cập vào bằng cách gọi const {DirectionsRenderer} = await google.map.importLibrary("routes"). Xem phần Thư viện trong Maps JavaScript API.

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).
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>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ố:
  • routeIndexnumber
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
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.

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.

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.

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.

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
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
Loại: Array<LatLng>
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.

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
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.
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 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 via_waypoints trong các tuyến đường thay thế.

Khi sử dụng Dịch vụ chỉ đường để triển khai chỉ đường có thể kéo, bạn nên tắt tính năng kéo các tuyến đường thay thế. 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.

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.
end_point
Loại: LatLng
Vị trí kết thúc của bước này.
instructions
Loại: string
Hướng dẫn cho bước này.
lat_lngs
Loại: Array<LatLng>
Một chuỗi LatLng mô tả 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
Loại: Array<LatLng>
Một chuỗi LatLng mô tả quá trình của bước này. Đây là đường dẫn gần đúng (được làm mượt) của bước.
start_location
Loại: LatLng
Vị trí bắt đầu của bước này.
start_point
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.
polyline optional
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.

points
Loại: string

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.

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ả placeIdquery 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.

Khi sử dụng v=beta, bạn có thể truy cập vào bằng cách gọi const {TravelMode} = await google.map.importLibrary("routes"). Xem phần Thư viện trong Maps JavaScript API.

BICYCLING Chỉ định một yêu cầu chỉ đường đi xe đạp.
DRIVING Chỉ định một yêu cầu chỉ đường lái xe.
TRANSIT Chỉ định một yêu cầu 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.

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.

Khi sử dụng v=beta, bạn có thể truy cập vào bằng cách gọi const {TrafficModel} = await google.map.importLibrary("routes"). Xem phần Thư viện trong Maps JavaScript API.

BEST_GUESS Sử dụng dữ liệu lưu lượng truy cập trong quá khứ để ước tính chính xác 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.

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.

Khi sử dụng v=beta, bạn có thể truy cập vào bằng cách gọi const {TransitMode} = await google.map.importLibrary("routes"). Xem phần Thư viện trong Maps JavaScript API.

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.

Khi sử dụng v=beta, bạn có thể truy cập vào bằng cách gọi const {TransitRoutePreference} = await google.map.importLibrary("routes"). Xem phần Thư viện trong Maps JavaScript API.

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ệ.

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.

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.

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.

agencies
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 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.

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.

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.

Khi sử dụng v=beta, bạn có thể truy cập vào bằng cách gọi const {VehicleType} = await google.map.importLibrary("routes"). Xem phần Thư viện trong Maps JavaScript API.

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.

Khi sử dụng v=beta, bạn có thể truy cập vào bằng cách gọi const {UnitSystem} = await google.map.importLibrary("core"). Xem phần Thư viện trong Maps JavaScript API.

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

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ị.

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ờ.

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