Bus Time Bot is a telegram bot that tells you bus timings of the nearest bus stops based on the location (GPS coordinates) you send to it.

Currently supports bus timings for NUS, NTU, SBS Transit and SMRT Buses.

Try it out at https://t.me/bus_time_bot

1. Clone the project
2. Create a file key.properties in the project's root folder and go to the links below to get a token
   • LTA Token: https://www.mytransport.sg/content/mytransport/home/dataMall.html
     • Under "Real-Time/Dynamic Data", select "Request for API access"
   • Telegram Bot Token: http://telegram.me/BotFather
     • Create a new bot using the command '/newbot' (if you do not currently have a Telegram bot)
     • Retrieve a token for your bot using the command '/token'
3. Fill the contents of key.properties like this:

lta=<<insert lta token here>>
telegram=<<insert telegram token here>>
#either 'true' or 'false' (defaults to false)
use_database=false

4. Run!

Automated JUnit 4 testing development in progress

Functions to check

• Sending a location (Public)
• Sending a location (NUS)
• Sending a location (NTU)
• Searching by popular location (amk hub)
• Searching by postal code (118426)
• Searching by address (Blk 1 Hougang Ave 1)
• Searching by bus stop number (63151)
• Look up bus info for Public Transit (1 way, 112)
• Look up bus info for Public Transit (2 way, 854)
• Look up bus info for NUS (A1)
• Look up bus info for NTU (CWR)

• start/help - See what you can do with this bot
• search - Search by popular locations, postal codes, address, bus stop number
• bus - Look up bus information

• Ensure that key.properties file is in the same directory as the BusTimeBot.jar file
• Run the jar file using command: java -jar BusTimeBot.jar

• Java Telegram Bot API - The telegram bot framework
• GSON - Parsing of json data retrieved from the bus timing services
• Emoji Java - Used to generate the emoji unicode for the text
• Jsoup - Used for parsing public bus information from the SBSTransit website
• LTA Datamall, SBSTransit and NUS/NTU Bus Services for arrival time information

Feel free to pull the project, I will merge the project if the feature is a good one

Bus Time Bot does indeed log your personal information. I use this data to see what improvements can be made to improve the user experience of this bot. Rest assured that I will not sell this data for any profit or monetary gain to a 3rd party.

Bus timing from various organizations are retrieved from their respective servers. I am not responsible for the inaccuracy of the timings stated by the bot.

• Bernard Yip - Initial work - bernardyip
• Lim Miao Ling - System Testing - limmlingg
• Angus Ng - Landing Page - angusngjj

No License at the moment

• Telegram for allowing me to develop bots for their platform
• My friends who gave me inspiration for this bot
• Authors of the libraries that I have used for making this bot possible
• Hostgagements for promoting this application to their clients!