{"id":22737524,"url":"https://github.com/bp-stations/station-data","last_synced_at":"2026-07-06T08:00:28.562Z","repository":{"id":115422419,"uuid":"520531470","full_name":"bp-stations/station-data","owner":"bp-stations","description":"Generate station data.","archived":false,"fork":false,"pushed_at":"2026-06-01T06:56:46.000Z","size":117775,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-06-01T08:25:52.626Z","etag":null,"topics":["aral","bp","gas","station"],"latest_commit_sha":null,"homepage":"https://mein-auto-tanken.de/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bp-stations.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2022-08-02T14:28:30.000Z","updated_at":"2026-03-18T17:34:48.000Z","dependencies_parsed_at":"2023-12-18T03:29:55.911Z","dependency_job_id":"f0d3d4ad-3169-41aa-8f9a-9dc98b83430e","html_url":"https://github.com/bp-stations/station-data","commit_stats":{"total_commits":39,"total_committers":1,"mean_commits":39.0,"dds":0.0,"last_synced_commit":"086422926691ee5d9c652b95ec59427c125b1ce1"},"previous_names":["aral-preise/aral-station-data"],"tags_count":250,"template":false,"template_full_name":null,"purl":"pkg:github/bp-stations/station-data","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bp-stations%2Fstation-data","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bp-stations%2Fstation-data/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bp-stations%2Fstation-data/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bp-stations%2Fstation-data/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bp-stations","download_url":"https://codeload.github.com/bp-stations/station-data/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bp-stations%2Fstation-data/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35182322,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-06T02:00:07.184Z","response_time":106,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["aral","bp","gas","station"],"created_at":"2024-12-10T22:15:22.257Z","updated_at":"2026-07-06T08:00:28.540Z","avatar_url":"https://github.com/bp-stations.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch3 align=\"center\"\u003eStation Data\u003c/h3\u003e\n\n\u003cdiv align=\"center\"\u003e\n\n  [![Status](https://img.shields.io/badge/status-active-success.svg)]() \n  [![License](https://img.shields.io/github/license/bp-stations/station-data)](/LICENSE)\n  [![Last data release](https://img.shields.io/github/release-date/bp-stations/station-data)]()\n\n\u003c/div\u003e\n\n---\n\n\u003cp align=\"center\"\u003e This is the data fetcher for all \u003ca href=\"https://www.bp.com/\"\u003eBP\u003c/a\u003e gas stations.\n    \u003cbr\u003e \n\u003c/p\u003e\n\n## 📝 Table of Contents\n- [About](#about)\n- [Getting Started](#getting_started)\n- [Deployment](#deployment)\n- [Usage](#usage)\n- [Built Using](#built_using)\n- [Affiliation](#affiliation)\n\n## 🧐 About \u003ca name = \"about\"\u003e\u003c/a\u003e\nThis program is fetching all [BP](https://www.bp.com/) gas stations from the [Aral](https://www.aral.de/) \"tankstellenfinder\" api.\nThe data is saved in the following formats: ``json`` and ``ov2``.\n\n## 🏁 Getting Started \u003ca name = \"getting_started\"\u003e\u003c/a\u003e\nThese instructions will get you a copy of the project up and running on your local machine for development and testing purposes. See [deployment](#deployment) for notes on how to deploy the project on a live system.\n\n### Prerequisites\nWhat things you need to install the software and how to install them.\n\n``python3`` is required.\n\n### Installing\n\nInstall the required packages by running:\n\n```\npip install -r requirements.txt\n```\n\n## 🎈 Usage \u003ca name=\"usage\"\u003e\u003c/a\u003e\nYou can now run the data fetcher with ``python main.py``\n\nThe data will be saved in ``./out/json`` and ``./out/ov2``.\n\n### Program structure:\n\n````commandline\n/\n    /main.py # gets all stations and automatically sorts them in /out\n    /generator.py # generates the following files in /out/other: sitemap.xml, facilities.json and fuel.json\n    /database.py # generates a sqlite3 file based on \"stations_ARAL Tankstelle_min.json\" which is used in \"aral-prices\"\n````\n\n### Directory structure:\n````commandline\nout/\n    /json\n        /all\n            /stations.json # these are all BP Stations worldwide\n        /brands\n            /stations_BP.json # all stations with the Brand BP\n            /stations_ARAL Tankstelle.json # all stations from the Brand Aral\n        /countries\n            /stations_DE.json # all German stations from all brands\n            /stations_US.json # all stations in the US from all Brands\n        /other # used in another project\n    /ov2 # \n        /all\n            /stations.ov2 # these are all BP Stations worldwide\n        /brands\n            /stations_BP.ov2 # all stations with the Brand BP\n            /stations_ARAL Tankstelle.ov2 # all stations from the Brand Aral\n        /countries\n            /stations_DE.ov2 # all German stations from all brands\n            /stations_US.ov2 # all stations in the US from all Brands\n````\n\nThere is always a ``_min.json`` available (e.g. `stations_min.json`) that has the whole JSON on a single line.  \nUse the default file for better readability.\n\nThe ``.ov2`` files have skipper records, so performance should be good.\n\nYou can find the data [here](https://github.com/bp-stations/station-data/tree/gh-pages).\n\nThere is also a [README.md](https://github.com/bp-stations/station-data/tree/gh-pages/json/README.md) in the data that has basic stats.\n\n### Data accuracy\n\nThe data may not be accurate as the script calls the [gas station locator API](https://mein.aral.de/tankstellenfinder/) and this can be prone to errors.  \n  \nPlease note that there may be stations missing!\n\n## 🚀 Deployment \u003ca name = \"deployment\"\u003e\u003c/a\u003e\nYou can see a example deployment at [./.github/workflows/generate.yml](./.github/workflows/generate.yml)\n\n### Cron\n\nThe data is updated by [this](./.github/workflows/generate.yml) GitHub action.  \nThe version is automatically bumped by [this](https://github.com/bp-stations/station-data/blob/main/.github/workflows/version.yml) GitHub action on cron '0 2 * * 1'.\n\n## Style\nThe code is formatted and checked with [ruff](https://github.com/astral-sh/ruff)s default settings.\n\n## ⛏️ Built Using \u003ca name = \"built_using\"\u003e\u003c/a\u003e\nNone\n\n## Affiliation \u003ca name = \"affiliation\"\u003e\u003c/a\u003e\nI am not affiliated with the Aral Aktiengesellschaft nor the BP p.l.c.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbp-stations%2Fstation-data","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbp-stations%2Fstation-data","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbp-stations%2Fstation-data/lists"}