Directions

Lớp DirectionsService

Lớp google.maps.DirectionsService

Dịch vụ điện toán đường đi giữa hai hoặc nhiều địa điểm.

DirectionsService
DirectionsService()
Thông số: Không có
Tạo một bản sao mới của DirectionsService để gửi truy vấn chỉ đường đến các máy chủ của Google.
route
route(request[, callback])
Thông số:
Giá trị trả về: Promise<DirectionsResult>
Đưa ra yêu cầu tìm kiếm chỉ đường.

Giao diện DirectionsRequest

Giao diện google.maps.DirectionsRequest

Một cụm từ tìm kiếm đường đi sẽ được gửi đến DirectionsService.

destination
Loại: string|LatLng|Place|LatLngLiteral
Vị trí xuất hiện. Giá trị này có thể được chỉ định làm một chuỗi được mã hóa địa lý hoặc LatLng hay Place. Bắt buộc.
origin
Loại: string|LatLng|Place|LatLngLiteral
Vị trí gốc. Giá trị này có thể được chỉ định làm một chuỗi được mã hóa địa lý hoặc LatLng hay 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 nếu có thể. Không bắt buộc.
avoidTolls optional
Loại: boolean optional
Nếu true, hãy hướng dẫn Dịch vụ chỉ đường tránh đường có thu phí nếu có thể. Không bắt buộc.
drivingOptions optional
Loại: DrivingOptions optional
Chế độ cài đặt chỉ áp dụng cho các yêu cầu có travelModeDRIVING. Đối tượng này sẽ không ảnh hưởng đến các phương tiện đi lại khác.
Betalanguage 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 các ngôn ngữ được hỗ trợ.
optimizeWaypoints optional
Loại: boolean optional
Nếu bạn đặt thành true, thì DirectionsService sẽ cố gắng sắp xếp lại 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 điểm tối ưu hoá đượ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 độ chệch cho các yêu cầu mã hóa địa lý. Mã vùng chấp nhận một giá trị hai ký tự gồm ccTLD ("miền cấp cao nhất"). Hầu hết các mã ccTLD đều giống với mã ISO 3166-1, 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à pháp nhân "Vương quốc Anh và Bắc Ireland".
transitOptions optional
Loại: TransitOptions optional
Các tùy chọn cài đặt chỉ áp dụng cho những yêu cầu mà travelMode ĐƯỢC CHUYỂN ĐỔ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. Hệ thống tính chỉ đường từ điểm xuất phát đến điểm đến theo từng điểm tham chiếu trong mảng này. Hãy xem hướng dẫn dành cho nhà phát triển để biết số điểm tham chiếu tối đa được phép. Điểm tham quan không được hỗ trợ 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 mà DirectionsService trả về khi hoàn tất lệnh gọi đến route(). Hãy chỉ định các giá trị này theo giá trị hoặc bằng cách sử dụng tên hằng số. Ví dụ: 'OK' hoặc google.maps.DirectionsStatus.OK.

INVALID_REQUEST DirectionsRequest đã cung cấp không hợp lệ.
MAX_WAYPOINTS_EXCEEDED Có quá nhiều DirectionsWaypoint được cung cấp trong DirectionsRequest. Hãy xem hướng dẫn dành cho nhà phát triển để biết số điểm tham chiếu tối đa được phép.
NOT_FOUND Không thể mã hóa được ít nhất một trong các điểm xuất phát, điểm đến hoặc điểm tham chiếu.
OK Phản hồi chứa DirectionsResult hợp lệ.
OVER_QUERY_LIMIT Trang web đã vượt quá giới hạn yêu cầu trong một khoảng thời gian quá ngắn.
REQUEST_DENIED Trang web này không được phép sử dụng dịch vụ chỉ đường.
UNKNOWN_ERROR Không thể xử lý yêu cầu chỉ đường do lỗi máy chủ. Yêu cầu có thể thành công nếu bạn thử lại.
ZERO_RESULTS Không tìm thấy tuyến đường nào giữa điểm khởi hành và điểm đến.

Giao diện DirectionsResult

Giao diện google.maps.DirectionsResult

