Yêu cầu chung

Đối tác chỉ được cung cấp cho chúng tôi một bộ nguồn cấp dữ liệu duy nhất và bộ nguồn cấp dữ liệu đó phải tuân thủ GBFS phiên bản 2.2 cho hệ thống có trạm sạc hoặc không có trạm sạc. Tập hợp này chỉ được chứa một tệp cho mỗi loại. Ví dụ: chỉ được chứa một station_information.json. Do giới hạn về số lượng tệp, một nhóm nguồn cấp dữ liệu nhất định sẽ có các hạn chế sau:

  • Nguồn cấp dữ liệu chỉ được giới hạn ở một bộ tệp GBFS duy nhất có các trường được xác định bằng ngôn ngữ tại địa phương của thành phố mà nguồn cấp dữ liệu đó bao gồm, nếu có. Ví dụ: nếu một nguồn cấp dữ liệu bao gồm cả Vương quốc Anh và Đức, thì stations[].name phải chứa tên trạm sạc bằng tiếng Anh cho các trạm sạc ở Vương quốc Anh và bằng tiếng Đức cho các trạm sạc ở Đức.
  • Nhóm nguồn cấp dữ liệu phải toàn diện đối với các khu vực đô thị mà nhóm đó bao gồm. Google cho phép phân đoạn nguồn cấp dữ liệu khi cần thiết. Mỗi phân đoạn phải bao phủ một khu vực dịch vụ địa lý có kích thước ít nhất bằng một khu vực đô thị hoặc lớn hơn. Để biết thêm thông tin về việc phân đoạn, hãy tham khảo bài viết Phân đoạn nguồn cấp dữ liệu.

Định nghĩa các loại dữ liệu có cấu trúc

Để tạo thành công nguồn cấp dữ liệu, bạn phải tuân thủ bộ định nghĩa loại dữ liệu có cấu trúc hiện hành mà chúng tôi cung cấp. Trong định nghĩa GBFS, tất cả các tệp trong GBFS phiên bản 2.2 đều được liệt kê cùng với thông tin cho biết hệ thống nào áp dụng các tệp đó trong tiêu đề với các hoán vị sau:

  • Hệ thống được gắn đế
  • Hệ thống không cần đế sạc
  • Hệ thống có trạm sạc và không có trạm sạc

Ví dụ: nếu nhà cung cấp sử dụng hệ thống không có đế sạc, bạn chỉ được cung cấp những tệp được chỉ định cho Dockless system hoặc Dockless and docked systems để mô tả hệ thống. Để biết thêm thông tin, hãy tham khảo bài viết Các hệ thống phương tiện siêu nhỏ được hỗ trợ.

Mỗi phần trong định nghĩa GBFS cung cấp các định nghĩa về loại dữ liệu có cấu trúc mà bạn cần để tạo thành công một nguồn cấp dữ liệu hoàn chỉnh. Tài liệu này bao gồm các định nghĩa và hướng dẫn dành riêng cho loại nhà cung cấp của nguồn cấp dữ liệu.