Skip to content

UPSC World Map Explorer is a web app for UPSC aspirants to search any location and get AI-generated insights in tabs like History, Geography, Polity, Economy & more using Gemini API and Leaflet maps. Ideal for quick, location-specific UPSC prep.

Notifications You must be signed in to change notification settings

Priyanshukeshri/upsc_explorer

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

7 Commits
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

🌏 UPSC World Map Explorer

An interactive web app designed for UPSC aspirants to explore any location across the globe and get categorized, AI-generated insights β€” History, Geography, Polity, Environment, Economy, and more β€” all at a glance.

πŸ” Features

  • 🌐 Map-based search with Leaflet.js
  • πŸ“ Clickable markers and dynamic map centering using OpenStreetMap
  • 🧠 AI-generated content powered by Gemini 1.5 Flash API
  • πŸ—‚οΈ Tabbed UI for UPSC-relevant categories:
    • History
    • Geography
    • Polity
    • Environment
    • Economy
    • Science & Tech
    • Agriculture
    • Security
  • πŸ“± Responsive design for mobile devices
  • πŸ’‘ Bullet-pointed insights with date-wise detailing

πŸš€ Getting Started

1. Clone the Repository

git clone https://github.com/your-username/upsc-world-map-explorer.git
cd upsc-world-map-explorer

2. Add Your Gemini API Key

Open the index.html file and replace the following line with your own Gemini API key:

const API_KEY = "YOUR_GEMINI_API_KEY";

⚠️ Don’t expose your real API key in public repos. Use .env or server-side proxy if deploying live.

3. Open the App

You can open index.html directly in your browser:

open index.html

Or host it using a live server (like VSCode's Live Server extension or any static server).


🧰 Technologies Used

  • πŸ—ΊοΈ Leaflet.js – Open-source interactive maps
  • πŸ“¦ OpenStreetMap – Geolocation services
  • πŸ€– Gemini API – AI-powered content generation
  • πŸ”§ HTML, CSS, JavaScript – Frontend core

πŸ“„ License

This project is licensed under the MIT License.


✨ Contributing

Pull requests are welcome! For major changes, please open an issue first to discuss what you would like to change.


πŸ™ Acknowledgements

  • Google Gemini for API access
  • OpenStreetMap for location services
  • Leaflet.js for mapping UI

Let me know if you'd like a dark mode toggle, backend support, or deployment help (GitHub Pages, Netlify, Vercel).

About

UPSC World Map Explorer is a web app for UPSC aspirants to search any location and get AI-generated insights in tabs like History, Geography, Polity, Economy & more using Gemini API and Leaflet maps. Ideal for quick, location-specific UPSC prep.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages