isabella232 / micro-mobility-demo

Open source code for Mapbox's micro-mobility Android demo app

Micro-Mobility-Demo

This repo contains Mapbox's Android micro-mobility demo app, which goes hand-in-hand with the written guide: https://blog.mapbox.com/build-the-ultimate-micro-mobility-app-af71f92b858f

Building the app on your device

• Clone this repo and open the project in Android Studio.

• Create or log into your Mapbox account and retrieve your default Mapbox access token at https://www.mapbox.com/account/access-tokens/.

• Go to the R.strings.xml file in Android Studio (app/src/main/res/values/strings.xml) and paste your access token in the mapbox_access_token String resource.

<string name="mapbox_access_token" translatable="false">PASTE_YOUR_MAPBOX_TOKEN_HERE</string>

• At this point, the project should compile in Android Studio and open on your real or emulated device.

Miscellaneous info:

• There is no equivalent project for iOS, but the Mapbox Maps SDKs for iOS and Android have "feature parity". What can be done in this project can also be done on iOS devices.

• The app has lots of toggling which leads to various control flow statements (if/else, etc). Don't worry! If you’re building a similar app, your code will probably be cleaner because you’ll decide to permanently include features which are toggleable in this app.

• Bikes and scooters are used in this project, but the project is agnostic to the mode of transportation. The global mobility craze includes pedal bikes, electric mopeds, electric-assisted pedal bikes, electric push scooters, heavy-duty electric push scooters, and more. This project can be adjusted for any type of transportation.

Contributing

Pull requests and issue reporting are both welcomed! Please see the contributing guide for more information about contributing to this project.

Inside the app