Explore is a simple app that helps you find beautiful places to visit.
Java
Switch branches/tags
Nothing to show
Clone or download
vgrec Add screenshots
Update README.md

Update README.md

Update README.md

Update README.md

Update README.md
Latest commit ed48221 Feb 13, 2016

README.md

Explore

Explore is a simple application that helps you find beautiful places to visit!

The way it works is very simple: you enter your wish, which might be a country, a city, or a location you would like to visit, and the app will return back a list of nice things about that place.

The data is pulled from several sources:

  • Youtube for videos
  • Flickr for photos
  • Wikipedia for description, and
  • Google Places for attractions (eg. museums, restaurants, etc)
Summary screen Details Screen

Disclaimer

Please note that since the application uses data from different sources unrelated to each other, especially for a less known search term, the presented results sometimes might appear inconsistent. For example Google Places might return one thing, but the description returned by Wikipedia to relate to another thing. If you are going to make a decision based on the information provided by this app, always check if the provided information is correct.

Libraries used

Some of the libraries used in this project are:

  • Volley for making asynchronous HTTP calls and image loading
  • EventBus for communicating between different layers
  • ButterKnife for view injection
  • Palette for extracting prominent colors from an image

Building the project

In order to successfully build the project a few API keys have to be provided (Flickr, Youtube, Google Places). The API keys are expected to be defined in a file called keys.propreties located in the project's root directory.

Explore/keys.properties

places_api_key=[your api key]
youtube_api_key=[your api key]
flickr_api_key=[your api key]

License

Copyright 2015 - 2016 Veaceslav Grec

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.