Chỉ mục
RoutesPreferred
(giao diện)ComputeCustomRoutesRequest
(thông báo)ComputeCustomRoutesResponse
(thông báo)ComputeCustomRoutesResponse.FallbackInfo
(thông báo)ComputeCustomRoutesResponse.FallbackInfo.FallbackRouteObjective
(enum)ComputeRouteMatrixRequest
(thông báo)ComputeRoutesRequest
(thông báo)ComputeRoutesResponse
(thông báo)CustomRoute
(thông báo)FallbackInfo
(thông báo)FallbackReason
(enum)FallbackRoutingMode
(enum)Location
(thông báo)Maneuver
(enum)NavigationInstruction
(thông báo)Polyline
(thông báo)PolylineEncoding
(enum)PolylineQuality
(enum)Route
(thông báo)RouteLeg
(thông báo)RouteLegStep
(thông báo)RouteLegStepTravelAdvisory
(thông báo)RouteLegTravelAdvisory
(thông báo)RouteMatrixDestination
(thông báo)RouteMatrixElement
(thông báo)RouteMatrixElementCondition
(enum)RouteMatrixOrigin
(thông báo)RouteModifiers
(thông báo)RouteObjective
(thông báo)RouteObjective.RateCard
(thông báo)RouteObjective.RateCard.MonetaryCost
(thông báo)RouteTravelAdvisory
(thông báo)RouteTravelMode
(enum)RoutingPreference
(enum)SpeedReadingInterval
(thông báo)SpeedReadingInterval.Speed
(enum)TollInfo
(thông báo)TollPass
(enum)Units
(enum)VehicleEmissionType
(enum)VehicleInfo
(thông báo)Waypoint
(thông báo)
RoutesPreferred
API Ưu tiên về tuyến đường.
ComputeCustomRoutes |
---|
Cho một tập hợp các điểm cuối và trung gian, cùng với một mục tiêu tuyến, sẽ tính toán tuyến tốt nhất cho mục tiêu tuyến. Đồng thời trả về tuyến nhanh nhất và tuyến đường ngắn nhất làm tuyến tham chiếu. LƯU Ý: Phương thức này yêu cầu bạn chỉ định mặt nạ trường phản hồi trong dữ liệu đầu vào. Bạn có thể cung cấp mặt nạ cho trường (field mask) của phản hồi bằng cách dùng tham số URL Ví dụ: trong phương thức này:
Google không khuyến khích việc sử dụng mặt nạ cho trường (field mask) của phản hồi ký tự đại diện (
|
ComputeRouteMatrix |
---|
Lấy danh sách các nguồn gốc và đích đến rồi trả về một luồng chứa thông tin tuyến đường cho mỗi tổ hợp điểm xuất phát và đích đến. LƯU Ý: Phương thức này yêu cầu bạn chỉ định mặt nạ trường phản hồi trong dữ liệu đầu vào. Bạn có thể cung cấp mặt nạ cho trường (field mask) của phản hồi bằng cách dùng tham số URL Ví dụ: trong phương thức này:
Điều quan trọng là bạn phải đưa
|
ComputeRoutes |
---|
Trả về tuyến chính cùng với các tuyến thay thế tuỳ chọn, dựa trên một tập hợp các điểm cuối và điểm tham chiếu trung gian. LƯU Ý: Phương thức này yêu cầu bạn chỉ định mặt nạ trường phản hồi trong dữ liệu đầu vào. Bạn có thể cung cấp mặt nạ trường phản hồi bằng cách dùng tham số URL Ví dụ: trong phương thức này:
Google không khuyến khích việc sử dụng mặt nạ cho trường (field mask) của phản hồi ký tự đại diện (
|
ComputeCustomRoutesRequest
Thông báo yêu cầu ComputeCustomRoutes.
Các trường | |
---|---|
origin |
Bắt buộc. Điểm tham chiếu gốc. |
destination |
Bắt buộc. Điểm tham chiếu đích. |
intermediates[] |
Không bắt buộc. Một tập hợp các điểm tham chiếu dọc theo tuyến đường (không bao gồm các điểm cuối), để dừng tại hoặc đi qua. Hỗ trợ tối đa 25 điểm tham chiếu trung gian. |
travel_mode |
Không bắt buộc. Nêu rõ phương thức di chuyển. Hiện chỉ hỗ trợ DRIVE. |
routing_preference |
Không bắt buộc. Chỉ định cách tính toán tuyến đường. Máy chủ cố gắng sử dụng tuỳ chọn định tuyến đã chọn để tính toán tuyến đường. Nếu tuỳ chọn định tuyến dẫn đến lỗi hoặc độ trễ thêm lâu, thì lỗi sẽ được trả về. Trong tương lai, chúng tôi có thể triển khai cơ chế dự phòng để sử dụng một tuỳ chọn khác khi lựa chọn ưu tiên không cung cấp kết quả hợp lệ. Bạn chỉ có thể chỉ định tuỳ chọn này khi |
polyline_quality |
Không bắt buộc. Chỉ định tuỳ chọn của bạn về chất lượng của hình nhiều đường. |
polyline_encoding |
Không bắt buộc. Chỉ định phương thức mã hoá ưu tiên cho hình nhiều đường. |
departure_time |
Không bắt buộc. Thời gian khởi hành. Nếu bạn không đặt giá trị này thì giá trị này sẽ mặc định là thời gian mà bạn thực hiện yêu cầu. Nếu bạn đặt giá trị này thành một thời điểm đã xảy ra, thì yêu cầu sẽ không thành công. |
route_modifiers |
Không bắt buộc. Một tập hợp các điều kiện cần đáp ứng sẽ ảnh hưởng đến cách tính toán các tuyến đường. |
route_objective |
Bắt buộc. Mục tiêu định tuyến để tối ưu hoá. |
language_code |
Không bắt buộc. Mã ngôn ngữ BCP-47, chẳng hạn như "en-US" hoặc "sr-Latn". Để biết thêm thông tin, hãy xem http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. Xem Hỗ trợ ngôn ngữ để biết danh sách các ngôn ngữ được hỗ trợ. Khi bạn không cung cấp giá trị này, ngôn ngữ hiển thị sẽ được suy ra từ vị trí của yêu cầu tuyến đường. |
units |
Không bắt buộc. Chỉ định đơn vị đo lường cho các trường hiển thị. Điều này bao gồm trường |
ComputeCustomRoutesResponse
Thông báo phản hồi ComputeCustomRoutes.
Các trường | |
---|---|
routes[] |
Tuyến "tốt nhất" cho mục tiêu tuyến đầu vào. |
fastest_route |
Tuyến đường tham khảo nhanh nhất. |
shortest_route |
Lộ trình tham chiếu ngắn nhất. |
fallback_info |
Thông tin dự phòng cho các tuyến tuỳ chỉnh. |
FallbackInfo
Đóng gói thông tin dự phòng cho ComputeCustomRoutes. ComputeCustomRoutes thực hiện hai loại dự phòng:
Nếu không thể tính toán tuyến đường bằng cách sử dụng yếu tố định tuyến mà khách hàng yêu cầu, thì máy tính sẽ chuyển sang chế độ định tuyến khác. Trong trường hợp này, fallback_routing_mode vàroute_mode_fallback_reason dùng để thông báo về chế độ định tuyến dự phòng đã dùng, cũng như lý do dự phòng.
Nếu không thể tính toán tuyến "tốt nhất" cho mục tiêu tuyến do khách hàng chỉ định, thì có thể phương án dự phòng sẽ là một mục tiêu khác. fallback_route_objective được dùng để truyền đạt mục tiêu tuyến dự phòng.
Các trường | |
---|---|
routing_mode |
Chế độ định tuyến dùng cho phản hồi. Nếu dự phòng được kích hoạt, chế độ này có thể khác với lựa chọn ưu tiên định tuyến đã đặt trong yêu cầu máy khách ban đầu. |
routing_mode_reason |
Lý do sử dụng câu trả lời dự phòng thay cho câu trả lời ban đầu. Trường này chỉ được điền khi chế độ dự phòng được kích hoạt và phản hồi dự phòng được trả về. |
route_objective |
Mục tiêu định tuyến dùng cho phản hồi. Nếu tính năng dự phòng được kích hoạt, thì mục tiêu có thể khác với mục tiêu định tuyến đã cung cấp trong yêu cầu ứng dụng ban đầu. |
FallbackRouteObjective
NavigationObjective được dùng cho phản hồi.
Enum | |
---|---|
FALLBACK_ROUTE_OBJECTIVE_UNSPECIFIED |
Chưa xác định mục tiêu định tuyến dự phòng. |
FALLBACK_RATECARD_WITHOUT_TOLL_PRICE_DATA |
Nếu khách hàng yêu cầu RateCard (Thẻ giá) và đặt include_tolls thành true (đúng) và Google không có dữ liệu về giá cầu đường cho chặng bay này, thì API sẽ quay lại RateCard mà không xem xét đến giá cầu đường. |
ComputeRouteMatrixRequest
Thông báo yêu cầu ComputeRouteMatrix
Các trường | |
---|---|
origins[] |
Bắt buộc. Mảng nguồn gốc xác định các hàng của ma trận phản hồi. Một số quy định hạn chế về kích thước áp dụng cho số lượng giá trị riêng biệt của các nguồn gốc và đích đến:
|
destinations[] |
Bắt buộc. Mảng các đích đến giúp xác định các cột của ma trận phản hồi. |
travel_mode |
Không bắt buộc. Nêu rõ phương thức di chuyển. |
routing_preference |
Không bắt buộc. Chỉ định cách tính toán tuyến đường. Máy chủ cố gắng sử dụng tuỳ chọn định tuyến đã chọn để tính toán tuyến đường. Nếu tuỳ chọn định tuyến dẫn đến lỗi hoặc độ trễ thêm lâu, lỗi sẽ được trả về. Trong tương lai, chúng tôi có thể triển khai cơ chế dự phòng để sử dụng một tuỳ chọn khác khi lựa chọn ưu tiên không cung cấp kết quả hợp lệ. Bạn chỉ có thể chỉ định tuỳ chọn này khi |
departure_time |
Không bắt buộc. Thời gian khởi hành. Nếu bạn không đặt giá trị này thì giá trị mặc định sẽ là thời gian bạn đưa ra yêu cầu. Nếu bạn đặt giá trị này thành một thời điểm đã xảy ra, thì yêu cầu sẽ không thành công. |
ComputeRoutesRequest
Thông báo yêu cầu ComputeRoutes.
Các trường | |
---|---|
origin |
Bắt buộc. Điểm tham chiếu gốc. |
destination |
Bắt buộc. Điểm tham chiếu đích. |
intermediates[] |
Không bắt buộc. Một tập hợp các điểm tham chiếu dọc theo tuyến đường (không bao gồm các điểm cuối), để dừng tại hoặc đi qua. Hỗ trợ tối đa 25 điểm tham chiếu trung gian. |
travel_mode |
Không bắt buộc. Nêu rõ phương thức di chuyển. |
routing_preference |
Không bắt buộc. Chỉ định cách tính toán tuyến đường. Máy chủ cố gắng sử dụng tuỳ chọn định tuyến đã chọn để tính toán tuyến đường. Nếu tuỳ chọn định tuyến dẫn đến lỗi hoặc độ trễ thêm lâu, thì lỗi sẽ được trả về. Trong tương lai, chúng tôi có thể triển khai cơ chế dự phòng để sử dụng một tuỳ chọn khác khi lựa chọn ưu tiên không cung cấp kết quả hợp lệ. Bạn chỉ có thể chỉ định tuỳ chọn này khi |
polyline_quality |
Không bắt buộc. Chỉ định tuỳ chọn của bạn về chất lượng của hình nhiều đường. |
polyline_encoding |
Không bắt buộc. Chỉ định phương thức mã hoá ưu tiên cho hình nhiều đường. |
departure_time |
Không bắt buộc. Thời gian khởi hành. Nếu bạn không đặt giá trị này thì giá trị này sẽ mặc định là thời gian mà bạn thực hiện yêu cầu. Nếu bạn đặt giá trị này thành một thời điểm đã xảy ra, thì yêu cầu sẽ không thành công. |
compute_alternative_routes |
Chỉ định xem có tính toán các tuyến đường thay thế ngoài tuyến đường hay không. |
route_modifiers |
Không bắt buộc. Một tập hợp các điều kiện cần đáp ứng sẽ ảnh hưởng đến cách tính toán các tuyến đường. |
language_code |
Không bắt buộc. Mã ngôn ngữ BCP-47, chẳng hạn như "en-US" hoặc "sr-Latn". Để biết thêm thông tin, hãy xem http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. Xem Hỗ trợ ngôn ngữ để biết danh sách các ngôn ngữ được hỗ trợ. Khi bạn không cung cấp giá trị này, ngôn ngữ hiển thị sẽ được suy ra từ vị trí của yêu cầu tuyến đường. |
units |
Không bắt buộc. Chỉ định đơn vị đo lường cho các trường hiển thị. Điều này bao gồm trường |
optimize_waypoint_order |
Nếu OptimizeWaypointOrder được đặt thành true, hệ thống sẽ cố gắng sắp xếp lại các điểm tham chiếu trung gian được chỉ định để giảm thiểu tổng chi phí của tuyến. Nếu bất kỳ điểm tham chiếu trung gian nào là thông qua điểm tham chiếu, thì yêu cầu sẽ không thành công. Sử dụng ComputeRoutesResponse.Routes.Optimized_intermediate_waypoint_index để tìm thứ tự mới. Nếu không có yêu cầu route.optimize_intermediate_waypoint_index trong tiêu đề |
ComputeRoutesResponse
ComputeRoutes thông báo phản hồi.
Các trường | |
---|---|
routes[] |
Chứa một mảng các tuyến được tính (tối đa 3 tuyến) khi bạn chỉ định Compute_alternatives_routes và chỉ chứa một tuyến khi bạn không chỉ định. Khi mảng này chứa nhiều mục nhập, tuyến đầu tiên là tuyến nên dùng nhất. Nếu mảng trống thì tức là không thể tìm thấy tuyến nào. |
fallback_info |
Trong một số trường hợp khi không thể tính toán kết quả tuyến với tất cả các tuỳ chọn đầu vào, máy chủ có thể dự phòng sang một cách tính toán khác. Khi sử dụng chế độ dự phòng, trường này chứa thông tin chi tiết về phản hồi dự phòng. Nếu không, trường này sẽ không được đặt. |
CustomRoute
Đóng gói một tuyến tuỳ chỉnh được tính toán dựa trên mục tiêu về tuyến do khách hàng chỉ định. Customroute chứa một tuyến và mã thông báo tuyến đường có thể được truyền đến NavSDK để tạo lại tuyến đường tùy chỉnh để điều hướng từng chặng.
Các trường | |
---|---|
route |
Tuyến được xem là "tốt nhất" cho mục tiêu tuyến đầu vào. |
token |
Mã thông báo tuyến đường được mã hoá base64 an toàn trên web có thể được truyền đến NavSDK, cho phép NavSDK tạo lại tuyến trong khi điều hướng và trong trường hợp định tuyến lại theo ý định ban đầu khiroutesPreferences ComputeCustomRoutes được gọi. Khách hàng nên coi mã thông báo này là một khối mờ mờ. |
FallbackInfo
Thông tin liên quan đến cách thức và lý do sử dụng kết quả dự phòng. Nếu bạn đặt trường này, thì điều đó có nghĩa là máy chủ đã sử dụng một chế độ định tuyến khác với chế độ ưu tiên của bạn làm chế độ dự phòng.
Các trường | |
---|---|
routing_mode |
Chế độ định tuyến dùng cho phản hồi. Nếu dự phòng được kích hoạt, chế độ này có thể khác với lựa chọn ưu tiên định tuyến đã đặt trong yêu cầu máy khách ban đầu. |
reason |
Lý do sử dụng câu trả lời dự phòng thay cho câu trả lời ban đầu. Trường này chỉ được điền khi chế độ dự phòng được kích hoạt và phản hồi dự phòng được trả về. |
FallbackReason
Lý do sử dụng phản hồi dự phòng.
Enum | |
---|---|
FALLBACK_REASON_UNSPECIFIED |
Chưa chỉ định lý do dự phòng. |
SERVER_ERROR |
Đã xảy ra lỗi máy chủ trong khi tính toán tuyến đường bằng chế độ định tuyến ưa thích của bạn, nhưng chúng tôi có thể trả về kết quả được tính toán theo chế độ thay thế. |
LATENCY_EXCEEDED |
Chúng tôi không thể hoàn tất việc tính toán bằng chế độ định tuyến mong muốn của bạn đúng thời gian, nhưng chúng tôi có thể trả về kết quả được tính toán bằng chế độ thay thế. |
FallbackRoutingMode
Chế độ định tuyến thực tế dùng cho phản hồi dự phòng được trả về.
Enum | |
---|---|
FALLBACK_ROUTING_MODE_UNSPECIFIED |
Không được sử dụng. |
FALLBACK_TRAFFIC_UNAWARE |
Cho biết chế độ định tuyến "TRAFFIC_UNAWARE" đã được dùng để tính toán phản hồi. |
FALLBACK_TRAFFIC_AWARE |
Cho biết chế độ định tuyến "TRAFFIC_AWARE" đã được dùng để tính toán phản hồi. |
Vị trí
Bao gồm một vị trí (một điểm địa lý và một tiêu đề không bắt buộc).
Các trường | |
---|---|
lat_lng |
Toạ độ địa lý của điểm tham chiếu. |
heading |
Hướng la bàn được liên kết với hướng của luồng giao thông. Giá trị này được dùng để chỉ định phía đường được dùng để đón và trả khách. Giá trị tiêu đề có thể từ 0 đến 360, trong đó 0 chỉ định tiêu đề đến hạn về phía Bắc, 90 chỉ định tiêu đề đến hạn về phía Đông, v.v. Bạn chỉ có thể sử dụng trường này cho phương tiện đi lại |
Thao tác
Một tập hợp các giá trị chỉ định thao tác điều hướng cần thực hiện cho bước hiện tại (ví dụ: rẽ trái, hợp nhất, đi thẳng, v.v.).
Enum | |
---|---|
MANEUVER_UNSPECIFIED |
Không được sử dụng. |
TURN_SLIGHT_LEFT |
Xoay một chút sang trái. |
TURN_SHARP_LEFT |
Xoay mạnh sang trái. |
UTURN_LEFT |
Vòng ngược lại. |
TURN_LEFT |
Quay sang trái. |
TURN_SLIGHT_RIGHT |
Xoay một chút sang phải. |
TURN_SHARP_RIGHT |
Xoay mạnh sang phải. |
UTURN_RIGHT |
Vòng ngược lại. |
TURN_RIGHT |
Quay sang phải. |
STRAIGHT |
Hãy nói thẳng. |
RAMP_LEFT |
Đi theo đoạn đường dốc bên trái. |
RAMP_RIGHT |
Đi vào đoạn đường dốc bên phải. |
MERGE |
Hợp nhất vào lưu lượng truy cập. |
FORK_LEFT |
Đi theo ngã ba bên trái. |
FORK_RIGHT |
Chọn đúng ngã ba. |
FERRY |
Đi phà. |
FERRY_TRAIN |
Đi tàu dẫn lên phà. |
ROUNDABOUT_LEFT |
rẽ trái tại chỗ đường vòng. |
ROUNDABOUT_RIGHT |
rẽ phải tại chỗ đường vòng. |
Hình nhiều đường
Đóng gói một hình nhiều đường đã mã hoá.
Các trường | |
---|---|
Trường nhóm polyline_type . Đóng gói loại hình nhiều đường. Giá trị mặc định là được mã hoá_polyline. polyline_type chỉ có thể là một trong những trạng thái sau đây: |
|
encoded_polyline |
Mã hoá chuỗi của hình nhiều đường bằng thuật toán mã hoá hình nhiều đường |
geo_json_linestring |
Chỉ định một hình nhiều đường bằng định dạng GeoJSON LineString |
PolylineEncoding
Chỉ định loại hình nhiều đường ưu tiên cần được trả về.
Enum | |
---|---|
POLYLINE_ENCODING_UNSPECIFIED |
Chưa chỉ định tùy chọn loại hình nhiều đường. Giá trị mặc định là ENCODED_POLYLINE . |
ENCODED_POLYLINE |
Chỉ định một hình nhiều đường được mã hoá bằng thuật toán mã hoá hình nhiều đường. |
GEO_JSON_LINESTRING |
Chỉ định một hình nhiều đường bằng định dạng GeoJSON LineString |
PolylineQuality
Một tập hợp các giá trị chỉ định chất lượng của hình nhiều đường.
Enum | |
---|---|
POLYLINE_QUALITY_UNSPECIFIED |
Chưa chỉ định lựa chọn ưu tiên về chất lượng hình nhiều đường. Giá trị mặc định là OVERVIEW . |
HIGH_QUALITY |
Chỉ định một hình nhiều đường chất lượng cao (được tạo bằng nhiều điểm hơn OVERVIEW ) nhưng sẽ tăng kích thước phản hồi. Hãy dùng giá trị này khi bạn cần độ chính xác cao hơn. |
OVERVIEW |
Chỉ định một hình nhiều đường tổng quan – được tạo bằng một số lượng nhỏ các điểm. Sử dụng giá trị này khi hiển thị thông tin tổng quan về tuyến đường. Việc sử dụng tuỳ chọn này có độ trễ yêu cầu thấp hơn so với sử dụng tuỳ chọn HIGH_QUALITY . |
Tuyến đường
Bao bọc một tuyến đường, bao gồm một loạt các đoạn đường được kết nối với nhau để kết hợp với các điểm đầu, cuối và trung gian.
Các trường | |
---|---|
legs[] |
Một tập hợp các chân (đoạn đường dẫn giữa các điểm tham chiếu) tạo nên tuyến đường. Mỗi chân tương ứng với chuyến đi giữa hai Điểm tham chiếu không phải |
distance_meters |
Khoảng cách đi được của tuyến đường, tính bằng mét. |
duration |
Khoảng thời gian cần thiết để điều hướng tuyến đường. Nếu bạn thiết lập |
static_duration |
Thời gian đi qua tuyến đường mà không tính đến tình trạng giao thông. |
polyline |
Hình nhiều đường tổng thể của tuyến đường. Hình nhiều đường này sẽ là hình nhiều đường tổng hợp của tất cả |
description |
Nội dung mô tả về tuyến đường. |
warnings[] |
Một mảng cảnh báo sẽ xuất hiện khi hiển thị tuyến đường. |
viewport |
Hộp giới hạn khung nhìn của hình nhiều đường. |
travel_advisory |
Thông tin bổ sung về tuyến đường. |
optimized_intermediate_waypoint_index[] |
Nếu ComputeRoutesRequest.optimize_waypoint_order được đặt thành true, trường này sẽ chứa thứ tự được tối ưu hoá của điểm tham chiếu trung gian. Nếu không, trường này sẽ trống. Ví dụ: giả sử dữ liệu đầu vào là Xuất xứ: LA; Trung cấp: Dallas, Bangor, Phoenix; Điểm đến: New York; và thứ tự điểm tham chiếu trung gian được tối ưu hoá là: Phoenix, Dallas, Bangor. Khi đó trường này chứa các giá trị [2, 0, 1]. Chỉ mục bắt đầu bằng 0 cho điểm tham chiếu trung gian đầu tiên. |
RouteLeg
Đóng gói một phân đoạn giữa các điểm tham chiếu không phải via
.
Các trường | |
---|---|
distance_meters |
Quãng đường đi được của chân tuyến đường, tính bằng mét. |
duration |
Khoảng thời gian cần thiết để di chuyển chân. Nếu bạn đặt |
static_duration |
Thời gian di chuyển qua chặng, được tính toán mà không tính đến tình trạng giao thông. |
polyline |
Hình nhiều đường tổng thể cho chân này. Quy định này cũng áp dụng cho hình nhiều đường của mỗi |
start_location |
Vị trí bắt đầu của chân này. Mã này có thể khác với |
end_location |
Vị trí kết thúc của chân này. Mã này có thể khác với |
steps[] |
Một dãy các bước cho biết các đoạn trong chân này. Mỗi bước đại diện cho một hướng dẫn điều hướng. |
travel_advisory |
Bao gồm thông tin bổ sung mà người dùng cần được thông báo, chẳng hạn như việc hạn chế khu vực giao thông có thể xảy ra, v.v. trên đoạn tuyến đường. |
RouteLegStep
Đóng gói một phân đoạn của RouteLeg
. Mỗi bước tương ứng với một hướng dẫn di chuyển. Chân của tuyến đường được tạo thành từ các bước.
Các trường | |
---|---|
distance_meters |
Quãng đường đi được của bước này (tính bằng mét). Trong một số trường hợp, trường này có thể không có giá trị. |
static_duration |
Thời gian di chuyển qua bước này mà không tính đến tình trạng giao thông. Trong một số trường hợp, trường này có thể không có giá trị. |
polyline |
Hình nhiều đường liên kết với bước này. |
start_location |
Vị trí bắt đầu của bước này. |
end_location |
Vị trí kết thúc của bước này. |
navigation_instruction |
Hướng dẫn di chuyển. |
travel_advisory |
Đưa ra thông tin bổ sung mà người dùng cần được thông báo, chẳng hạn như việc hạn chế khu vực giao thông có thể xảy ra ở bước chân. |
RouteLegStepTravelAdvisory
Đưa ra thông tin bổ sung mà người dùng cần được thông báo, chẳng hạn như việc hạn chế khu vực giao thông có thể xảy ra ở bước chân.
Các trường | |
---|---|
speed_reading_intervals[] |
Khoảng thời gian đọc tốc độ nêu chi tiết mật độ lưu lượng truy cập. Có thể áp dụng trong trường hợp có các lựa chọn ưu tiên định tuyến đến Ví dụ:
|
RouteLegTravelAdvisory
Bao gồm thông tin bổ sung mà người dùng cần được thông báo, chẳng hạn như việc hạn chế khu vực giao thông có thể xảy ra, v.v. trên đoạn tuyến đường.
Các trường | |
---|---|
toll_info |
Cung cấp thông tin chi tiết về lệ phí cầu đường trên Tuyến đường cụ thể. Trường này chỉ được điền nếu chúng ta cho rằng có thu phí trên Tuyến đường. Nếu trường này được đặt nhưng trường phụ refund_price (giá_trị_ước_tính) không có dữ liệu, thì chúng tôi dự kiến là đường có thu phí cầu đường nhưng chúng tôi không biết giá ước tính. Nếu trường này không tồn tại thì sẽ không có thu phí trên Tuyến{0/}. |
speed_reading_intervals[] |
Khoảng thời gian đọc tốc độ nêu chi tiết mật độ lưu lượng truy cập. Có thể áp dụng trong trường hợp có các lựa chọn ưu tiên định tuyến đến Ví dụ:
|
RouteMatrixDestination
Một đích đến duy nhất cho ComputeRouteMatrixRequest
Các trường | |
---|---|
waypoint |
Bắt buộc. Điểm tham chiếu đích đến |
RouteMatrixElement
Đóng gói thông tin tuyến đường đã tính toán cho cặp điểm xuất phát/đích đến trong API ComputeRouteMatrix. Proto này có thể được truyền trực tuyến đến ứng dụng khách.
Các trường | |
---|---|
origin_index |
Chỉ mục gốc 0 của nguồn gốc trong yêu cầu. |
destination_index |
Chỉ mục dựa trên giá trị 0 của đích đến trong yêu cầu. |
status |
Mã trạng thái lỗi cho phần tử này. |
condition |
Cho biết đã tìm thấy tuyến đường hay chưa. Không phụ thuộc vào trạng thái. |
distance_meters |
Khoảng cách đi được của tuyến đường, tính bằng mét. |
duration |
Khoảng thời gian cần thiết để điều hướng tuyến đường. Nếu bạn thiết lập |
static_duration |
Thời gian đi qua tuyến đường mà không tính đến tình trạng giao thông. |
travel_advisory |
Thông tin bổ sung về tuyến đường. Ví dụ: thông tin về quy định hạn chế và thông tin về thu phí cầu đường |
fallback_info |
Trong một số trường hợp khi không thể tính toán tuyến đường với các tuỳ chọn đã cho cho cặp điểm gốc/đích cụ thể này, máy chủ có thể quay lại sử dụng chế độ tính toán khác. Khi sử dụng chế độ dự phòng, trường này chứa thông tin chi tiết về phản hồi dự phòng. Nếu không, trường này sẽ không được đặt. |
RouteMatrixElementCondition
Điều kiện của tuyến được trả về.
Enum | |
---|---|
ROUTE_MATRIX_ELEMENT_CONDITION_UNSPECIFIED |
Chỉ được dùng khi status của phần tử không được chấp nhận. |
ROUTE_EXISTS |
Đã tìm thấy một tuyến đường và thông tin tương ứng đã được điền cho phần tử. |
ROUTE_NOT_FOUND |
Không tìm thấy tuyến đường nào. Các trường có chứa thông tin về tuyến đường, chẳng hạn như distance_meters hoặc duration , sẽ không được điền vào phần tử. |
RouteMatrixOrigin
Một nguồn gốc duy nhất cho ComputeRouteMatrixRequest
Các trường | |
---|---|
waypoint |
Bắt buộc. Điểm tham chiếu gốc |
route_modifiers |
Không bắt buộc. Đối tượng sửa đổi cho mọi tuyến lấy đây làm nguồn gốc |
RouteModifiers
Đóng gói một tập hợp các điều kiện không bắt buộc để đáp ứng khi tính toán các tuyến đường.
Các trường | |
---|---|
avoid_tolls |
Chỉ định xem có tránh đường có thu phí hay không khi thích hợp. Sẽ ưu tiên áp dụng cho các tuyến đường không chứa đường có thu phí. Chỉ áp dụng cho các phương tiện đi lại |
avoid_highways |
Chỉ định xem có tránh đường cao tốc khi thích hợp hay không. Sẽ ưu tiên các tuyến đường không chứa đường cao tốc. Chỉ áp dụng cho các phương tiện đi lại |
avoid_ferries |
Chỉ định xem có tránh phà khi thích hợp hay không. Chúng tôi sẽ ưu tiên các tuyến đường không cho phép di chuyển bằng phà. Chỉ áp dụng cho phương tiện đi lại |
avoid_indoor |
Chỉ định xem có tránh đi trong nhà khi thích hợp hay không. Hệ thống sẽ ưu tiên các tuyến đường không chứa tính năng chỉ đường trong nhà. Chỉ áp dụng cho phương tiện đi lại |
vehicle_info |
Nêu thông tin về xe. |
toll_passes[] |
Cung cấp thông tin về thẻ thu phí cầu đường. Nếu phí cầu đường được cung cấp, API sẽ cố gắng trả về giá vé. Nếu phí cầu đường không được cung cấp, API sẽ coi phí cầu đường là không xác định và cố gắng trả về giá tiền mặt. Chỉ áp dụng cho chế độ đi lại DRIVE và TWO_WHEELER. |
RouteObjective
Đóng gói một mục tiêu để tối ưu hoá theo ComputeCustomRoutes.
Các trường | |
---|---|
rate_card |
Mục tiêu RateCard. |
RateCard
Đóng gói mục tiêu tuyến trên RateCard.
Các trường | |
---|---|
cost_per_minute |
Không bắt buộc. Chi phí mỗi phút. |
cost_per_km |
Không bắt buộc. Chi phí mỗi km. |
include_tolls |
Không bắt buộc. Liệu có bao gồm phí cầu đường trong tổng chi phí hay không. |
MonetaryCost
Trình bày chi phí sử dụng trong thẻ giá.
Các trường | |
---|---|
value |
Bắt buộc. Giá trị chi phí bằng nội tệ suy ra được từ yêu cầu. |
RouteTravelAdvisory
Đưa ra thông tin bổ sung mà người dùng cần được thông báo, chẳng hạn như việc hạn chế khu vực giao thông có thể xảy ra, v.v.
Các trường | |
---|---|
toll_info |
Cung cấp thông tin chi tiết về lệ phí cầu đường trên Tuyến đường. Trường này chỉ được điền nếu chúng ta cho rằng có thu phí trên Tuyến đường. Nếu trường này được đặt nhưng trường phụ refund_price (giá_trị_ước_tính) không có dữ liệu, thì chúng tôi dự kiến là đường có thu phí cầu đường nhưng chúng tôi không biết giá ước tính. Nếu bạn không đặt trường này, thì chúng tôi sẽ hiểu là không có thu phí trên Tuyến đường này. |
speed_reading_intervals[] |
Khoảng thời gian đọc tốc độ nêu chi tiết mật độ lưu lượng truy cập. Có thể áp dụng trong trường hợp có các lựa chọn ưu tiên định tuyến đến Ví dụ:
|
RouteTravelMode
Một tập hợp các giá trị dùng để chỉ định phương tiện đi lại.
Enum | |
---|---|
TRAVEL_MODE_UNSPECIFIED |
Chưa chỉ định phương tiện đi lại. Giá trị mặc định là DRIVE . |
DRIVE |
Đi bằng xe ô tô khách. |
BICYCLE |
Đi bằng xe đạp. |
WALK |
Đi bộ. |
TWO_WHEELER |
Xe mô tô hai bánh. Ví dụ: xe mô tô. Xin lưu ý rằng chế độ này khác với chế độ đi lại BICYCLE bao gồm chế độ do con người sử dụng. |
TAXI |
Đi bằng taxi được cấp phép, nghĩa là phương tiện có thể đi trên các làn đường taxi được chỉ định ở một số khu vực. Chế độ TAXI là tính năng thử nghiệm. Nếu khách hàng yêu cầu tuyến đường TAXI trong một thành phố không có dữ liệu làn đường taxi, thì một tuyến đường DRIVE sẽ được trả về. |
RoutingPreference
Một tập hợp giá trị chỉ định các yếu tố cần xem xét khi tính toán tuyến đường.
Enum | |
---|---|
ROUTING_PREFERENCE_UNSPECIFIED |
Chưa chỉ định tùy chọn định tuyến. Mặc định là TRAFFIC_AWARE . |
TRAFFIC_UNAWARE |
Tính toán các tuyến đường mà không tính đến tình trạng giao thông. Phù hợp khi tình trạng giao thông không quan trọng. Việc sử dụng giá trị này sẽ tạo ra độ trễ thấp nhất. |
TRAFFIC_AWARE |
Tính toán các tuyến đường có xét đến tình trạng giao thông. Trái ngược với TRAFFIC_AWARE_OPTIMAL , một số tính năng tối ưu hoá được áp dụng để giảm đáng kể độ trễ. |
TRAFFIC_AWARE_OPTIMAL |
Tính toán các tuyến đường có tính đến tình trạng giao thông mà không áp dụng hầu hết các chế độ tối ưu hoá hiệu suất. Việc sử dụng giá trị này sẽ tạo ra độ trễ cao nhất. |
SpeedReadingInterval
Chỉ báo mật độ giao thông trên một đoạn liền kề của một đường nhiều đường hoặc đường dẫn. Cho một đường dẫn có các điểm P_0, P_1, ... , P_N (chỉ mục dựa trên 0), SpeedReadingInterval xác định khoảng thời gian và mô tả lưu lượng truy cập của nó bằng các danh mục sau.
Các trường | |
---|---|
start_polyline_point_index |
Chỉ mục bắt đầu của khoảng thời gian này trong hình nhiều đường. Trong JSON, khi chỉ mục bằng 0, trường sẽ có vẻ như không được điền. |
end_polyline_point_index |
Chỉ mục kết thúc của khoảng này trong hình nhiều đường. Trong JSON, khi chỉ mục bằng 0, trường sẽ có vẻ như không được điền. |
speed |
Tốc độ giao thông trong khoảng thời gian này. |
Tốc độ
Phân loại tốc độ hình nhiều đường dựa trên dữ liệu giao thông.
Enum | |
---|---|
SPEED_UNSPECIFIED |
Giá trị mặc định. Giá trị này không được sử dụng. |
NORMAL |
Tốc độ bình thường, không phát hiện thấy ùn tắc nhẹ. |
SLOW |
Đã phát hiện thấy tắc nghẽn nhưng không có tắc nghẽn giao thông. |
TRAFFIC_JAM |
Đã phát hiện kẹt xe. |
TollInfo
Trình bày thông tin thu phí cầu đường trên Route
hoặc RouteLeg
.
Các trường | |
---|---|
estimated_price[] |
Số tiền lệ phí cầu đường cho Tuyến đường hoặc Tuyến đường tương ứng. Danh sách này chứa số tiền tương ứng với mỗi đơn vị tiền tệ mà các trạm thu phí này dự kiến sẽ thu. Thông thường, danh sách này sẽ chỉ chứa một mục cho các tuyến đường có thu phí bằng một đơn vị tiền tệ. Đối với các chuyến đi quốc tế, danh sách này có thể chứa nhiều mục thể hiện phí cầu đường bằng các đơn vị tiền tệ khác nhau. |
TollPass
Danh sách thẻ thu phí cầu đường trên khắp thế giới mà chúng tôi hỗ trợ.
Enum | |
---|---|
TOLL_PASS_UNSPECIFIED |
Không được sử dụng. Nếu giá trị này được sử dụng, thì yêu cầu sẽ không thành công. |
AU_ETOLL_TAG |
Một trong nhiều nhà cung cấp dịch vụ cầu đường ở Sydney. https://www.myetoll.com.au |
AU_EWAY_TAG |
Một trong nhiều nhà cung cấp dịch vụ cầu đường ở Sydney. https://www.tollpay.com.au/ |
AU_LINKT |
Thẻ phí cầu đường trên toàn nước Úc. Xem thêm thông tin tại https://www.linkt.com.au/. |
AR_TELEPASE |
Phí cầu đường ở Argentina. Xem thêm thông tin chi tiết tại https://telepase.com.ar |
BR_AUTO_EXPRESO |
Phí cầu đường ở Brazil. Xem thêm chi tiết tại https://www.autoexpreso.com |
BR_CONECTCAR |
Phí cầu đường ở Brazil. Xem thêm thông tin chi tiết tại https://conectcar.com. |
BR_MOVE_MAIS |
Phí cầu đường ở Brazil. Xem thêm thông tin tại https://movemais.com. |
BR_PASSA_RAPIDO |
Phí cầu đường ở Brazil. Xem thêm thông tin chi tiết tại https://pasorapido.gob.do/ |
BR_SEM_PARAR |
Phí cầu đường ở Brazil. Xem thêm thông tin chi tiết tại https://www.semparar.com.br. |
BR_TAGGY |
Phí cầu đường ở Brazil. Xem thêm thông tin chi tiết tại https://taggy.com.br. |
BR_VELOE |
Phí cầu đường ở Brazil. Xem thêm thông tin chi tiết tại https://veloe.com.br/site/onde-usar. |
CA_US_AKWASASNE_SEAWAY_CORPORATE_CARD |
Đường biên giới giữa Canada sang Hoa Kỳ. |
CA_US_AKWASASNE_SEAWAY_TRANSIT_CARD |
Đường biên giới giữa Canada sang Hoa Kỳ. |
CA_US_BLUE_WATER_EDGE_PASS |
Ontario, Canada đến băng qua biên giới Hoa Kỳ. |
CA_US_CONNEXION |
Ontario, Canada đến băng qua biên giới Hoa Kỳ. |
CA_US_NEXUS_CARD |
Đường biên giới giữa Canada sang Hoa Kỳ. |
ID_E_TOLL |
Indonesia. Thẻ điện tử do nhiều ngân hàng cung cấp, dùng để thanh toán lệ phí cầu đường. Tất cả thẻ điện tử thông qua ngân hàng đều được tính phí như nhau nên chỉ cần một giá trị enum. Ví dụ: Bank Mandiri https://www.bankmandiri.co.id/e-money BCA https://www.bca.co.id/flazz BNI https://www.bni.co.id/id-id/ebanking/tapcash |
IN_FASTAG |
India. |
IN_LOCAL_HP_PLATE_EXEMPT |
Ấn Độ, được miễn thuế biển số của tiểu bang HP. |
MX_TAG_IAVE |
Thẻ cầu đường Mexico. |
MX_TAG_TELEVIA |
Công ty thu phí cầu đường ở Mexico. Một trong số đó đang hoạt động ở Thành phố Mexico. Xem thêm thông tin chi tiết tại https://www.televia.com.mx. |
MX_VIAPASS |
Thẻ cầu đường Mexico. Xem thêm thông tin chi tiết tại https://www.viapass.com.mx/viapass/web_home.aspx. |
US_AL_FREEDOM_PASS |
AL, Hoa Kỳ. |
US_AK_ANTON_ANDERSON_TUNNEL_BOOK_OF_10_TICKETS |
AK, Hoa Kỳ. |
US_CA_FASTRAK |
CA, Hoa Kỳ. |
US_CA_FASTRAK_CAV_STICKER |
Cho biết tài xế có thẻ FasTrak ngoài hình dán Xe sạch (CAV) do DMV cấp. https://www.bayareafastrak.org/en/guide/doINeedFlex.shtml |
US_CO_EXPRESSTOLL |
CO, Hoa Kỳ. |
US_CO_GO_PASS |
CO, Hoa Kỳ. |
US_DE_EZPASSDE |
Đức, Hoa Kỳ. |
US_FL_BOB_SIKES_TOLL_BRIDGE_PASS |
FL, Hoa Kỳ. |
US_FL_DUNES_COMMUNITY_DEVELOPMENT_DISTRICT_EXPRESSCARD |
FL, Hoa Kỳ. |
US_FL_EPASS |
FL, Hoa Kỳ. |
US_FL_GIBA_TOLL_PASS |
FL, Hoa Kỳ. |
US_FL_LEEWAY |
FL, Hoa Kỳ. |
US_FL_SUNPASS |
FL, Hoa Kỳ. |
US_FL_SUNPASS_PRO |
FL, Hoa Kỳ. |
US_IL_EZPASSIL |
IL, Hoa Kỳ. |
US_IL_IPASS |
IL, Hoa Kỳ. |
US_IN_EZPASSIN |
Ấn Độ, Hoa Kỳ. |
US_KS_BESTPASS_HORIZON |
KS, Hoa Kỳ. |
US_KS_KTAG |
KS, Hoa Kỳ. |
US_KS_NATIONALPASS |
KS, Hoa Kỳ. |
US_KS_PREPASS_ELITEPASS |
KS, Hoa Kỳ. |
US_KY_RIVERLINK |
KY, Hoa Kỳ. |
US_LA_GEAUXPASS |
LA, Hoa Kỳ. |
US_LA_TOLL_TAG |
LA, Hoa Kỳ. |
US_MA_EZPASSMA |
MA, Hoa Kỳ. |
US_MD_EZPASSMD |
MD, Hoa Kỳ. |
US_ME_EZPASSME |
ME, Hoa Kỳ. |
US_MI_AMBASSADOR_BRIDGE_PREMIER_COMMUTER_CARD |
MI, Hoa Kỳ. |
US_MI_GROSSE_ILE_TOLL_BRIDGE_PASS_TAG |
MI, Hoa Kỳ. |
US_MI_IQ_PROX_CARD |
MI, Hoa Kỳ. |
US_MI_MACKINAC_BRIDGE_MAC_PASS |
MI, Hoa Kỳ. |
US_MI_NEXPRESS_TOLL |
MI, Hoa Kỳ. |
US_MN_EZPASSMN |
MN, Hoa Kỳ. |
US_NC_EZPASSNC |
NC, Hoa Kỳ. |
US_NC_PEACH_PASS |
NC, Hoa Kỳ. |
US_NC_QUICK_PASS |
NC, Hoa Kỳ. |
US_NH_EZPASSNH |
NH, Hoa Kỳ. |
US_NJ_DOWNBEACH_EXPRESS_PASS |
NJ, Hoa Kỳ. |
US_NJ_EZPASSNJ |
NJ, Hoa Kỳ. |
US_NY_EXPRESSPASS |
New York, Hoa Kỳ. |
US_NY_EZPASSNY |
New York, Hoa Kỳ. |
US_OH_EZPASSOH |
OH, Hoa Kỳ. |
US_PA_EZPASSPA |
PA, Hoa Kỳ. |
US_RI_EZPASSRI |
RI, Hoa Kỳ. |
US_SC_PALPASS |
SC, Hoa Kỳ. |
US_TX_BANCPASS |
TX, Hoa Kỳ. |
US_TX_DEL_RIO_PASS |
TX, Hoa Kỳ. |
US_TX_EFAST_PASS |
TX, Hoa Kỳ. |
US_TX_EAGLE_PASS_EXPRESS_CARD |
TX, Hoa Kỳ. |
US_TX_EPTOLL |
TX, Hoa Kỳ. |
US_TX_EZ_CROSS |
TX, Hoa Kỳ. |
US_TX_EZTAG |
TX, Hoa Kỳ. |
US_TX_LAREDO_TRADE_TAG |
TX, Hoa Kỳ. |
US_TX_PLUSPASS |
TX, Hoa Kỳ. |
US_TX_TOLLTAG |
TX, Hoa Kỳ. |
US_TX_TXTAG |
TX, Hoa Kỳ. |
US_TX_XPRESS_CARD |
TX, Hoa Kỳ. |
US_UT_ADAMS_AVE_PARKWAY_EXPRESSCARD |
UT, Hoa Kỳ. |
US_VA_EZPASSVA |
VA, Hoa Kỳ. |
US_WA_BREEZEBY |
WA, Hoa Kỳ. |
US_WA_GOOD_TO_GO |
WA, Hoa Kỳ. |
US_WV_EZPASSWV |
WV, Hoa Kỳ. |
US_WV_MEMORIAL_BRIDGE_TICKETS |
WV, Hoa Kỳ. |
US_WV_NEWELL_TOLL_BRIDGE_TICKET |
WV, Hoa Kỳ. |
Đơn vị
Một tập hợp các giá trị chỉ định đơn vị đo lường dùng trong màn hình.
Enum | |
---|---|
UNITS_UNSPECIFIED |
Chưa chỉ định đơn vị đo lường. Giá trị mặc định là đơn vị đo lường suy ra được từ yêu cầu. |
METRIC |
Đơn vị đo lường hệ mét. |
IMPERIAL |
Đơn vị đo lường Hoàng gia (tiếng Anh). |
VehicleEmissionType
Một tập hợp giá trị mô tả loại khí thải của xe. Chỉ áp dụng cho chế độ đi lại DRIVE.
Enum | |
---|---|
VEHICLE_EMISSION_TYPE_UNSPECIFIED |
Chưa chỉ định loại khí thải. Mặc định là GASOLINE. |
GASOLINE |
Xe chạy bằng xăng/xăng. |
ELECTRIC |
Xe chạy bằng điện. |
HYBRID |
Xe sử dụng nhiên liệu kết hợp (chẳng hạn như xăng + xe điện). |
VehicleInfo
Cung cấp thông tin về xe, chẳng hạn như ký tự cuối cùng của biển số xe.
Các trường | |
---|---|
emission_type |
Mô tả loại khí thải của xe. Chỉ áp dụng cho chế độ đi lại DRIVE. |
Waypoint
Đóng gói một điểm tham chiếu. Điểm tham chiếu đánh dấu cả điểm đầu và điểm cuối của tuyến đường, đồng thời bao gồm các điểm dừng trung gian dọc theo tuyến đường.
Các trường | |
---|---|
via |
Đánh dấu điểm tham chiếu này là một mốc quan trọng thay vì là điểm dừng. Đối với mỗi điểm tham chiếu không phải trong yêu cầu, phản hồi sẽ thêm một mục nhập vào mảng |
vehicle_stopover |
Cho biết rằng điểm tham chiếu dành cho xe dừng ở đó với mục đích là đón hoặc trả xe. Khi bạn đặt giá trị này, tuyến đường được tính toán sẽ không bao gồm các điểm tham chiếu không phải là |
side_of_road |
Cho biết vị trí của điểm tham chiếu này có nghĩa là xe sẽ được ưu tiên dừng ở một phía đường cụ thể. Khi bạn đặt giá trị này, tuyến đường sẽ đi qua vị trí để xe có thể dừng ở bên đường mà vị trí bị dịch chuyển từ tâm đường. Lựa chọn này chỉ dùng được cho chế độ đi lại "DRIVE" và "TWO_WHEELER" (hệ thống đi lại), cũng như khi bạn đặt "location_type" thành "location". |
Trường nhóm location_type . Nhiều cách để đại diện cho một vị trí. location_type chỉ có thể là một trong những trạng thái sau đây: |
|
location |
Điểm được xác định bằng cách sử dụng toạ độ địa lý, bao gồm cả tiêu đề không bắt buộc. |
place_id |
Mã địa điểm POI được liên kết với điểm tham chiếu. |