Skip to content
This repository has been archived by the owner on Dec 18, 2023. It is now read-only.

bparmentier/OpenBikeSharing

Repository files navigation

This project isn't maintained anymore! Please have a look at BikeSharingHub (forked by @francoisfds).

OpenBikeSharing

Build Status

OpenBikeSharing is an Android application that displays the availability of shared bikes in your city.

It uses the CityBikes API that provides data for more than 400 cities in around 40 countries and displays this data in a list or on an OpenStreetMap layer thanks to the osmdroid library (multiple layers are available).

Download

OpenBikeSharing is available on F-Droid and Google Play. Signed APK's can also be found on GitHub in the Releases section.

Contribute

Issues

Bug reports and feature requests can be reported in Issues.

To contribute to the openbikesharing.org website, just switch to the gh-pages branch.

Translations

Translations are managed on Weblate. Please follow these instructions if you want to help.

Donations

Donations are always welcome and will help further development of OpenBikeSharing:

  • Bitcoin: 168utA5DWMVXLFVfQDahG5abEWUSk9Wcfm

Build

If you use Android Studio, you can import the project directly from GitHub.

Otherwise you can build it from the command line with Gradle.
Clone the repo and type:

./gradlew build

(You may need to chmod +x the gradlew script)

The Gradle script will take care of downloading the necessary libraries and will generate the APK's in app/build/outputs/apk.

Permissions

The following permissions are needed by OpenBikeSharing (those are the same that are required by osmdroid):

  • ACCESS_COARSE_LOCATION
  • ACCESS_FINE_LOCATION
  • ACCESS_WIFI_STATE
  • ACCESS_NETWORK_STATE
  • INTERNET
  • WRITE_EXTERNAL_STORAGE

Internet access is needed to download the map tiles and the stations. Location access is only used to locate you on the map. Access to the SD card is required by osmdroid to cache the tiles.