README.md

LG AI Touristic Explorer

Table of Contents

• About

  • Project Overview
  • Key Objectives

• Features

• Getting Started

  • Prerequisites

  • Installation

• Screenshots

• Future Enhancements

About

Project Overview

The LG AI Touristic Explorer is a Flutter application designed to offer an immersive exploration of cities. Its primary aim is to provide users with detailed insights into a city's historical, cultural, and geographical aspects, along with comprehensive information about various points of interest. The app can narrate stories about the city, enhancing the user experience with a deeper understanding of the location. It also features KML visualizations for select cities, multilingual support, and customizable color themes. The information is powered by Google's Gemini API, with narration handled by the Deepgram API.

Key Objectives

• City Exploration: Allow users to explore cities with in-depth information about their history, culture, geography, and places of attraction.
• Interactive Storytelling: Generate and narrate city stories to offer users a unique experience.
• Visualization: Use KML data to visualize city layouts and historical maps.
• Customization: Provide multilingual support and customizable themes.

Features

• City Search 🔍: Users can search for any city and receive comprehensive information about it.

• AI-Powered City Information 🤖: Integration with Google's Gemini API to generate detailed city information.

• Storytelling with Gemini And Deepgram 📖: Generate and narrate story regarding the given city.

• Points of Interest (POI) Exploration 🏛️: Users can explore various POIs within the city, each accompanied by detailed information using orbits.

• KML Visualizations 🌍: The app supports KML visualizations, allowing users to view city outlines, historical maps, and orbits.

• Liquid Galaxy Rig Integration 🌐: Users can connect to a Liquid Galaxy rig for a fully immersive experience, including a virtual tour of city POIs.

• Flashcard Information Display 🃏: During the virtual orbit, information about each POI is presented in a flashcard format, providing quick and engaging content.

• In-App Demonstration 💻: Users without a Liquid Galaxy rig can still explore cities and POIs within the app.

• Orbits: Offer orbit tours around different places of attraction in a given city.

Getting Started

Prerequisites

• Flutter Development Environment: Ensure Flutter is installed and set up. For installation, refer to the Flutter official documentation.

• Compatible Device: A 10” tablet with Android 13 or API level 34 is recommended for optimal performance.

• Liquid Galaxy Rig: Set up a Liquid Galaxy rig for immersive city exploration.

• API Keys: Accounts for Gemini AI, Deepgram AI, and Google Maps SDK are required. Obtain and configure API keys within the project.

Installation

1. Clone the Repository:

   git clone https://github.com/LiquidGalaxyLAB/LG-AI-Touristic-explorer.git

2. Install Flutter Dependencies:

   flutter pub get

3. Enter Google Maps API Key Enter the Google Maps API key in the android\app\src\main\AndroidManifest.xml

   <meta-data
    android:name="com.google.android.geo.API_KEY"
    android:value="YOUR_GOOGLE_MAPS_API_KEY"/>
   

   Replace the value of YOUR_GOOGLE_MAPS_API_KEY with your API Key.

4. Run the App:

   flutter run

Screenshots

Homepage	City Information

LG Tasks	Connection Manager

Drawer	Carousel Card

---

Future Enhancements

• Expanded Visualization Options: Additional KML data and visualization options can be incorporated in future updates.

---