Hướng dẫn này giải thích cách tích hợp với Google để mang đến cho người dùng trải nghiệm tìm kiếm thông tin vận chuyển liền mạch trên nhiều nền tảng của Google, bao gồm cả Google Maps và Google Tìm kiếm. Nhìn chung, các quy cách tích hợp chính bao gồm:
- Hai lựa chọn để cung cấp dữ liệu tĩnh:
- Tích hợp dựa trên GTFS: Cung cấp nguồn cấp dữ liệu GTFS có các tiện ích bán vé, trong trường hợp bạn là nhà cung cấp dữ liệu lịch trình. Chúng tôi có một số yêu cầu bổ sung đối với việc tích hợp dựa trên GTFS.
- Chỉ tích hợp điểm dừng: Chỉ cung cấp danh sách điểm dừng, trong trường hợp Google đã có dữ liệu lịch trình từ một nguồn khác.
- Quy cách Partner API để cung cấp dữ liệu động:
- Cấu hình đối tác: Cung cấp thông tin về đối tác, chẳng hạn như thông tin xây dựng thương hiệu và chi tiết liên hệ.
- Máy chủ đối tác: Triển khai các máy chủ hỗ trợ API Máy chủ đối tác.
Các bước để tích hợp với Travel Transport
Sau đây là thông tin tổng quan về các bước cần thiết để xây dựng và kiểm thử một hệ thống toàn diện nhằm hỗ trợ các tính năng về giao thông vận tải của Google. Có 3 bước chính để tích hợp:
- Xem xét các yêu cầu tham gia.
- Cung cấp nguồn cấp dữ liệu tĩnh cho Google.
- Hỗ trợ Travel Transport API để cho phép truy vấn động dữ liệu thay đổi nhanh như giá và tình trạng còn chỗ. API này sử dụng các giá trị nhận dạng do nguồn cấp dữ liệu tĩnh cung cấp từ bước 1, ví dụ:
ticketing_stop_idđể xác định các điểm dừng.
1. Yêu cầu khi tham gia
Đơn vị tính năng về giao thông vận tải của Google hiển thị hành trình và các lựa chọn đặt vé kèm theo giá. Để hiển thị sản phẩm trong danh sách, bạn cần có một đường liên kết chất lượng cao và giá cuối cùng phù hợp. Để biết thêm thông tin chi tiết, hãy xem các yêu cầu để tham gia.
2. Cung cấp nguồn cấp dữ liệu tĩnh
Có hai cách để cung cấp dữ liệu tĩnh, mỗi cách áp dụng trong những trường hợp cụ thể. Tiêu chí chính để quyết định sử dụng lựa chọn nào là liệu bạn có phải là nhà cung cấp dữ liệu lịch trình cho các mối nối giao thông công cộng mà bạn muốn cung cấp chức năng đặt vé hay không. Cách dễ nhất để kiểm tra xem Google đã có dữ liệu lịch trình hay chưa là thử tìm các mối kết nối cho một nhà điều hành cụ thể trên Google Maps.
| Tính năng | Tích hợp dựa trên GTFS | Chỉ tích hợp tính năng dừng |
|---|---|---|
| Trường hợp sử dụng | Bạn đã cung cấp GTFS kèm theo lịch trình và thông tin bán vé. | Google đã có dữ liệu lịch trình của nhà điều hành từ một nguồn khác. |
| Dữ liệu bắt buộc | Mã GTFS. | Danh sách mã nhận dạng điểm dừng, kèm theo toạ độ địa lý. |
| Nỗ lực | Thấp | Phương tiện |
Lựa chọn 1 áp dụng nếu bạn là nhà cung cấp nguồn cấp dữ liệu GTFS cho một đơn vị vận hành. Trong trường hợp này, trước tiên, bạn cũng cần thiết lập một nguồn cấp dữ liệu GTFS để cung cấp thông tin về lịch trình cho Google. Sau đó, hãy làm theo hướng dẫn trong phần tích hợp dựa trên GTFS.
Lựa chọn 2 áp dụng nếu Google đã nhận được dữ liệu lịch trình của nhà điều hành từ một nguồn khác. Trong trường hợp này, chúng tôi không cần thông tin đầy đủ về lịch trình, nhưng vẫn cần danh sách mã nhận dạng điểm dừng mà chúng tôi có thể sử dụng trong Travel Transport API (xem bên dưới). Để cung cấp danh sách các điểm dừng, hãy làm theo hướng dẫn trong phần Tích hợp chỉ điểm dừng.
3. Hỗ trợ Travel Transport API
Để được liệt kê là đối tác đặt vé có giá trong Đơn vị vận chuyển, Google cần có thể tìm nạp thông tin mới nhất về giá và tình trạng còn chỗ của đối tác. Để bật tính năng này, đối tác phải cung cấp một dịch vụ triển khai API Máy chủ đối tác.
3.1. Triển khai Partner Server API
Bạn có thể xem thông tin chi tiết về cách triển khai Partner Server API trong Tài liệu tham khảo về API và trong Hướng dẫn về máy chủ đối tác. API này cho phép Google lấy thông tin mới nhất về giá và tình trạng còn phòng của đối tác, đồng thời Google sẽ gọi API này để:
- Tạo bộ nhớ đệm để nhanh chóng trả về giá.
- Nhận mức giá mới nhất khi người dùng nhấp vào một hành trình cụ thể.
Bạn phải triển khai Partner Server API nếu đối tác muốn Google hiển thị giá.
3.2. Xác thực và thử nghiệm API
Khi quá trình triển khai API của bạn gần hoàn tất và dịch vụ triển khai API đang hoạt động, vui lòng liên hệ với transport-help@google.com để cung cấp thông tin về máy chủ để chúng tôi có thể bắt đầu xác thực quá trình triển khai của bạn.
Trong tương lai, chúng tôi dự định cung cấp công cụ tự động để xác thực việc triển khai API của bạn, nhưng công cụ này hiện chưa được cung cấp.