it-at-m/Kindona
Kindona is a flutter-based application for helping users orientate inside of buildings. It provides the user with a map (like google maps and the like), with the option to differentiate between the different floors inside the building.
Kindona
Kindona is a flutter-based application for helping users orientate inside of buildings. It provides the user
with a map (similar google maps and the like), with the option to differentiate between the different
floors inside the building.
Table of Contents
How can I use Kindona?
Kindona provides the framework for visualising and navigating the building, but it is missing the data
of the building. This has to be provided by you. As soon as you have build the map, you can just
drop the resulting map in the app, build and run the app. No coding needed.
Creating the map
The app builds upon the mapsforge_flutter widget
which uses mapsforge which in turn
uses the OpenStreetMap project. So quite a stack to navigate through but good news, its opensource
all the way down.
The general process of creating a mapsforge compatible map is explained
here, though it only
describes cropping and converting an existing OSM-Map to the mapsforge format. Additionally, you
want to include your own custom data for the inside of the building which usually is not covered by
the OSM maps. Therefore another guide was written to cover that part and can be found
here in the repository.
Features
- Map of the building
- Floor selection for detailed view
- Room search
- Path finding between rooms
- Showing your current location
- Path finding between your current location and a room
- Displaying room information (WIP)
How to build
The application is based on flutter which is required to build the app.
Once flutter is properly set up you can run the app with
flutter run
Target platforms
The primary development platform is android.
iOS and web compatibility is planned
Contributing
Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.
If you have a suggestion that would make this better, please open an issue with the tag "enhancement", fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement".
- Open an issue with the tag "enhancement"
- Fork the Project
- Create your Feature Branch (
git checkout -b feature/AmazingFeature) - Commit your Changes (
git commit -m 'Add some AmazingFeature') - Push to the Branch (
git push origin feature/AmazingFeature) - Open a Pull Request
The Flutter Team has a great guide here how to set up everything needed.
We also would suggest looking into the Flutter Team's style guide here
More about this in the CODE_OF_CONDUCT file.
License
Distributed under the MIT License. See LICENSE file for more information.
Contact
it@M - opensource@muenchen.de