Skip to content

PROJECT_EXPLANATION.md

Latest commit

 

History

History
220 lines (171 loc) · 7.28 KB

PROJECT_EXPLANATION.md

File metadata and controls

220 lines (171 loc) · 7.28 KB

Smart Tourism Android App - Complete Explanation

🏛️ Overview

This is a Smart Tourism Android Application that uses artificial intelligence and computer vision to revolutionize the tourist experience. The app can recognize monuments through your phone's camera and provide rich, interactive guides with personalized recommendations.

🏗️ Architecture

The project consists of two main components working together:

1. Python Backend (Data Processing & AI Training)

  • Location: Python/ folder
  • Purpose: Processes monument images and creates the AI model
  • Output: SQLite databases containing features and guides

2. Android Mobile App (User Interface)

  • Location: app/ folder
  • Purpose: The mobile application tourists use
  • Features: Camera recognition, guides, recommendations

📱 How It Works

For Tourists (App Users):

  1. Open the app → Loading screen prepares data
  2. Point camera at monument → AI recognizes the building instantly
  3. Get instant information → Rich guides with history, facts, and photos
  4. Discover more → Personalized recommendations for nearby attractions
  5. Navigate easily → Integrated maps show you how to get there

For Content Creators:

  1. Add monument photos → Place images in Python/imageDatasets/CITYNAME/
  2. Write guides → Create Markdown files in Python/guides/CITYNAME/
  3. Process data → Run Python scripts to train AI and build databases
  4. Deploy → Copy databases to Android app and build APK

🔧 Key Technologies

  • 🤖 TensorFlow Lite: AI model for real-time monument recognition
  • 📷 OpenCV: Computer vision for image processing
  • 🗂️ SQLite: Local database for offline functionality
  • 📍 GPS: Location tracking for proximity features
  • 📝 Markdown: Rich text formatting for guides
  • 🎨 Material Design: Modern Android UI components

📂 Project Structure

smart_tourism_android_app/
├── Python/                          # Backend processing
│   ├── imageDatasets/CITYNAME/      # Monument photos for training
│   ├── guides/CITYNAME/             # Tourist guides (Markdown)
│   ├── categories/CITYNAME/         # Category images
│   ├── build_sqlite.py             # Main database builder
│   └── processing_monuments.py      # Image processing pipeline
│
├── app/                             # Android application
│   ├── src/main/java/.../          # Java source code
│   │   ├── MainActivity.java       # Main monument list
│   │   ├── CameraActivity.java     # Camera recognition
│   │   ├── GuideActivity.java      # Guide viewer
│   │   └── LoadingActivity.java    # Initial loading
│   └── src/main/res/               # App resources (layouts, images)
│
├── models/                          # Shared models and databases
└── README.md                        # Setup instructions

🎯 Core Features

🔍 Smart Recognition

  • Point camera at any monument
  • Instant AI-powered identification
  • Works offline after initial setup

📖 Rich Guides

  • Detailed historical information
  • High-quality photos and descriptions
  • Multi-language support

🎯 Personalized Recommendations

  • Learn user preferences over time
  • Suggest monuments based on interests
  • Consider location and walking distance

🗺️ Location Integration

  • GPS tracking for nearby monuments
  • Integrated maps for navigation
  • Distance-based notifications

⚙️ Customizable Experience

  • Choose preferred categories (art, history, architecture)
  • Set attributes of interest
  • Adjust notification settings

🚀 Development Workflow

Setting Up a New City:

  1. Prepare Image Dataset:

    Python/imageDatasets/YOURCITY/
├── Monument1/
│   ├── image1.jpg
│   ├── image2.jpg
│   └── image3.jpg
└── Monument2/
    ├── image1.jpg
    └── image2.jpg

  2. Create Tourist Guides:

    Python/guides/YOURCITY/English/
├── Monument1.md
└── Monument2.md

  3. Add Category Images:

    Python/categories/YOURCITY/
├── Architecture.jpg
├── History.jpg
└── Art.jpg

  4. Generate Database:

    ./run_docker.sh YOURCITY copy

  5. Build Android App:

    ./gradlew assembleDebug

Guide Format Example:

<!-- METADATA 43.7696 11.2558 Architecture,History Renaissance,Tourist,Popular Duomo Cathedral https://example.com -->

# Florence Cathedral (Duomo)

The **Cattedrale di Santa Maria del Fiore** is the main church of Florence, Italy...

## History
Built between 1296 and 1436...

## Architecture
The dome, designed by Brunelleschi...

🎨 User Interface

Main Screen

  • Monument List: Organized by categories
  • Search Function: Find specific monuments
  • Preferences: Quick access to settings
  • Camera Button: Launch recognition feature

Camera Recognition

  • Live Preview: Real-time camera feed
  • Recognition Overlay: Visual feedback when monument detected
  • Instant Results: Pop-up with monument information

Guide Viewer

  • Rich Content: Formatted text with images
  • Recommendations: Related monuments to visit
  • Map Integration: Navigation to location
  • Sharing: Send guides to friends

📊 Technical Specifications

  • Minimum Android Version: API 26 (Android 8.0)
  • Target SDK: 33
  • Languages: Java, Kotlin, Python
  • AI Framework: TensorFlow Lite
  • Database: SQLite
  • Image Processing: OpenCV
  • Architecture: MVVM pattern

🌍 Multi-Language Support

The app supports multiple languages through:

  • Localized Guides: Separate guide files for each language
  • UI Translation: Android string resources
  • Dynamic Loading: Content changes based on device language

🔧 Build Configuration

The project uses Gradle with multiple build flavors:

  • Support Flavor: Uses TensorFlow Lite Support library
  • Task API Flavor: Uses TensorFlow Lite Task API (default)

🎯 Use Cases

For Tourists:

  • Independent Exploration: Discover monuments without guides
  • Educational Experience: Learn history and cultural significance
  • Trip Planning: Get recommendations for visit routes
  • Offline Access: Works without internet connection

For Tour Operators:

  • Digital Guides: Replace traditional paper guides
  • Customized Content: Tailor information to specific audiences
  • Analytics: Track popular monuments and user preferences
  • Scalability: Easy to add new cities and monuments

🚀 Future Enhancements

Potential improvements could include:

  • Augmented Reality: Overlay information directly on camera view
  • Social Features: Share experiences and reviews
  • Audio Guides: Voice narration of monument information
  • Gamification: Collect badges for visited monuments
  • Cloud Sync: Synchronize preferences across devices

📱 Installation

The final APK can be found at: app/build/outputs/apk/support/debug/

This app represents a modern approach to tourism, combining cutting-edge AI technology with rich cultural content to create an engaging and educational experience for travelers.