BAS.MY Open Data: Ridership Statistics

This project provides open, machine-readable ridership statistics for the BAS.MY bus services in various Malaysian cities.

Disclaimer

This is an independent, community-driven project and is not an official open data initiative by the Agensi Pengangkutan Awam Darat (APAD). While the data is sourced from official publications, this project is not affiliated with or endorsed by APAD.

Data Files

The ridership data is available in two formats:

• JSON: Machine-readable data, ideal for software integration and analysis. Located in the json/ directory.
  • json/yearly_ridership.json: Contains the total number of passengers, aggregated by year and by month.
  • json/daily_average_ridership.json: Contains the average number of daily passengers, aggregated by year and by month.
• Markdown: The original, human-readable source files. Located in the markdown/ directory.
  • markdown/mybas-statistics-jumlahpenumpangtahunan.md
  • markdown/mybas-statistics-puratapenumpangharian.md

Data Manifest

To assist AI agents in discovering and understanding the data files in this repository, a manifest file is provided in the root directory:

• manifest.json: A machine-readable JSON file that lists all data files, their paths, and a brief description of their contents.

This file is intended to be used by AI agents to programmatically locate and interpret the data, making it easier to integrate with this repository.

Accessing Data via MCP

For AI agents and other automated systems, the data in this repository can be accessed programmatically using a Model Context Protocol (MCP) server for GitHub.

I recommend using the GitHub MCP server by Smithery.ai:

• Server URL: https://smithery.ai/server/@smithery-ai/github

You can use this server's tools (e.g., get_file_contents) to read the JSON files directly from the repository.

• Owner: hithereiamaliff
• Repo: basmy-opendata

Covered Networks

The ridership statistics currently include data for the following BAS.MY service areas:

• Ipoh
• Johor Bahru
• Kangar
• Kota Bharu
• Kota Setar
• Kuala Terengganu
• Melaka
• Seremban

Excluded Networks

Please note that the following BAS.MY networks are not included in the current dataset yet, but may be added in the future statistic counts:

• Kuching
• Kota Kinabalu

JSON Schema

The data in the JSON files follows a consistent schema, detailed below:

{
  "last_updated": "YYYY-MM-DD",
  "source": "Agensi Pengangkutan Awam Darat (APAD)",
  "statistic_type": "total_passengers" | "average_daily_passengers",
  "data": {
    "yearly": [
      {
        "year": 2019,
        "locations": {
          "Ipoh": 1955306,
          "Kangar": 349562,
          // ... other locations
        },
        "total": 5386684
      }
    ],
    "monthly_YYYY": [
      {
        "month": "Jan-YY",
        "locations": {
          "Ipoh": 60449,
          // ... other locations
        },
        "total": 869485
      }
    ]
  }
}

Acknowledgements

The data presented in this project is sourced from the official infographics and statistics published by the Agensi Pengangkutan Awam Darat (APAD). The original source material can be found on their official website:

• APAD - Info Grafik & Statistik

We extend our gratitude to APAD for making this data publicly available.

License

This project is licensed under the MIT License. See the LICENSE file for details.