Tuyến đường đi bằng phương tiện công cộng cung cấp hướng dẫn đường đi 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 lựa chọn 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 lựa chọ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 đi bộ đến, đi từ và giữa các trạm dừng phương tiện công cộng. Vì một tuyến đường giao thông 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.
Điểm 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 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 đường sử dụng các lựa chọn chế độ di chuyển khác.
Bạn không thể yêu cầu tất cả các đối tượng và lựa 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 đường khác.
Trong Routes API, các bước luôn là một chỉ dẫn điều hướng trên 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 đường đi bằng phương tiện công cộng rất giống với các tuyến đường có phương thức di chuyển khác, nhưng có một số điểm khác biệt chính:
| Yêu cầu về sự khác biệt | 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 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 có chứa thông tin tóm tắt về các bước của 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 stepsOverview). |
| Không thể chỉ định cách thức và 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 của tuyến đường cần tránh | |
Chỉ có thể chỉ định transitPreferences. Để biết thông tin chi tiết, hãy xem TransitPreference. |
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
travelModethànhTRANSIT. - Thêm các mặt nạ trường thích hợp để nhận được phản hồi bạn cần. Xem phần Yêu cầu các trường tuyến đường vận chuyển mà bạn cần.
- Nếu cần, hãy đặt các tham số không bắt buộc. Xem phần Đặt thông số cho tuyến đường giao thông công cộng
Yêu cầu các trường thông tin về tuyến đường giao thông công cộng mà bạn cần
Yêu cầu các trường tuyến đường giao thông 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ố câu trả lời đề xuất cho tuyến đường giao thông công cộng và mặt nạ trường cần dùng để yêu cầu các câu trả lờ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. | * |
| Thông tin chi tiết về phương tiện công cộng cho các đoạn đường. | legs |
| Giá vé ước tính cho từng bước của tuyến đường và giá vé ước tính theo ngôn ngữ địa phương. | travelAdvisory |
| Văn bản được bản địa hoá cho thời lượng và khoảng cách | localizedValues |
Đặt thông số cho tuyến đường sử dụng phương tiện công cộng
Sau đây là các tham số liên quan cho tuyến đường giao thông 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: new Date(yyyy-mm-ddThh:mm:ssZ)
HOẶC departureTime: new Date(yyyy-mm-ddThh:mm:ssZ) |
Không bắt buộc. Bạn có thể chỉ định thời gian đến hoặc thời gian khởi hành. Nếu không chỉ định thời gian nào, departureTime 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à đi trong khung thời gian sau, với thời gian thực thi hiện tại (now) làm tham chiếu:
Date.
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 có thể thay đổi theo thời gian và không có gì đảm bảo rằng kết quả dự đoán sẽ nhất quán trong thời gian dài. |
| Bao gồm các tuyến đường thay thế | computeAlternativeRoutes: true |
Không bắt buộc. Đặt thành true để computeRoutes 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 | transitPreference: {allowedTransitModes: ["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, 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à khả năng cung cấp phương thức di chuyển ưu tiên. |
Không bắt buộc. Chỉ định phương tiện di chuyển công cộng mà bạn muốn dùng. Tìm hiểu thêm |
| Chỉ định lựa chọn ưu tiên cho tuyến đường phương tiện công cộng | transitPreference: {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 phương tiện công cộng. Tìm hiểu thêm |
Ví dụ về yêu cầu
Ví dụ sau đây cho thấy cách yêu cầu một tuyến đường giao thông công cộng:
const request = { origin: 'Hunters Point San Francisco, CA 94124', destination: '201 Marine Dr, San Francisco, CA 94129', travelMode: 'TRANSIT', departureTime: new Date(), transitPreference: { allowedTransitModes: ['BUS', 'SUBWAY', 'TRAIN', 'LIGHT_RAIL', 'RAIL'], routingPreference: 'FEWER_TRANSFERS', // Alternatively, 'LESS_WALKING'. }, fields: ['path', 'legs', 'travelAdvisory', 'localizedValues'], };