Phản hồi 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ị. Bạn phải hiển thị cảnh báo và bản quyền như đã nêu trong Điều khoản dịch vụ của Nền tảng Google Maps. Xin lưu ý rằng mặc dù kết quả này chỉ có dạng "JSON,&&t; không phải là nghiêm ngặt JSON, vì kết quả này gián tiếp bao gồm các đối tượng LatLng.

routes
Một mảng DirectionsRoute, mỗi mảng chứa thông tin về các chân và bước được tạo. Sẽ chỉ có một tuyến đường trừ khi DirectionsRequest được tạo bằng provideRouteAlternatives được đặt thành true.
available_travel_modes optional
Loại: Array<TravelMode> optional
Chứa một loạt các chế độ đi lại có sẵn. Trường này được trả về khi một yêu cầu chỉ định một phương tiện đi lại và không nhận được kết quả nào. Mảng này chứa các chế độ đi lại có sẵn ở các quốc gia của một nhóm điểm tham chiếu nhất định. Trường này không được trả về nếu một hoặc nhiều điểm tham chiếu là & # 39; qua điểm tham chiếu\39;.
geocoded_waypoints optional
Một mảng DirectionsGeocodedWaypoint, mỗi lớp chứa thông tin về mã hoá địa lý của điểm xuất phát, điểm đến và điểm tham chiếu.

Lớp DirectionsRenderer

Lớp google.maps.DirectionsRenderer

Hiển thị chỉ đường nhận được từ DirectionsService.

Lớp này mở rộng MVCObject.

DirectionsRenderer
DirectionsRenderer([opts])
Thông số:
Tạo trình kết xuất bằng các tùy chọn nhất định. Thông tin chỉ đường có thể được hiển thị trên bản đồ (dưới dạng lớp phủ hình ảnh) hoặc bổ sung 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 lệnh chỉ đườ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 xuất hiện.
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 (không có giá trị) 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 đặt một tập hợp các hướng dẫn hợp lệ theo cách này sẽ hiển thị chỉ đường trên bản đồ và bảng điều khiển đã được chỉ định của trình kết xuất.
setMap
setMap(map)
Thông số:
Giá trị trả về: Không có
Phương thức này chỉ định bản đồ mà chỉ đường sẽ được hiển thị trên đó. Đ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 về 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ị thông tin đường đi trong một <div>. Chuyể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 để kết xuất. Theo mặc định, tuyến đường đầ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 chỉ đường hiển thị thay đổi, khi DirectionsResult mới được đặt hoặc khi người dùng kéo xong một 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 được trên đối tượng DirectionsRenderer.

directions optional
Loại: DirectionsResult optional
Đường đi để hiển thị trên bản đồ và/hoặc trong bảng điều khiển <div> được truy xuất dưới dạng đối tượng DirectionsResult từ DirectionsService.
draggable 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 được 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 các tuyến đường mà người dùng có thể chọn trong bảng điều hướng hay không.
infoWindow optional
Loại: InfoWindow optional
InfoWindow để kết xuất 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 hiện có trên cửa sổ thông tin sẽ bị ghi đè và vị trí của nội dung đó đã được di chuyển. Nếu 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 của riêng mình. 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 đồ mà bạn muốn hiển thị thông tin đường đi.
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 tùy chọn này.
panel optional
Loại: HTMLElement optional
<div> mà để hiển thị các bước chỉ đường.
polylineOptions optional
Loại: PolylineOptions optional
Các tùy 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 tuỳ chọn này được đặt thành true hoặc trung tâm của bản đồ và thu phóng chưa bao giờ được thiết lập, 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 chỉ đường 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
Chặn việc hiển thị BicyclingLayer khi có yêu cầu chỉ đường đi xe đạp.
suppressInfoWindows optional
Loại: boolean optional
Chặn việc hiển thị cửa sổ thông tin.
suppressMarkers optional
Loại: boolean optional
Chặn việc hiển thị điểm đánh dấu.
suppressPolylines optional
Loại: boolean optional
Chặn việc 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 xuất phát và điểm đến mà chuyến đi sẽ được định tuyến.

