- Yêu cầu HTTP
- Nội dung yêu cầu
- Nội dung phản hồi
- PolylineQuality
- PolylineEncoding
- ReferenceRoute
- ExtraComputation
- Tuyến đường
- RouteLabel
- RouteLeg
- Hình nhiều đường
- RouteLegStep
- NavigationInstruction
- Điều khiển
- RouteLegStepTravelAdvisory
- RouteLegStepLocalizedValues
- RouteLegStepTransitDetails
- TransitStopDetails (Thông tin vận chuyển)
- TransitStop (Dừng chuyển tuyến)
- TransitDetailsLocalizedValues
- LocalizedTime
- TransitLine
- TransitAgency
- TransitVehicle
- TransitVehicleType
- RouteLegTravelAdvisory
- RouteLegLocalizedValues
- StepsOverview
- MultiModalSegment (Phân đoạn đa kênh)
- Khung nhìn
- RouteLocalizedValues
- GeocodingResults
- GeocodedWaypoint
Trả về tuyến chính cùng với các tuyến thay thế không bắt buộc, dựa trên một nhóm các điểm cuối và điểm tham chiếu trung gian.
LƯU Ý: Phương pháp 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 sử dụng tham số URL $fields
hoặc fields
, hoặc bằng cách sử dụng tiêu đề HTTP/gRPC X-Goog-FieldMask
(xem các tham số và tiêu đề URL có sẵn). Giá trị là một danh sách các đường dẫn trường được phân tách bằng dấu phẩy. Xem tài liệu chi tiết về cách tạo đường dẫn trường.
Ví dụ: trong phương thức này:
- Mặt nạ cho trường (field mask) của tất cả các trường có sẵn (để kiểm tra thủ công):
X-Goog-FieldMask: *
- Mặt nạ trường của thời lượng, khoảng cách và hình nhiều đường ở cấp tuyến đường (ví dụ về cách thiết lập chính thức):
X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline
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 (*
) hoặc chỉ định mặt nạ cho trường (field mask) ở cấp cao nhất (routes
), vì:
- Việc chỉ chọn các trường mà bạn cần sẽ giúp máy chủ của chúng tôi lưu chu kỳ tính toán. Nhờ đó, chúng tôi có thể trả về kết quả cho bạn với độ trễ thấp hơn.
- Bạn chỉ nên chọn các trường mà bạn cần trong công việc sản xuất để đảm bảo hiệu suất độ trễ ổn định. Chúng tôi có thể thêm các trường phản hồi khác trong tương lai và những trường mới đó có thể cần thêm thời gian tính toán. Nếu bạn chọn tất cả các trường hoặc chọn tất cả các trường ở cấp cao nhất, thì hiệu suất có thể sẽ giảm vì mọi trường mới mà chúng tôi thêm đều sẽ tự động được đưa vào câu trả lời.
- Chỉ chọn các trường bạn cần sẽ làm giảm kích thước phản hồi, từ đó mang lại thông lượng mạng cao hơn.
Yêu cầu HTTP
POST https://routes.googleapis.com/directions/v2:computeRoutes
URL sử dụng cú pháp Chuyển mã gRPC.
Nội dung yêu cầu
Nội dung yêu cầu chứa dữ liệu có cấu trúc sau:
Biểu diễn dưới dạng JSON |
---|
{ "origin": { object ( |
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), cho phép dừng hoặc đi qua. Hỗ trợ tối đa 25 điểm tham chiếu trung gian. |
travelMode |
Không bắt buộc. Chỉ định phương thức di chuyển. |
routingPreference |
Không bắt buộc. Chỉ định cách tính toán tuyến. Máy chủ cố gắng sử dụng tuỳ chọn định tuyến đã chọn để tính toán tuyến. Nếu tuỳ chọn định tuyến dẫn đến lỗi hoặc độ trễ quá lâu, thì hệ thống sẽ trả về lỗi. Bạn chỉ có thể chỉ định tuỳ chọn này khi |
polylineQuality |
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. |
polylineEncoding |
Không bắt buộc. Chỉ định phương thức mã hoá ưu tiên cho hình nhiều đường. |
departureTime |
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 theo thời gian bạn thực hiện yêu cầu. LƯU Ý: Bạn chỉ có thể chỉ định Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, với độ phân giải nano giây và tối đa 9 chữ số phân số. Ví dụ: |
arrivalTime |
Không bắt buộc. Thời gian đến. LƯU Ý: Chỉ có thể đặt khi Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, với độ phân giải nano giây và tối đa 9 chữ số phân số. Ví dụ: |
computeAlternativeRoutes |
Không bắt buộc. Chỉ định xem có tính toán các tuyến thay thế ngoài tuyến đường hay không. Không có tuyến thay thế nào được trả về cho các yêu cầu có điểm tham chiếu trung gian. |
routeModifiers |
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 tuyến đường. |
languageCode |
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 phần Mã nhận dạng ngôn ngữ Unicode. Xem trang 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 định tuyến. |
regionCode |
Không bắt buộc. Mã vùng được chỉ định ở dạng ccTLD (miền cấp cao nhất) gồm 2 ký tự. Để biết thêm thông tin, hãy xem phần Miền cấp cao nhất của mã quốc gia. |
units |
Không bắt buộc. Chỉ định đơn vị đo lường cho các trường hiển thị. Các trường này bao gồm trường |
optimizeWaypointOrder |
Không bắt buộc. Nếu bạn đặt chính sách này thành true (đúng), dịch vụ sẽ cố gắng giảm thiểu tổng chi phí của tuyến bằng cách sắp xếp lại thứ tự các điểm tham chiếu trung gian đã chỉ định. Yêu cầu sẽ không thành công nếu bất kỳ điểm tham chiếu trung gian nào là điểm tham chiếu |
requestedReferenceRoutes[] |
Không bắt buộc. Chỉ định các tuyến tham chiếu cần tính toán trong yêu cầu ngoài tuyến mặc định. Tuyến tham chiếu là một tuyến có mục tiêu tính toán tuyến đường khác với tuyến mặc định. Ví dụ: cách tính toán tuyến tham chiếu |
extraComputations[] |
Không bắt buộc. Danh sách các phép tính bổ sung có thể dùng để hoàn tất yêu cầu. Lưu ý: Những phép tính bổ sung này có thể trả về các trường bổ sung trong câu trả lời. Các trường bổ sung này cũng phải được chỉ định trong mặt nạ trường (field mask) để được trả về trong phản hồi. |
trafficModel |
Không bắt buộc. Nêu các giả định cần sử dụng khi tính thời gian lưu lượng truy cập. Chế độ cài đặt này ảnh hưởng đến giá trị được trả về trong trường thời lượng trong |
transitPreferences |
Không bắt buộc. Chỉ định các lựa chọn ưu tiên ảnh hưởng đến tuyến được trả về cho các tuyến |
Nội dung phản hồi
v2.CalculateRoutes cho thông báo phản hồi.
Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:
Biểu diễn dưới dạng JSON |
---|
{ "routes": [ { object ( |
Trường | |
---|---|
routes[] |
Chứa một mảng các tuyến được tính toán (tối đa 3) khi bạn chỉ định |
fallbackInfo |
Trong một số trường hợp khi không thể tính toán kết quả định tuyến với tất cả tuỳ chọn đầu vào, máy chủ có thể dự phòng sang sử dụng 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. |
geocodingResults |
Chứa thông tin phản hồi mã hoá địa lý cho các điểm tham chiếu được chỉ định dưới dạng địa chỉ. |
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 chất lượng 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 kết hợp bằng cách sử dụng nhiều điểm hơn OVERVIEW nhưng kích thước phản hồi sẽ tăng. Hãy sử 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 kết hợp bằng một số ít đ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 lựa chọn này có độ trễ yêu cầu thấp hơn so với việc sử dụng lựa chọn HIGH_QUALITY . |
PolylineEncoding
Chỉ định loại hình nhiều đường ưu tiên sẽ được trả về.
Enum | |
---|---|
POLYLINE_ENCODING_UNSPECIFIED |
Chưa chỉ định tùy chọn loại nhiều đường. Giá trị mặc định là ENCODED_POLYLINE . |
ENCODED_POLYLINE |
Chỉ định một hình nhiều dòng được mã hoá bằng thuật toán mã hoá nhiều dòng. |
GEO_JSON_LINESTRING |
Chỉ định một hình nhiều đường bằng cách sử dụng định dạng GeoJSON LineString |
ReferenceRoute
Tuyến tham chiếu được hỗ trợ trên ComputeRoutesRequest.
Enum | |
---|---|
REFERENCE_ROUTE_UNSPECIFIED |
Không được sử dụng. Các yêu cầu chứa giá trị này sẽ không thành công. |
FUEL_EFFICIENT |
Tuyến đường tiết kiệm nhiên liệu. Những tuyến đường có gắn nhãn giá trị này được xác định là tối ưu hoá cho các tham số như mức tiêu thụ nhiên liệu. |
ExtraComputation
Các phép tính bổ sung cần thực hiện trong khi hoàn tất yêu cầu.
Enum | |
---|---|
EXTRA_COMPUTATION_UNSPECIFIED |
Không được sử dụng. Các yêu cầu chứa giá trị này sẽ không thành công. |
TOLLS |
Thông tin về phí cầu đường cho(các) tuyến đường. |
FUEL_CONSUMPTION |
Mức tiêu thụ nhiên liệu ước tính cho(các) tuyến đường. |
TRAFFIC_ON_POLYLINE |
Hình nhiều đường nhận biết giao thông cho(các) tuyến đường. |
HTML_FORMATTED_NAVIGATION_INSTRUCTIONS |
NavigationInstructions được trình bày dưới dạng một chuỗi văn bản HTML đã được định dạng. Nội dung này được dùng để đọc nguyên trạng. Nội dung này chỉ dành cho mục đích hiển thị. Đừng phân tích cú pháp cú pháp tìm kiếm theo trình tự. |
Tuyến đường
Chứa 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 nối với điểm đầu, điểm cuối và điểm trung gian.
Biểu diễn dưới dạng JSON |
---|
{ "routeLabels": [ enum ( |
Trường | |
---|---|
routeLabels[] |
Các nhãn cho |
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ặng tương ứng với chuyến đi giữa hai chặng không phải là |
distanceMeters |
Khoảng cách đi lại 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 Thời lượng tính bằng giây với tối đa 9 chữ số thập phân, kết thúc bằng " |
staticDuration |
Thời gian di chuyển qua tuyến đường mà không tính đến tình trạng giao thông. Thời lượng tính bằng giây với tối đa 9 chữ số thập phân, kết thúc bằng " |
polyline |
Hình nhiều đường chung của tuyến đường. Hình nhiều đường này là hình nhiều đường kết hợp của tất cả |
description |
Nội dung mô tả về tuyến đường. |
warnings[] |
Một mảng các cảnh báo sẽ xuất hiện khi cho thấy tuyến đường. |
viewport |
Hộp giới hạn khung nhìn của hình nhiều đường. |
travelAdvisory |
Thông tin bổ sung về tuyến đường. |
optimizedIntermediateWaypointIndex[] |
Nếu bạn đặt |
localizedValues |
Văn bản đại diện cho các thuộc tính của |
routeToken |
Mã thông báo tuyến đường được mã hoá base64 an toàn cho web, có thể được chuyển đến SDK điều hướng, cho phép SDK điều hướng tạo lại tuyến đường trong khi điều hướng và trong trường hợp định tuyến lại, hãy thực hiện ý định ban đầu khi bạn tạo tuyến đường bằng cách gọi v2.computeRoutes. Khách hàng nên coi mã thông báo này là một blob mờ. Tệp này không nhằm mục đích đọc hoặc thay đổi. LƯU Ý: |
RouteLabel
Các nhãn cho
rất hữu ích trong việc xác định các thuộc tính cụ thể của tuyến đường để so sánh với các tuyến khác.Route
Enum | |
---|---|
ROUTE_LABEL_UNSPECIFIED |
Mặc định – không được sử dụng. |
DEFAULT_ROUTE |
Tuyến "tốt nhất" mặc định được trả về để tính toán tuyến đường. |
DEFAULT_ROUTE_ALTERNATE |
Lựa chọn thay thế cho tuyến "tốt nhất" mặc định. Các tuyến như thế này sẽ được trả về khi bạn chỉ định . |
FUEL_EFFICIENT |
Tuyến đường tiết kiệm nhiên liệu. Những tuyến đường có gắn nhãn giá trị này được xác định là tối ưu hoá theo tham số Tiết kiệm nhiên liệu, chẳng hạn như mức tiêu thụ nhiên liệu. |
RouteLeg
Chứa một phân đoạn giữa các điểm tham chiếu không phải là via
.
Biểu diễn dưới dạng JSON |
---|
{ "distanceMeters": integer, "duration": string, "staticDuration": string, "polyline": { object ( |
Trường | |
---|---|
distanceMeters |
Khoảng cách di chuyển của chặng 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 Thời lượng tính bằng giây với tối đa 9 chữ số thập phân, kết thúc bằng " |
staticDuration |
Thời gian di chuyển qua chân, được tính toán mà không tính đến tình trạng giao thông. Thời lượng tính bằng giây với tối đa 9 chữ số thập phân, kết thúc bằng " |
polyline |
Hình nhiều đường chung cho chân này bao gồm hình nhiều đường của mỗi |
startLocation |
Vị trí bắt đầu của chân này. Vị trí này có thể khác với |
endLocation |
Vị trí kết thúc của chân này. Vị trí này có thể khác với |
steps[] |
Một mảng các bước biểu thị các phân đoạn trong chân này. Mỗi bước đại diện cho một hướng dẫn di chuyển. |
travelAdvisory |
Chứa thông tin bổ sung mà người dùng phải được thông báo, chẳng hạn như các khu vực hạn chế giao thông có thể xảy ra ở một chặng của tuyến đường. |
localizedValues |
Văn bản đại diện cho các thuộc tính của |
stepsOverview |
Thông tin tổng quan về các bước trong |
Hình nhiều đường
Đóng gói một hình nhiều đường được mã hoá.
Biểu diễn dưới dạng JSON |
---|
{ // Union field |
Trường | |
---|---|
Trường hợp polyline_type . Đóng gói loại hình nhiều đường. Giá trị mặc định là encrypted_polyline. polyline_type chỉ có thể là một trong những trạng thái sau: |
|
encodedPolyline |
Mã hoá chuỗi cho hình nhiều đường bằng thuật toán mã hoá nhiều đường |
geoJsonLinestring |
Chỉ định một hình nhiều đường bằng cách sử dụng định dạng GeoJSON LineString. |
RouteLegStep
Chứa một phân đoạn của
. Mỗi bước tương ứng với một hướng dẫn điều hướng. Các chân tuyến đường được tạo thành từ các bước.RouteLeg
Biểu diễn dưới dạng JSON |
---|
{ "distanceMeters": integer, "staticDuration": string, "polyline": { object ( |
Trường | |
---|---|
distanceMeters |
Khoảng cách di chuyển 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ị. |
staticDuration |
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ị. Thời lượng tính bằng giây với tối đa 9 chữ số thập phân, kết thúc bằng " |
polyline |
Hình nhiều đường liên kết với bước này. |
startLocation |
Vị trí bắt đầu của bước này. |
endLocation |
Vị trí kết thúc của bước này. |
navigationInstruction |
Hướng dẫn di chuyển. |
travelAdvisory |
Chứa thông tin bổ sung mà người dùng cần được thông báo (chẳng hạn như các quy định hạn chế về vùng giao thông có thể xảy ra) ở bước chân. |
localizedValues |
Văn bản đại diện cho các thuộc tính của |
transitDetails |
Thông tin chi tiết liên quan đến bước này nếu phương tiện đi lại là |
travelMode |
Phương tiện đi lại dùng cho bước này. |
Điều khiển
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 hoặc đi thẳng).
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 |
Hãy rẽ phải. |
STRAIGHT |
Đi thẳng. |
RAMP_LEFT |
Đi theo đoạn đường nối bên trái. |
RAMP_RIGHT |
Đi vào đoạn đường nối bên phải. |
MERGE |
Hợp nhất vào giao thông. |
FORK_LEFT |
Đi theo ngã ba bên trái. |
FORK_RIGHT |
Đi theo ngã ba bên phải. |
FERRY |
Đi phà. |
FERRY_TRAIN |
Đi vào chuyến 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. |
DEPART |
Thao tác ban đầu. |
NAME_CHANGE |
Được dùng để biểu thị việc thay đổi tên đường. |
RouteLegStepTravelAdvisory
Chứa thông tin bổ sung mà người dùng cần được thông báo, chẳng hạn như các hạn chế về vùng giao thông có thể xảy ra đối với bước chân.
Biểu diễn dưới dạng JSON |
---|
{
"speedReadingIntervals": [
{
object ( |
Trường | |
---|---|
speedReadingIntervals[] |
LƯU Ý: Trường này hiện chưa được điền. |
RouteLegStepLocalizedValues
Phần văn bản đại diện cho một số thuộc tính nhất định.
Biểu diễn dưới dạng JSON |
---|
{ "distance": { object ( |
Trường | |
---|---|
distance |
Quãng đường đi được thể hiện dưới dạng văn bản. |
staticDuration |
Thời lượng không tính đến điều kiện giao thông, được thể hiện ở dạng văn bản. |
RouteLegStepTransitDetails
Thông tin bổ sung về RouteLegStep
liên quan đến các tuyến TRANSIT
.
Biểu diễn dưới dạng JSON |
---|
{ "stopDetails": { object ( |
Trường | |
---|---|
stopDetails |
Thông tin về điểm dừng đến và đi cho bước này. |
localizedValues |
Văn bản đại diện cho các thuộc tính của |
headsign |
Xác định hướng di chuyển trên tuyến đường này (được đánh dấu trên xe hoặc tại điểm khởi hành). Hướng thường là ga cuối. |
headway |
Chỉ định thời gian dự kiến là khoảng thời gian giữa các chuyến khởi hành từ cùng một điểm dừng tại thời điểm này. Ví dụ: với giá trị số giây phía trước là 600, bạn sẽ phải chờ 10 phút nếu lỡ xe buýt. Thời lượng tính bằng giây với tối đa 9 chữ số thập phân, kết thúc bằng " |
transitLine |
Thông tin về đường chuyển tuyến được sử dụng trong bước này. |
stopCount |
Số điểm dừng từ điểm khởi hành đến điểm dừng đến. Con số này bao gồm điểm dừng đến, nhưng không bao gồm điểm khởi hành. Ví dụ: nếu tuyến đường của bạn khởi hành từ Trạm dừng A, đi qua điểm dừng B và C, và đến điểm dừng D, thì StopCount sẽ trả về giá trị 3. |
tripShortText |
Văn bản xuất hiện trong lịch trình và biển hiệu để xác định chuyến đi bằng phương tiện công cộng của hành khách. Văn bản này phải xác định duy nhất một chuyến đi trong một ngày sử dụng dịch vụ. Ví dụ: "538" là |
TransitStopDetails
Thông tin chi tiết về điểm dừng phương tiện công cộng cho RouteLegStep
.
Biểu diễn dưới dạng JSON |
---|
{ "arrivalStop": { object ( |
Trường | |
---|---|
arrivalStop |
Thông tin về điểm dừng đến cho bước này. |
arrivalTime |
Thời gian đến dự kiến cho bước này. Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, với độ phân giải nano giây và tối đa 9 chữ số phân số. Ví dụ: |
departureStop |
Thông tin về điểm dừng khởi hành cho bước này. |
departureTime |
Thời gian khởi hành dự kiến cho bước này. Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, với độ phân giải nano giây và tối đa 9 chữ số phân số. Ví dụ: |
TransitStop
Thông tin về điểm dừng phương tiện công cộng.
Biểu diễn dưới dạng JSON |
---|
{
"name": string,
"location": {
object ( |
Trường | |
---|---|
name |
Tên của điểm dừng chuyển tuyến. |
location |
Vị trí của điểm dừng được thể hiện bằng vĩ độ/kinh độ. |
TransitDetailsLocalizedValues
Mô tả giá trị đã bản địa hoá cho RouteTransitDetails
.
Biểu diễn dưới dạng JSON |
---|
{ "arrivalTime": { object ( |
Trường | |
---|---|
arrivalTime |
Thời gian ở dạng văn bản biểu diễn với múi giờ tương ứng. |
departureTime |
Thời gian ở dạng văn bản biểu diễn với múi giờ tương ứng. |
LocalizedTime
Mô tả thời gian đã bản địa hoá.
Biểu diễn dưới dạng JSON |
---|
{
"time": {
object ( |
Trường | |
---|---|
time |
Thời gian được chỉ định dưới dạng chuỗi theo múi giờ đã cho. |
timeZone |
Chứa múi giờ. 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_Israel". |
TransitLine
Chứa thông tin về đường chuyển tuyến được dùng trong bước này.
Biểu diễn dưới dạng JSON |
---|
{ "agencies": [ { object ( |
Trường | |
---|---|
agencies[] |
Công ty vận tải (hoặc các công ty quảng cáo) điều hành đường chuyển tuyến này. |
name |
Tên đầy đủ của đường chuyển tuyến này, ví dụ: "8 Avenue Local". |
uri |
URI cho đường chuyển tuyến này do công ty vận tải cung cấp. |
color |
Màu sắc thường được sử dụng trong bảng hiệu cho đường này. Được biểu thị bằng hệ thập lục phân. |
iconUri |
URI cho biểu tượng liên kết với dòng này. |
nameShort |
Tên ngắn của đường chuyển tuyến này. Tên này thường là số dòng, chẳng hạn như "M7" hoặc "355". |
textColor |
Màu sắc thường được sử dụng trong văn bản trên bảng hiệu cho dòng này. Được biểu thị bằng hệ thập lục phân. |
vehicle |
Loại phương tiện hoạt động trên đường chuyển tuyến này. |
TransitAgency
Công ty vận tải điều hành đường chuyển tuyến.
Biểu diễn dưới dạng JSON |
---|
{ "name": string, "phoneNumber": string, "uri": string } |
Trường | |
---|---|
name |
Tên của công ty vận tải này. |
phoneNumber |
Số điện thoại có định dạng dành riêng cho từng khu vực của công ty vận tải. |
uri |
URI của công ty vận tải. |
TransitVehicle
Thông tin về một loại xe được sử dụng trên các tuyến đường phương tiện công cộng.
Biểu diễn dưới dạng JSON |
---|
{ "name": { object ( |
Trường | |
---|---|
name |
Tên của chiếc xe này, được viết hoa. |
type |
Loại phương tiện được sử dụng. |
iconUri |
URI cho biểu tượng liên kết với loại xe này. |
localIconUri |
URI cho biểu tượng liên kết với loại phương tiện này, dựa trên biển hiệu phương tiện giao thông địa phương. |
TransitVehicleType
Loại phương tiện cho các tuyến đường chuyển tuyến.
Enum | |
---|---|
TRANSIT_VEHICLE_TYPE_UNSPECIFIED |
Không sử dụng. |
BUS |
Xe buýt. |
CABLE_CAR |
Phương tiện vận hành bằng 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 |
Tàu chở khách đi làm. |
FERRY |
Phà. |
FUNICULAR |
Một chiếc xe bị cáp kéo lên dốc. Xe lửa có dây kéo thường bao gồm hai toa, mỗi toa đóng vai trò là đối trọng của xe còn lại. |
GONDOLA_LIFT |
Cáp treo trên không. |
HEAVY_RAIL |
Đường sắt nặng. |
HIGH_SPEED_TRAIN |
Tàu cao tốc. |
INTERCITY_BUS |
Xe buýt liên thành phố. |
LONG_DISTANCE_TRAIN |
Chuyến tàu đường dài. |
METRO_RAIL |
Phương tiện công cộng bằng xe điện. |
MONORAIL |
Xe lửa chạy trên đường một ray. |
OTHER |
Tất cả các xe khác. |
RAIL |
Đường sắt. |
SHARE_TAXI |
Taxi đi chung là một loại xe buýt có khả năng trả khách và đón khách ở bất cứ đâu trên tuyến đường. |
SUBWAY |
Tàu điện ngầm. |
TRAM |
Phía trên đường sắt điện trên mặt đất. |
TROLLEYBUS |
Xe điện. |
RouteLegTravelAdvisory
Chứa thông tin bổ sung mà người dùng sẽ được thông báo về bước chân, chẳng hạn như các quy định hạn chế về khu vực giao thông có thể xảy ra.
Biểu diễn dưới dạng JSON |
---|
{ "tollInfo": { object ( |
Trường | |
---|---|
tollInfo |
Chứa thông tin về việc thu phí cầu đường cụ thể trên |
speedReadingIntervals[] |
Khoảng thời gian đọc tốc độ nêu chi tiết mật độ lưu lượng truy cập. Áp dụng trong trường hợp lựa chọn định tuyến ưu tiên của Ví dụ:
|
RouteLegLocalizedValues
Phần văn bản đại diện cho một số thuộc tính nhất định.
Biểu diễn dưới dạng JSON |
---|
{ "distance": { object ( |
Trường | |
---|---|
distance |
Quãng đường đi được thể hiện dưới dạng văn bản. |
duration |
Thời lượng có tính đến điều kiện giao thông, được thể hiện dưới dạng văn bản. Lưu ý: Nếu bạn không yêu cầu thông tin lưu lượng truy cập, thì giá trị này sẽ giống với giá trị staticDuration. |
staticDuration |
Thời lượng không tính đến điều kiện giao thông, được thể hiện ở dạng văn bản. |
StepsOverview
Cung cấp thông tin tổng quan về danh sách RouteLegStep
.
Biểu diễn dưới dạng JSON |
---|
{
"multiModalSegments": [
{
object ( |
Trường | |
---|---|
multiModalSegments[] |
Thông tin tóm tắt về các phân đoạn đa phương thức khác nhau của |
MultiModalSegment
Cung cấp thông tin tóm tắt về các phân đoạn đa phương thức khác nhau của RouteLeg.steps
. Phân đoạn đa phương thức được định nghĩa là một hoặc nhiều RouteLegStep
liền kề có cùng RouteTravelMode
. Trường này sẽ không được điền nếu RouteLeg
không chứa phân đoạn đa phương thức trong các bước.
Biểu diễn dưới dạng JSON |
---|
{ "navigationInstruction": { object ( |
Trường | |
---|---|
navigationInstruction |
NavigationIn hướng dẫn cho phân đoạn đa phương thức. |
travelMode |
Phương thức đi lại của đoạn đa phương thức. |
stepStartIndex |
Chỉ mục |
stepEndIndex |
Chỉ mục |
Khung nhìn
Một chế độ xem kinh độ – vĩ độ, được thể hiện dưới dạng hai điểm theo đường chéo đối diện low
và high
. Khung nhìn được xem là một khu vực khép kín, tức là nó bao gồm ranh giới của nó. Giới hạn vĩ độ phải nằm trong khoảng từ -90 đến 90 độ và giới hạn kinh độ phải nằm trong khoảng từ -180 đến 180 độ. Các trường hợp khác nhau bao gồm:
Nếu
low
=high
, khung nhìn bao gồm một điểm duy nhất đó.Nếu
low.longitude
>high.longitude
, phạm vi kinh độ sẽ bị đảo ngược (khung nhìn vượt qua đường kinh độ 180 độ).Nếu
low.longitude
= -180 độ vàhigh.longitude
= 180 độ, thì khung nhìn sẽ bao gồm tất cả các kinh độ.Nếu
low.longitude
= 180 độ vàhigh.longitude
= -180 độ, thì phạm vi kinh độ sẽ trống.Nếu
low.latitude
>high.latitude
, thì phạm vi vĩ độ sẽ trống.
Cả low
và high
đều phải được điền và không được để trống hộp được đại diện (như được chỉ định trong các định nghĩa ở trên). Khung nhìn trống sẽ gây ra lỗi.
Ví dụ: khung nhìn này bao quanh đầy đủ Thành phố New York:
{ "low": { "latitude": 40.477398, "longitude": -74.259087 }, "high": { "latitude": 40.91618, "longitude": -73.70018 } }
Biểu diễn dưới dạng JSON |
---|
{ "low": { object ( |
Trường | |
---|---|
low |
Bắt buộc. Điểm thấp của khung nhìn. |
high |
Bắt buộc. Điểm cao của khung nhìn. |
RouteLocalizedValues
Phần văn bản đại diện cho một số thuộc tính nhất định.
Biểu diễn dưới dạng JSON |
---|
{ "distance": { object ( |
Trường | |
---|---|
distance |
Quãng đường đi được thể hiện dưới dạng văn bản. |
duration |
Thời lượng có tính đến điều kiện giao thông, được thể hiện dưới dạng văn bản. Lưu ý: Nếu bạn không yêu cầu thông tin lưu lượng truy cập, thì giá trị này sẽ bằng với |
staticDuration |
Thời lượng không tính đến điều kiện giao thông, được thể hiện ở dạng văn bản. |
transitFare |
Giá vé phương tiện công cộng được thể hiện ở dạng văn bản. |
GeocodingResults
Chứa
cho điểm gốc, điểm đến và điểm tham chiếu trung gian. Chỉ được điền cho điểm tham chiếu địa chỉ.GeocodedWaypoints
Biểu diễn dưới dạng JSON |
---|
{ "origin": { object ( |
Trường | |
---|---|
origin |
Điểm tham chiếu được mã hoá địa lý tại nguồn gốc. |
destination |
Điểm tham chiếu được mã hoá địa lý cho đích đến. |
intermediates[] |
Danh sách các điểm tham chiếu được mã hoá địa lý trung gian, mỗi điểm chứa một trường chỉ mục tương ứng với vị trí dựa trên 0 của điểm tham chiếu theo thứ tự được chỉ định trong yêu cầu. |
GeocodedWaypoint
Thông tin chi tiết về vị trí được dùng làm điểm tham chiếu. Chỉ được điền cho điểm tham chiếu địa chỉ. Bao gồm thông tin chi tiết về kết quả mã hoá địa lý nhằm xác định địa chỉ được mã hoá địa lý đến.
Biểu diễn dưới dạng JSON |
---|
{
"geocoderStatus": {
object ( |
Trường | |
---|---|
geocoderStatus |
Cho biết mã trạng thái do thao tác mã hoá địa lý tạo ra. |
type[] |
(Các) loại kết quả, ở dạng 0 hoặc nhiều thẻ loại. Các loại được hỗ trợ: Loại địa chỉ và loại thành phần địa chỉ. |
partialMatch |
Cho biết rằng bộ mã hoá địa lý không trả về kết quả khớp chính xác cho yêu cầu ban đầu, mặc dù bộ mã hoá có thể khớp với một phần địa chỉ được yêu cầu. Bạn có thể kiểm tra lỗi chính tả trong yêu cầu ban đầu và/hoặc địa chỉ chưa hoàn chỉnh. |
placeId |
Mã địa điểm cho kết quả này. |
intermediateWaypointRequestIndex |
Chỉ mục của điểm tham chiếu trung gian tương ứng trong yêu cầu. Chỉ được điền nếu điểm tham chiếu tương ứng là điểm tham chiếu trung gian. |