Tuyến đường đi phương tiện công cộng cung cấp hướng dẫn chỉ đường bằng các lựa chọn 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ả, cùng nhiều phương tiện khác. Tuyến đường đi phương tiện công cộng cũng thường bao gồm hướng dẫn về việc đi bộ đến, đi từ và đi giữa các trạm phương tiện công cộng. Vì một tuyến đường đi 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 thức di chuyể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 đường đi phương tiện công cộng và các tuyến đường khác
Tuyến đường đi phương tiện công cộng (bạn yêu cầu bằng cách đặt travelMode thành TRANSIT) khác với tuyến đường sử dụng các lựa 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 khi so sánh với các tuyến khác.
Trong Routes API, các bước luôn là một hướng dẫn chỉ đường cho tất cả các loại hình di chuyển. Vì vậy, mỗi chỉ 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 tuyến đường có các phương thức di chuyển khác, nhưng có một số điểm khác biệt chính:
| Sự 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 tham chiếu trung gian. | Bao gồm thông tin về phương tiện công cộng. |
| Không thể tìm thấy 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à việc có đư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 của 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 bài viết Xem xét phản hồi về tuyến phương tiện công cộng.
Cách xem tuyến đường đi bằng phương tiện công cộng
Đặt điểm xuất phát và điểm đến.
Đặt phương thức 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.
Nếu cần, hãy đặt các tham số không bắt buộc. Xem bài viết Đặt thông số cho tuyến phương tiện công cộng.
Yêu cầu các trường thông tin về 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 đường đi 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 được đề xuất cho một tuyến phương tiện công cộng và mặt nạ trường cần dùng để 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 về tuyến đường | routes.* |
| Tất cả thông tin về phương tiện công cộng | routes.legs.steps.transitDetails |
| Vị trí bắt đầu cho mỗi chặng | routes.legs.steps.startLocation |
| Vị trí kết thúc cho mỗi chặng | routes.legs.steps.endLocation |
| Đường đa tuyến củ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 chặng và tuyến đường, cũng như Giá vé ước tính theo 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 gian 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
Sau đây là các tham số liên quan đến 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 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 có thời gian nào được chỉ định, thì 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 mốc tham chiếu:
Lưu ý: Lịch trình phương tiện công cộng thay đổi thường xuyên, các chuyến đi bằng phương tiện công cộng hiện có có thể thay đổi theo thời gian và không có gì đảm bảo sẽ cung cấp kết quả nhất quán cho các dự đoán trước. |
| Bao gồm các tuyến đường thay thế | "computeAlternativeRoutes": true |
Không bắt buộc. Đặt thành true để yêu cầu Compute Routes 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 di chuyển khác, thậm chí chỉ sử dụng các phương thức di chuyển khác, tuỳ thuộc vào hiệu quả của tuyến đường và tình trạng còn trống 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 ưu tiên bằng phương tiện công cộng. Tìm hiểu thêm |
| Chỉ định lựa chọn ưu tiên cho tuyến đường đi bằng 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ề định tuyến cho phương tiện công cộng. Tìm hiểu thêm |
Ví dụ: Xem tuyến đường trên phương tiện công cộng
Ví dụ sau đây lấy một tuyến đường trên phương tiện công cộng có các tham số sau:
Chỉ định lựa chọn ưu tiên cho việc đi bằng tàu hoả và ít đi bộ.
Yêu cầu tuyến đường thay thế.
Cung cấp một mặt nạ trường trả về thông tin chi tiết về phương tiện công cộng:
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 đường:
{ "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 } }, {}, {}, {}, {}, {}, {} ] } ] } ] }