location optional
Loại: string|LatLng|Place optional
Vị trí điểm tham chiếu. Có thể là một chuỗi địa chỉ, một LatLng hoặc một 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 gốc và điểm đến. Cách này có tác dụng chia đôi 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 tách thành hai chân. Điều này rất hữu ích nếu bạn muốn tạo một tuyến đường để phản hồi các điểm tham chiếu kéo người dùng trên một bản đồ.

Giao diện DirectionsGeocodedWaypoint

Giao diện google.maps.DirectionsGeocodedWaypoint

Một điểm tham chiếu đã mã hoá đơn.

partial_match optional
Loại: boolean optional
Bộ mã hóa địa lý có trả về thông tin so khớp chính xác cho điểm tham chiếu ban đầu hay không, mặc dù mã này có thể so khớp với 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 giúp xác định duy nhất 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ử đã mã hóa đã trả về. Để biết danh sách các chuỗi có thể xảy ra, hãy tham khảo phần Loại thành phần địa chỉ trong Hướng dẫn dành cho nhà phát triển.

Giao diện DirectionsRoute

Giao diện google.maps.DirectionsRoute

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

end_address
Loại: string
Địa chỉ đích đến của chân này. Nội dung này được đọc nguyên trạng. Đừng phân tích đị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 tuỳ chọn giao thông gần nhất (thường là một con đường) tại vị trí bắt đầu và kết thúc. end_location cho biết đích đến đã mã hoá thực tế, có thể khác với end_location của bước cuối cùng, chẳng hạn như đường không gần đích đến của chân này.
start_address
Loại: string
Địa chỉ gốc của chân này. Nội dung này được đọc nguyên trạng. Đừng phân tích đị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 tuỳ chọn giao thông gần nhất (thường là một con đường) tại vị trí bắt đầu và kết thúc. start_location cho biết nguồn gốc đã mã hoá thực tế, 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 bước chứa thông tin về từng bước trong chân này.
traffic_speed_entry
Loại: Array<?>
Thông tin về tốc độ giao thông dọc chân.
via_waypoints
Loại: Array<LatLng>
Một mảng điểm tham chiếu 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 đường thay thế. Phiên bản 3.27 sẽ là phiên bản cuối cùng của API bổ sung via_waypoints bổ sung trong các tuyến thay thế.

Khi sử dụng Dịch vụ chỉ đường để triển khai tính năng kéo có thể kéo, bạn nên tắt tính năng kéo các tuyến đường thay thế. Chỉ có thể kéo tuyến đường chính. Người dùng có thể kéo tuyến đường chính cho đến khi tuyến đường đó khớp với một tuyến đường thay thế.

arrival_time optional
Loại: Time optional
Thời gian đến dự kiến cho chân này. Chỉ áp dụng cho các yêu cầu ĐI LẠI.
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 ĐI LẠI.
distance optional
Loại: Distance optional
Tổng quãng đường mà chân này che phủ. Có thể bạn không xác định được thuộc tính này vì khoảng cách có thể chưa được xác định.
duration optional
Loại: Duration optional
Tổng thời lượng của chân này. Thuộc tính này có thể là undefined vì không xác định được thời lượng.
duration_in_traffic optional
Loại: Duration optional
Tổng thời lượng của chân này, có tính đến các điều kiện lưu lượng truy cập được chỉ định bởi thuộc tính trafficModel. Thuộc tính này có thể là undefined vì không xác định được thời lượng.

Giao diện DirectionsStep

Giao diện google.maps.DirectionsStep

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

