Skip to content

Latest commit

 

History

History
124 lines (87 loc) · 4.59 KB

README.md

File metadata and controls

124 lines (87 loc) · 4.59 KB

Loc Genie

Copyright (C) 2014 Srividya Sundaram

LocGenie – An open source Android application that suggests users places of their preferred activity within their preferred distance in Map View along with their address.Also displays places dynamically whenever user drags the map view to a different region.

Coding was done in JAVA with Android API Level 20.

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.

Following is the link for the repository: https://github.com/Srividya2212/LocationFinder

Please, see the file license in this distribution for license terms. Link is https://github.com/Srividya2212/LocationFinder/blob/master/LICENSE.md

References: https://developers.google.com/maps/documentation/android/start#getting_the_google_maps_android_api_v2 https://developers.google.com/maps/documentation/android/ https://developers.google.com/places/documentation/ https://developers.google.com/places/documentation/search http://stackoverflow.com/questions/9605913/how-to-parse-json-in-android

Author - Srividya Sundaram email: [email protected]


Names:

Srividya Sundaram

Project Name:

LocGenie

Contact Information:

[email protected]

Project Description:

LocGenie is an Android app that suggests users places for hiking, camping, fishing, bowling or an RV-Park from their current location. The user is given the option of choosing one of the activity - Hiking, RV-Park, Camping, Fishing, Bowling. The app also allows the user to enter his/her preferred distance within which they are looking for places. LocGenie displays the suggestions in a Map along with their address.

The application is developed in JAVA. Google Places API and Google Maps Android API v2 is used to fetch places and display them in Map View. The suggested places are highlighted using map markers.

License Information:

Please check the below link to get the file license in this distribution. Link : https://github.com/Srividya2212/LocationFinder/blob/master/LICENSE.md

Source Code:

The source code can be found at the following repository Link for repository : https://github.com/Srividya2212/LocationFinder/tree/master/MainActivity

Developer Documents:

Please click on the links below to find developer documents Github Manual https://github.com/Srividya2212/LocationFinder/blob/master/Docs/GitHub_Manual.pdf

Google Maps API Key Generation https://github.com/Srividya2212/LocationFinder/blob/master/Docs/GoogleMapsAPIKeyGeneration.pdf

Google Places API Key Generation https://github.com/Srividya2212/LocationFinder/blob/master/Docs/GooglePlacesAPIKeyGeneration.pdf

User Documents:

Please click on the links below to find user documents: Guide for .apk installation: https://github.com/Srividya2212/LocationFinder/blob/master/Docs/Guide%20for%20APK%20Installation.pdf

Build Instruction:

Click on the link below to find Build Instruction https://github.com/Srividya2212/LocationFinder/blob/master/Docs/InstallationGuideForDevelopers.pdf

User Manual

https://github.com/Srividya2212/LocationFinder/blob/master/Docs/User%20Manual.pdf

Pre-requisites

  1. Internet Connection.
  2. Android device.
  3. Google Play Services installed in the android device.
  4. Your own Google Places API Key and Google Maps API Key generated from your Google account.

Future Enhancements:

  1. Add more activities that can be chosen.(rafting, parasailing etc)
  2. Calculate distance from users current location to the suggested places.
  3. Predict climatic conditions of those places on the current day and suggest the best place to visit among all the places suggested.
  4. Suggest nearby eat outs along with the places.

Issue Tracker/Bug Tracker

https://github.com/Srividya2212/LocationFinder/labels/bug

Final Presentation:

https://github.com/Srividya2212/LocationFinder/blob/master/Docs/Loc%20Genie_ppt.pptx