Tuyến phương tiện công cộng cung cấp hướng dẫn chỉ đường bằng các phương tiện công cộng có sẵn trong khu vực. Các phương tiện công cộng có thể bao gồm xe buýt, tàu điện ngầm và tàu hoả, v.v. Tuyến phương tiện công cộng cũng thường bao gồm hướng dẫn đi bộ đến, đi từ và giữa các trạm phương tiện công cộng. Vì tuyến phương tiện công cộng thường yêu cầu bạn di chuyển bằng nhiều phương tiện, nên cách bạn yêu cầu tuyến đường và một số phần của phản hồi sẽ khác nhau.
Sự khác biệt giữa tuyến phương tiện công cộng và các tuyến khác
Các tuyến phương tiện công cộng mà bạn yêu cầu bằng cách đặt travelMode thành TRANSIT sẽ khác với các tuyến sử dụng các tuỳ chọn travelMode khác. Bạn không thể yêu cầu tất cả các đối tượng và tuỳ chọn giống nhau, đồng thời phản hồi sẽ trả về các trường khác nhau so với các tuyến khác.
Trong Routes API, các bước luôn là một hướng dẫn điều hướng trên tất cả các loại phương tiện di chuyển. Vì vậy, mỗi hướng dẫn điều hướng là một bước. Phản hồi về tuyến phương tiện công cộng rất giống với các tuyến có các phương thức di chuyển khác, ngoại trừ một vài điểm khác biệt chính:
| Điểm khác biệt về yêu cầu | Sự khác biệt về phản hồi |
|---|---|
| Bạn không thể chỉ định các điểm trung gian. | Bao gồm thông tin chi tiết về phương tiện công cộng. |
| Không thể nhận được tuyến đường thân thiện với môi trường | Bao gồm siêu dữ liệu cho từng phương thức di chuyển, trong đó có thông tin tóm tắt về các bước cho phương thức di chuyển đó, trong "stepsOverview" (để yêu cầu siêu dữ liệu này, hãy sử dụng mặt nạ trường "routes.legs.stepsOverview"). |
| Không thể chỉ định cách thức và liệu có nên đưa dữ liệu lưu lượng truy cập vào hay không | |
| Không thể chỉ định các đặc điểm tuyến đường cần tránh | |
Chỉ có thể chỉ định transitPreferences cho routingPreference. Để biết thông tin chi tiết, hãy xem TransitPreferences. |
Để biết thêm thông tin về phản hồi do Routes API trả về, hãy xem phần Xem xét phản hồi về tuyến phương tiện công cộng.
Cách xem tuyến phương tiện công cộng
Đặt điểm xuất phát và điểm đến.
Đặt phương tiện di chuyển thành phương tiện công cộng:
travelMode: "TRANSIT"Thêm mặt nạ trường để nhận các trường phản hồi mà bạn muốn. Xem phần Yêu cầu các trường tuyến phương tiện công cộng mà bạn cần.
Đặt các tham số không bắt buộc nếu cần. Xem phần Đặt thông số cho tuyến phương tiện công cộng.
Yêu cầu các trường tuyến phương tiện công cộng mà bạn cần
Yêu cầu các trường tuyến phương tiện công cộng mà bạn cần bằng cách sử dụng mặt nạ trường. Bảng sau đây chứa một số phản hồi đề xuất cho tuyến xe buýt và mặt nạ trường để sử dụng khi yêu cầu các phản hồi đó.
| Cách yêu cầu thông tin này | Sử dụng mặt nạ trường này |
|---|---|
| Tất cả thông tin chi tiết về tuyến đường | routes.* |
| Tất cả thông tin chi tiết về phương tiện công cộng | routes.legs.steps.transitDetails |
| Vị trí bắt đầu của mỗi chặng | routes.legs.steps.startLocation |
| Địa điểm kết thúc của mỗi chặng | routes.legs.steps.endLocation |
| Đường đa tuyến đường cho mỗi bước | routes.legs.steps.polyline |
| Loại phương tiện công cộng được sử dụng cho mỗi bước | routes.legs.steps.travelMode |
| Giá vé ước tính cho từng bước và tuyến đường, cũng như giá vé ước tính được bản địa hoá | routes.travel_advisory.transitFare
localized routes.localizedValues.transitFare
Lưu ý: |
| Văn bản được bản địa hoá cho thời lượng và khoảng cách | routes.localizedValues |
Để biết thêm thông tin về cách đặt mặt nạ trường, hãy xem phần Chọn trường để trả về.
Đặt thông số cho tuyến phương tiện công cộng
Dưới đây là các tham số có liên quan cho tuyến phương tiện công cộng:
| Cách thực hiện | Sử dụng thông số này | Ghi chú |
|---|---|---|
| Chọn phương tiện công cộng | travelMode: "TRANSIT" |
Bắt buộc. Tìm hiểu thêm. |
| Đặt thời gian đến hoặc thời gian khởi hành | "arrivalTime": "yyyy-mm-ddThh:mm:ssZ"
HOẶC "departureTime": "yyyy-mm-ddThh:mm:ssZ" |
Không bắt buộc. Bạn có thể chỉ định arrival_time hoặc departure_time. Nếu không chỉ định thời gian nào, departure_time sẽ mặc định là thời gian thực thi hiện tại (now). Bạn chỉ có thể đặt thời gian đến và thời gian khởi hành trong khoảng thời gian sau, với thời gian thực thi hiện tại (now) làm tham chiếu:
|
| Bao gồm các tuyến đường thay thế | "computeAlternativeRoutes": true |
Không bắt buộc. Đặt thành true để Routes API tính toán tối đa 3 tuyến đường bổ sung (nếu có). Tìm hiểu thêm |
| Chỉ định lựa chọn ưu tiên cho loại phương tiện công cộng | "transitPreferences": { allowedTravelModes: ["BUS","SUBWAY","TRAIN","LIGHT_RAIL","RAIL"]}
Lưu ý: Nếu bạn chỉ định một phương thức di chuyển ưu tiên, thì các tuyến đường được trả về vẫn có thể sử dụng các phương thức đi lại công cộng khác, thậm chí chỉ sử dụng các phương thức đi lại công cộng khác, tuỳ thuộc vào hiệu quả của tuyến đường và tình trạng có sẵn của phương thức di chuyển ưu tiên. |
Không bắt buộc. Chỉ định phương thức di chuyển bằng phương tiện công cộng mà bạn ưu tiên. Tìm hiểu thêm |
| Chỉ định các lựa chọn ưu tiên cho tuyến phương tiện công cộng | "transitPreferences": {routingPreference: "LESS_WALKING|FEWER_TRANSFERS"} |
Không bắt buộc. Chỉ định lựa chọn ưu tiên về tuyến đường đi bằng phương tiện công cộng. Tìm hiểu thêm |
Ví dụ: Xem tuyến đường của phương tiện công cộng
Ví dụ sau đây sẽ lấy một tuyến đường bằng phương tiện công cộng với các tham số sau:
Chỉ định các lựa chọn ưu tiên về việc đi tàu và ít đi bộ hơn.
Yêu cầu các tuyến đường thay thế.
Cung cấp mặt nạ trường trả về thông tin chi tiết về quá trình vận chuyển:
curl -X POST -H 'content-type: application/json' -d '{ "origin": { "address": "Humberto Delgado Airport, Portugal" }, "destination": { "address": "Basílica of Estrela, Praça da Estrela, 1200-667 Lisboa, Portugal" }, "travelMode": "TRANSIT", "computeAlternativeRoutes": true, "transitPreferences": { routingPreference: "LESS_WALKING", allowedTravelModes: ["TRAIN"] }, }' \ -H 'Content-Type: application/json' \ -H 'X-Goog-Api-Key: YOUR_API_KEY' \ -H 'X-Goog-FieldMask: routes.legs.steps.transitDetails' \ 'https://routes.googleapis.com/directions/v2:computeRoutes'
Phản hồi cho thấy các trường route.legs.steps.transitDetails cho hai tuyến:
{ "routes": [ { "legs": [ { "steps": [ {}, {}, {}, { "transitDetails": { "stopDetails": { "arrivalStop": { "name": "Saldanha", "location": { "latLng": { "latitude": 38.73532, "longitude": -9.14543 } } }, "arrivalTime": "2023-08-26T10:49:42Z", "departureStop": { "name": "Aeroporto", "location": { "latLng": { "latitude": 38.769047799999996, "longitude": -9.1284593 } } }, "departureTime": "2023-08-26T10:32:10Z" }, "localizedValues": { "arrivalTime": { "time": { "text": "11:49" }, "timeZone": "Europe/Lisbon" }, "departureTime": { "time": { "text": "11:32" }, "timeZone": "Europe/Lisbon" } }, "headsign": "São Sebastião", "transitLine": { "agencies": [ { "name": "Metropolitano de Lisboa, E.P.E.", "phoneNumber": "+351 21 350 0115", "uri": "https://www.metrolisboa.pt/" } ], "name": "Vermelha", "color": "#f23061", "nameShort": "Vm", "textColor": "#000000", "vehicle": { "name": { "text": "Metrô" }, "type": "SUBWAY", "iconUri": "//maps.gstatic.com/mapfiles/transit/iw2/6/subway2.png" } }, "stopCount": 11 } }, {}, { "transitDetails": { "stopDetails": { "arrivalStop": { "name": "Rato", "location": { "latLng": { "latitude": 38.7201022, "longitude": -9.1540562 } } }, "arrivalTime": "2023-08-26T11:01:37Z", "departureStop": { "name": "Saldanha", "location": { "latLng": { "latitude": 38.73527, "longitude": -9.1455200000000012 } } }, "departureTime": "2023-08-26T10:57:57Z" }, "localizedValues": { "arrivalTime": { "time": { "text": "12:01" }, "timeZone": "Europe/Lisbon" }, "departureTime": { "time": { "text": "11:57" }, "timeZone": "Europe/Lisbon" } }, "headsign": "Rato", "transitLine": { "agencies": [ { "name": "Metropolitano de Lisboa, E.P.E.", "phoneNumber": "+351 21 350 0115", "uri": "https://www.metrolisboa.pt/" } ], "name": "Amarela", "color": "#f2c200", "nameShort": "Am", "textColor": "#000000", "vehicle": { "name": { "text": "Metrô" }, "type": "SUBWAY", "iconUri": "//maps.gstatic.com/mapfiles/transit/iw2/6/subway2.png" } }, "stopCount": 4 } }, {}, {}, {}, {}, {}, {} ] } ] } ] }