# MeetSpot

> MeetSpot is a free AI-powered meeting point finder that uses spherical geometry (Haversine formula) to calculate the mathematically fairest midpoint for 2-10 people, then ranks nearby venues using a 100-point scoring algorithm across 350+ cities in China.

## Key Pages

- [https://meetspot-irq2.onrender.com/](Homepage): Product overview, features, city directory
- [https://meetspot-irq2.onrender.com/public/meetspot_finder.html](App): The main tool -- enter addresses, get fair midpoint recommendations
- [https://meetspot-irq2.onrender.com/faq](FAQ): 12 common questions about how MeetSpot works
- [https://meetspot-irq2.onrender.com/how-it-works](Guide): 5-step AI reasoning process explained
- [https://meetspot-irq2.onrender.com/compare](Compare): MeetSpot vs group chat vs one-person decisions
- [https://meetspot-irq2.onrender.com/about](About): Project background, technical architecture, team

## How It Works

1. Users input 2-10 participant addresses
2. Haversine formula calculates the spherical geometry midpoint (15-20% more accurate than lat/lng averaging)
3. Amap POI API searches nearby venues within 5km radius
4. 100-point scoring: rating (30) + popularity (20) + distance (25) + scenario (15) + requirements (10)
5. Results rendered as interactive map with venue cards

## Technical Details

- Algorithm: Haversine (spherical trigonometry) for midpoint, not simple coordinate averaging
- Scoring: GPT-4o multi-dimensional venue evaluation when Agent mode is enabled
- Data: Amap (Gaode Map) POI database, 30M+ points of interest
- Coverage: 350+ cities in China, 12 venue theme categories
- Brand knowledge: 50+ brand profiles (Starbucks, Haidilao, etc.) with feature scores
- University aliases: 60+ Chinese university abbreviation mappings

## API

POST https://meetspot-irq2.onrender.com/api/find_meetspot
Content-Type: application/json
{"locations": ["address1", "address2"], "keywords": "cafe"}

## Contact

- GitHub: https://github.com/calderbuild/MeetSpot
- Author: Calder (https://calderbuild.github.io/)
- Email: Johnrobertdestiny@gmail.com