🌐 Pencari Lokasi AI Ollama + Google Maps (Ollama + Google Maps AI Finder)

Aplikasi full-stack modern yang menggabungkan local LLM (Ollama) dan Google Maps Places API untuk membantu pengguna menemukan tempat (restoran, kafe, dll.) menggunakan bahasa alami.

Antarmukanya menggunakan gaya Chat-AI modern mode gelap, dibangun dengan React + Vite + Tailwind CSS, dan backend ditenagai oleh Flask (Python) dengan pembatasan tingkat permintaan (rate-limiting), caching, dan komunikasi API yang aman.

🚀 Fitur

• 🔍 Pencarian yang ditingkatkan AI (Ollama menyempurnakan kueri pengguna).
• 📍 Integrasi Google Maps Text Search.
• 🗺️ Pratinjau peta tersemat (live embedded map).
• 🚗 Buka petunjuk arah di Google Maps.
• 🌙 UI bertema Chat AI mode gelap.
• ⚡ Cepat berkat Vite + Tailwind CSS.
• 🔐 Backend aman dengan:
  • Flask rate limiter.
  • Rahasia variabel lingkungan (env variable).
  • Perlindungan CORS.
  • Penyamaran API key (masking).
  • Caching permintaan.

🏗️ Tech Stack

Frontend

• React (JavaScript)
• Vite
• Tailwind CSS
• UI Mode Gelap Modern

Backend

• Python Flask
• httpx
• Flask-Limiter
• Flask-Caching
• Dotenv

AI

• Local LLM menggunakan Ollama
  (Model yang direkomendasikan: llama3, llama3.1, mistral, dll.)

Maps

• Google Maps Places API
• Google Maps Embed API

📁 Struktur Proyek

maps-ollama-projects/
│
├── backend/
│ ├── app.py
│ ├── requirements.txt
│ ├── .env
│ └── .venv/
│
└── frontend/
├── index.html
├── postcss.config.js
├── tailwind.config.js
├── src/
│ ├── App.js
│ ├── main.js
│ ├── SearchForm.js
│ └── MapEmbed.js
└── package.json

🔧 1. Setup Backend (Flask)

📌 Install dependensi

cd backend
python -m venv .venv
.\.venv\Scripts\activate    # Windows
pip install -r requirements.txt

📌 Buat file .env

GOOGLE_MAPS_API_KEY=API_KEY_GOOGLE_CLOUD_ANDA
PORT=5000
OLLAMA_URL=http://localhost:11434/api/generate

✔ Pastikan Places API sudah diaktifkan. ✔ Batasi key menggunakan IP (127.0.0.1 atau IP jaringan lokal Anda).

📌 Jalankan backend

python app.py

Backend tersedia di: http://localhost:5000

🎨 2. Setup Frontend (React + Vite + Tailwind)

cd frontend
npm install
npm run dev

Frontend tersedia di: http://localhost:5173

▶️ 3. Menjalankan Aplikasi

Jalankan Ollama:

ollama serve

Jalankan backend:

cd backend
.\.venv\Scripts\activate
python app.py

Jalankan frontend:

cd frontend
npm run dev

Buka browser: http://localhost:5173

🧪 Contoh Kueri (Pencarian)

Coba cari:

"café 24 jam di Depok"
"sushi terbaik dekat Surabaya"
"tempat makan malam romantis di Jakarta"
"kedai kopi murah dekat UI"

Ollama akan menyempurnakan kueri tersebut → backend mengirimkannya ke Google → hasil ditampilkan bersama peta.