Coder Social home page Coder Social logo

it-at-m / kindona Goto Github PK

View Code? Open in Web Editor NEW
11.0 5.0 7.0 19.75 MB

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.

License: MIT License

Kotlin 0.09% Swift 0.96% Objective-C 0.03% Dart 68.98% HTML 1.28% CMake 13.02% C++ 14.66% C 0.99%
indoor-localization indoor-navigation indoor-positioning

kindona's Introduction

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".

  1. Open an issue with the tag "enhancement"
  2. Fork the Project
  3. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  4. Commit your Changes (git commit -m 'Add some AmazingFeature')
  5. Push to the Branch (git push origin feature/AmazingFeature)
  6. 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 - [email protected]

kindona's People

Contributors

gregatm avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar

kindona's Issues

can you please provide sample map ?

Is your feature request related to a problem? Please describe.
I was trying out Kindona and would absolutely appreciate a sample map. I'm not able to generate a mapforge map.

Describe the solution you'd like
assets/maps/campus_e.map a sample map added.

Describe alternatives you've considered
A clear and concise description of any alternative solutions or features you've considered.

Additional context
Add any other context or screenshots about the feature request here.

Application not starting

I locally setup the project and tried to run it on a physical device with flutter run

And also build the apk with flutter build apk

But now while running the application it just shows a blank white screen, I also allowed the permissions for location and nearby devices, Is there anything else I need to setup?

Unable to run project at fresh clone

Describe the bug
It seems like the current flutter is having conflict with mapsforge_flutter: 2.0.2, which causing build error.

To Reproduce
Steps to reproduce the behavior:
Clone the project from the original repo

Expected behavior
Able to run without throwing error

Screenshots
Screenshot 2024-03-14 at 9 53 47 AM

Additional context
Flutter (Channel stable, 3.19.3, on macOS 14.4 23E214 darwin-arm64, locale en-MY)

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.