Nice Places Android App

Discover the culture around you

Nice Places helps you to discover the places of interest in your area briefly describing their history and characteristics.

This project was born in 2018 from the idea of two students from Siena, Italy. Our mission is to create a mobile application to help users discover historical and cultural places of interest in their vicinity and to provide brief information about them.

Nice Places is available as Android app and as a progressive web app in both Italian and English.

In 2022, the project became open source to allow anyone to contribute.

Join the Discord channel

📝 Copyright notice

The source code available in this repository is licensed under the MIT license, however this repository contains digital assets to which the following terms apply.

The logos, names and texts of Pro Loco Sovicille, Cammino d'Etruria and Pro Loco Murlo are used with the permission of the respective associations and belong to them.

The profile photos of people appearing on the site are used under their permission and belong to them.

The contents mentioned above MUST NOT be used outside the Nice Places project.

🛠️ Installation steps

1. Clone the repository.

   git clone https://github.com/niceplaces/android-app.git niceplaces-android-app

2. Get an API key for Google Maps for Android following this guide: Using API Keys  |  Maps SDK for Android  |  Google Developers.

3. Create the file google_maps_api.xml in folder app/src/main/res/values/ with the following content:

   <resources>
       <string name="google_maps_key" templateMergeStrategy="preserve" translatable="false">[YOUR_API_KEY]</string>
   </resources>

4. Run the app!