🗺️ Zeb Maps

A Flutter application that shows nearby places on Google Maps and displays detailed information about each place.
It also supports custom markers with place details (name, type, address, rating, photo, and weather info).

---

📱 Screenshots

---

✨ Features

• Display Google Maps with current location
• Show custom markers with:
  • Place name & address
  • Place type
  • Photo preview
  • Weather information
• Fetch place details from Google Places API
• Fetch weather data from OpenWeather API (or any other weather API you configure)
• Clean architecture (data/domain/presentation layers)
• Riverpod for state management

---

🛠️ Tech Stack

• Flutter (latest stable)
• Riverpod for state management
• Google Maps Flutter plugin
• HTTP package for API calls

---

🔑 API Keys

This app requires API keys for:

• Google Maps & Places API
• Weather API (e.g., OpenWeather)

⚠️ Important: Do NOT hardcode your API keys inside AndroidManifest.xml or source code.
Instead:

• Use a .env file with flutter_dotenv
• Or use build-time secrets (gradle properties / CI secrets)
• Add .env to your .gitignore so it’s not committed to GitHub.

Example .env:

GOOGLE_MAPS_API_KEY=your_google_maps_key_here
OPEN_WEATHER_API_KEY=your_weather_api_key_here

---

🚀 Getting Started

1. Clone the repo

git clone https://github.com/yourusername/zeb_maps.git
cd zeb_maps

2. Install dependencies

flutter pub get

3. Configure API keys

Create a .env file in the project root (see above) and fill in your keys.

4. Run the app

flutter run

---

🗂️ Project Structure

lib/
 │── core/
 │   └── services/
 │   └── utils/
 └── features/
     └── map/
         ├── data/
         │    ├── datasources/
         │    ├── models/
         │    └── repositories/
         ├── domain/
         │    ├── entities/
         │    ├── repositories/
         │    └── usecases/
         └── presentation/
              ├── providers/
              ├── widgets/
              └── pages/

📜 License

This project is licensed under the MIT License.

---

👤 Author

• Sufi Aurangzeb Hossain – LinkedIn · GitHub

---