encoded_lat_lngs
Loại: string
Bản trình bày nhiều đường đã mã hoá của bước. Đây là đường dẫn gần đúng (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>
Trình tự LatLng mô tả quy trình của bước này. Đây là đường dẫn gần đúng (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à các 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>
Trình tự LatLng mô tả quy trình của bước này. Đây là đường dẫn gần đúng (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 được sử dụng trong bước này.
distance optional
Loại: Distance optional
Quãng đường được thực hiện ở 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 để 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ì không xác định được thời lượng.
polyline optional
Loại: Array<DirectionsStep> optional
Chứa một đối tượng có một thuộc tính duy nhất, 'points#39;, chứa một đại diện đa đường đã mã hoá của bước. Hình nhiều đường này là một đường dẫn gần đú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 mục không quá cảnh 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 về bước này cho phương tiện công cộng. Thuộc tính này sẽ không xác định trừ phi 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 chế độ đi lại là TRANSIT.

Giao diện DirectionsPolyline

Giao diện google.maps.DirectionsPolyline

Một đối tượng chứa một thuộc tính points để mô tả đa giác của một DirectionsStep.

points
Loại: string

Giao diện Place

Giao diện google.maps.Place

Chứa thông tin cần thiết để tìm, xác định hoặc mô tả địa điểm cho DirectionsRequest hoặc DistanceMatrixRequest. Trong ngữ cảnh này, "địa điểm" có nghĩa là một doanh nghiệp, địa điểm yêu thích hoặc vị trí địa lý. Để tìm nạp thông tin về một địa điểm, hãy xem PlacesService.

location optional
Loại: LatLng|LatLngLiteral optional
LatLng của thực thể mà địa điểm này mô tả.
placeId optional
Loại: string optional
Mã địa điểm của địa điểm (chẳng hạn như một 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 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 tới 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 tới API mã hóa địa lý. Để biết thêm thông tin, hãy xem nội dung tổng quan về mã địa điểm.
query optional
Loại: string optional
Một 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). Truy vấn ví dụ là "Quay, Cấp trên, Nhà ga hành khách nước ngoài số 5 Đường Hickson, The Rocks NSW" Nếu có thể, bạn nên chỉ định placeId thay vì query. API không đảm bảo độ chính xác của việc phân giải chuỗi truy vấn 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

Những phương tiện đi lại hợp lệ có thể được chỉ định trong DirectionsRequest cũng như các phương tiện đi lại được trả về trong DirectionsStep. Hãy chỉ định các giá trị này theo giá trị hoặc bằng cách sử dụng tên hằng số. Ví dụ: 'BICYCLING' hoặc google.maps.TravelMode.BICYCLING.

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 Xác định yêu cầu chỉ đường phương tiện công cộng.
WALKING Chỉ định yêu cầu chỉ đường đi bộ.

Giao diện 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 của chặng bay, được chỉ định là một đố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. Điều này phải được chỉ định để DrivingOptions hợp lệ. Thời gian khởi hành phải được đặt thành thời gian hiện tại hoặc 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 ưa thích để sử dụng khi dự đoán thời lượng trong lưu lượng truy cập. Mặc định là BEST_GUESS.

Hằng số TrafficModel

Hằng số google.maps.TrafficModel

Các giả định được sử dụng khi dự đoán thời lượng trong lưu lượng truy cập. Được chỉ định như một phần của DirectionsRequest hoặc DistanceMatrixRequest. Hãy chỉ định các giá trị này theo giá trị hoặc bằng cách sử dụng tên hằng số. Ví dụ: 'bestguess' hoặc google.maps.TrafficModel.BEST_GUESS.

BEST_GUESS Sử dụng dữ liệu lưu lượng truy cập trong quá khứ để ước tính tốt nhất 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 lạc quan về thời lượng của lưu lượng truy cập.
PESSIMISTIC Sử dụng dữ liệu lưu lượng truy cập trong quá khứ để ước tính chi tiết về thời lượng của 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 trong DirectionsRequest khi chế độ đi lại được đặt thành TRIP.

arrivalTime optional
Loại: Date optional
Thời gian đến mong muốn cho tuyến đường, được chỉ định dưới dạng đối tượng Ngày. Đối tượng Ngày đo 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 của tuyến đường, được chỉ định dưới dạng đối tượng Ngày. Đố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 không chỉ định thời gian khởi hành và thời gian đến, thì thời gian dự kiến sẽ là "now"
modes optional
Loại: Array<TransitMode> optional
Một hoặc nhiều phương tiện giao thông ưu tiên, chẳng hạn như xe buýt hoặc tàu hoả. Nếu không có tùy chọn nào được cung cấp, API sẽ trả về tuyến đường tốt nhất mặc định.
routingPreference optional
Loại: TransitRoutePreference optional
Một lựa chọn ưu tiên có thể thiên về lựa chọn tuyến đường của phương tiện, chẳng hạn như ít đi bộ hơn. Nếu không có tùy chọn nào được cung cấp, 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ệ, chẳng hạn như xe buýt có thể được chỉ định trong TransitOptions. Hãy chỉ định các giá trị này theo giá trị hoặc bằng cách sử dụng tên hằng số. Ví dụ: 'BUS' hoặc google.maps.TransitMode.BUS.

BUS Chỉ định xe buýt làm phương tiện công cộng ưa thích.
RAIL Chỉ định đường ray làm phương thức di chuyển ưa thích.
SUBWAY Chỉ định tàu điện ngầm làm phương thức di chuyển ưa thích.
TRAIN Chỉ định tàu hỏa làm phương tiện công cộng ưu tiên.
TRAM Chỉ định xe điện làm phương thức di chuyển ưa thích.

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. Hãy chỉ định các giá trị này theo giá trị hoặc bằng cách sử dụng tên hằng số. Ví dụ: 'LESS_WALKING' hoặc google.maps.TransitRoutePreference.LESS_WALKING.

FEWER_TRANSFERS Xác định tuyến đường được tính toán phải có số lần chuyển số lượng hạn chế.
LESS_WALKING Xác định rằng tuyến đường được tính toán sẽ ưu tiên số lượng đi bộ có giới hạn.

Giao diện TransitionFare

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é.
value
Loại: number
Giá trị số của giá vé, được thể hiện bằng currency nhất định.

Giao diện TransitionDetails

Giao diện google.maps.TransitDetails

Thông tin chi tiết về chuyến khởi hành, thời gian đến và phương thức di chuyển đượ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 này.
arrival_time
Loại: Time
Thời gian đến của bước này, được chỉ định làm đối tượng Thời gian.
departure_stop
Loại: TransitStop
Điểm dừng khởi hành của bước đi phương tiện công cộng này.
departure_time
Loại: Time
Thời gian khởi hành của bước này, được xác định là một đố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 ở bước này. Bao gồm điểm đến, nhưng không phải điểm dừng khởi hành.
trip_short_name
Loại: string
Văn bản xuất hiện trong lịch biểu 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 đi bằng phương tiện công cộng. Phần văn bản xác định duy nhất một chuyến đi trong ngày phục vụ.

Giao diện TransitionStop

Giao diện google.maps.TransitStop

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

Giao diện TransitionLine

Giao diện google.maps.TransitLine

Thông tin về tuyến phương tiện công cộng thực hiện 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 dùng trong bảng hiệu cho đường chuyển tuyế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 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 bảng tín hiệu cho đường chuyển tuyến này, được biểu thị dưới dạng một chuỗi hex.
url
Loại: string
URL của đại lý có liên quan đến đường chuyển tuyến 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 của TransitAgent

Giao diện google.maps.TransitAgency

Thông tin về một đại lý điều hành 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 TransitionXe

Giao diện google.maps.TransitVehicle

Thông tin về xe vận hành trên tuyến phương tiện công cộng.

icon
Loại: string
URL của biểu tượng tương ứng với loại xe sử dụng trên dòng này.
local_icon
Loại: string
URL của biểu tượng tương ứng với loại xe dùng trong khu vực này thay vì biểu tượng chung 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

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

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

Hằng số UnitSystem

Hằng số google.maps.UnitSystem

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

IMPERIAL Chỉ định rằng khoảng cách trong DirectionsResult sẽ được biểu thị bằng đơn vị hệ Anh.
METRIC Chỉ định rằng khoảng cách trong DirectionsResult sẽ được biểu thị 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 duration

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 Time

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
Chuỗi thể hiện giá trị thời gian. Thời gian được hiển thị theo múi giờ của điểm dừng phương tiện công cộng.
time_zone
Loại: string
Múi giờ 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 của giờ khởi hành hoặc thời gian đến này, được chỉ định làm đố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