konhi / poland-public-transport-api Goto Github PK

View Code? Open in Web Editor NEW

24.0 2.0 3.0 1.56 MB

🚌 • community maintained APIs for Poland's public transport

Home Page: https://poland.transport.rest

JavaScript 1.36% TypeScript 98.64%

poland public-transportation public-api transit gtfs fptf open-data transport zielonagora rest-api

poland-public-transport-api's Introduction

👋 Heya! I'm Jan

I'm actively looking for:

like-minded friends
interesting projects
business opportunities

Feel free to contact me via e-mail, Discord (konhi#1588) or Twitter. I'm always happy to hear from YOU! 💕

👨‍💻 For Developers

🚌 Poland's Public Transport API: serverless, community maintained APIs - Cloudflare Workers (Cloud Functions as a Service), Zod (type validation & safety). GitHub Actions (CI/CD) for instant deployment. Previously used Express (web app framework) on Azure.
🎒 School Website Starter: accessible and extremely user-friendly website template for schools in Poland, built on fun and modern stack - uses React, Next.js, Storybook (React Components Management & Testing), Strapi (Headless CMS), and Vercel.
▲ React Static Clutch Embed: Say goodbye to iframes! Save +400 KBs (network) & +250 ms (rendering) while embeding Clutch.co widgets.

✨ Projects

🔌 IoT-based smart energy consumption monitor: (progressive) web app available on desktop and mobile - InfluxDB, Grafana, React, Next.js, MUI, Vercel... and more!
📰 School News to Discord: serverless website parser that sends announcements to students - uses GitHub Actions (CI/CD), Discord.js (API), Jest (tests)

👨‍🎨 Design

I like designing user interfaces! You can check my portfolio on Dribbble!

👅 Language Learning

I'm currently working on @frekwencja - project that tries to help in effective learning new languages by using cool methods, such as flashcards and most common words

🃏 Language Learning Flashcards: powerful flashcards in many formats for intelligent language learning!
🏆 Most Common Words Multilingual Dataset: 5050 most frequent words in 109 languages. Uses Python and Pandas (data analysis and manipulation).

✒ Obsidian

I use Obsidian as note-taking, journaling, creativity and planning tool. You might find these things useful!

Tools

📃 Obsidian Community List: updated list of community themes & plugins for obsidian.md! Uses GitHub Actions (CI/CD) and Generates Markdown!
📦 Obsidian Repositories Downloader: learn, analyze and inspire from every obsidian.md plugin! Parses .json files.

Docs

🕶️ Awesome Obsidian: Awesome stuff for Obsidian
🔮 Obsidian Community: Resource hub for Obsidian resources.

🎀 Misc

🇵🇱 awesome-school-projects-poland: wspaniałe projekty związane ze szkołami!
📝 personal-school-assignments: little bit of PHP, HTML, CSS, JS, and SQL I do in my school!

✨ Other

poland-public-transport-api's People

Contributors

Stargazers

Watchers

Forkers

wybran jenymacu imadofficial

poland-public-transport-api's Issues

Support for Kalisz (kalisz/mzk)

Similar to #7, check it out before.

https://kalisz.trapeze.fi/vm/main

provide absolute departure/arrival timestamps?

If I understood the API correctly, it currently doesn't respond with absolute date+time values (e.g. a UNIX timestamp or an ISO 8601 string).

https://github.com/konhi/poland-public-transport-api/blob/main/src/public/v1/openapi.json#L295-L303

Including them would allow clients to have their own "x min/sec" left logic, enabling internationalisation, offline-updating countdowns, etc. Is it possible given the upstream API?

minor suggestions

Thanks for this great API! With a few minor exceptions, it ran out-of-the-box!

I ran this API locally, but because the OpenAPI spec hard-codes the poland-public-transport-api.azurewebsites.net publicly deployed instance, and because that instance is currently down, the local OpenAPI playground doesn't work.

https://github.com/konhi/poland-public-transport-api/blob/main/src/public/v1/openapi.json#L19

Currently, there are two logging formats mixed: JSON-based general logs about the server starting etc., and CLF for the actual requests.

What do you think about unifying them into one format, so that people running instances can process all logs with one set of tooling?

Support for Wrocław

Real-time bus positions

POST https://mpk.wroc.pl/bus_position example body: busList[bus][]: 248

GTFS

Can be downloaded there, is updated frequently.

Related projects

⭐ Wroclive-server: excellent production-ready API that supports lines, stops, and vehicles - gets data from both GTFS and real-time bus positions endpoints
mpyk: real-time bus positions endpoints scraper
Home-Assistant-custom-components-iMPK: shows use of unofficial iMPK API

Projects I didn't do research on

https://e-s-r.pl/2015/03/17/wroclawskie-mpk-uwaga-nadjezdza-open-data/

Support for Gorzów Wielkopolski (gorzow/mzk)

We can easily integrate Gorzów Wielkopolski in our API, because it's alike with Zielona Góra API
It shouldn't require more than simply changing URLS to theirs
One could also look if they provide more routes (stops, departures, etc.) than Zielona Góra, and if it could be good to implement it into our API.

If anyone is interested in it, please leave a comment, so I can assign them into it and help with anything.

go to https://komunikacja.um.gorzow.pl/vm/main
using developer tools CTRL + SHIFT + I, go to network tab and look for requests - that way you can get routes you can implement into API

Support for Bieława

Check #7.

http://bielawa.trapeze.fi/bussit/web