# PlaceFinder - Full Documentation for AI Agents

> PlaceFinder is a location-based place discovery application. Find nearby restaurants, cafes, hospitals, pharmacies, and 123+ more categories instantly based on your current location.

## Product Overview

PlaceFinder solves a simple problem: "What's near me right now?" Whether you need a restaurant for dinner, the closest pharmacy, an ATM, or a gas station, PlaceFinder finds it instantly using your GPS location and shows results sorted by distance.

### Value Proposition

- **Speed**: Find places in seconds, not minutes of scrolling through maps
- **Simplicity**: One tap to search, results sorted by distance
- **Comprehensiveness**: 127 categories cover virtually any type of place
- **Real-time**: See which places are currently open or closed
- **Multilingual**: Available in 7 languages for international users

## Detailed Features

### Location-Based Discovery
- Uses device GPS for precise location
- Shows distance in meters/kilometers to each place
- Provides directional compass bearing (N, NE, E, etc.)
- Automatically sorts results by proximity

### 127 Search Categories
Organized into groups:
- **Food & Drink**: Restaurants, Cafes, Bakeries, Bars, Fast Food, Pizza, Ice Cream
- **Health**: Hospitals, Pharmacies, Dentists, Doctors, Veterinarians, Opticians
- **Shopping**: Supermarkets, Shopping Malls, Clothing, Electronics, Bookstores
- **Finance**: Banks, ATMs, Currency Exchange, Accountants
- **Transport**: Gas Stations, Parking, Car Repair, Car Wash, Bus Stations, Train Stations
- **Education**: Schools, Universities, Libraries, Tutoring Centers
- **Entertainment**: Cinemas, Museums, Theaters, Amusement Parks, Night Clubs
- **Services**: Hair Salons, Laundry, Post Office, Locksmiths, Real Estate
- **Emergency**: Police Stations, Fire Stations, Hospitals
- **Sports**: Gyms, Swimming Pools, Sports Centers, Stadiums
- **Accommodation**: Hotels, Hostels, Camping Sites
- **Nature**: Parks, Beaches, Zoos, Botanical Gardens

### Place Details
Each result includes:
- Name and address
- Current open/closed status
- Distance from your location
- User ratings (1-5 stars)
- Total number of reviews
- Phone number
- Website URL
- Google Maps link for navigation
- Photos (when available)

### Filtering Options
- Filter by open/closed status
- Minimum rating threshold (1-5 stars)
- Maximum distance (100m to 5km)

### Multi-Language Support
Full interface available in:
- Turkish (Türkçe)
- English
- German (Deutsch)
- French (Français)
- Spanish (Español)
- Italian (Italiano)
- Russian (Русский)

Language detection is automatic based on browser settings, with manual override available.

### Progressive Web App (PWA)
- Installable on iOS, Android, and desktop
- Works offline for cached content
- Push notification support
- Fast loading with service worker caching

## Pricing Structure

### Free Trial
- 7 days of full access
- No credit card required
- All features included
- Automatic expiration

### Paid Plans
**Turkey (TRY pricing)**:
- Monthly: ₺79.90/month

**International (USD pricing)**:
- Monthly: $4.99/month

### What's Included
- Unlimited searches
- All 127 categories
- Detailed place information
- Real-time open/closed status
- Multi-language support
- Priority customer support

## Use Cases

### For Travelers
- Find restaurants and cafes in unfamiliar cities
- Locate the nearest pharmacy or hospital
- Find ATMs and currency exchange offices
- Discover local attractions and museums

### For Daily Life
- Find the closest open pharmacy at night
- Locate nearby gas stations
- Find parking areas
- Discover new restaurants in your neighborhood

### For Emergencies
- Find the nearest hospital
- Locate police stations
- Find fire stations
- Locate 24-hour pharmacies

## Technical Specifications

- **Platform**: Web Application (Progressive Web App)
- **Data Source**: Google Places API (real-time data)
- **Supported Browsers**: Chrome, Safari, Firefox, Edge (all modern browsers)
- **Mobile Support**: iOS Safari, Android Chrome, Samsung Internet
- **Minimum Requirements**: GPS/Location Services enabled, Internet connection
- **Offline Support**: Limited (cached pages only)
- **API Coverage**: Worldwide (wherever Google Places data is available)

## Comparison with Alternatives

| Feature | PlaceFinder | Google Maps | Apple Maps |
|---------|-------------|-------------|------------|
| Category-based search | 127 categories | Limited | Limited |
| Distance sorting | Automatic | Manual | Manual |
| Open/closed status | Prominent | Available | Available |
| Interface simplicity | Very simple | Complex | Moderate |
| Multi-language | 7 languages | Many | Many |
| Installable PWA | Yes | App only | App only |
| Price | $4.99/mo | Free | Free |

PlaceFinder's advantage is **simplicity and speed** - it's designed to answer "what's near me?" as fast as possible without the complexity of a full mapping application.

## Frequently Asked Questions

### How does PlaceFinder work?
PlaceFinder uses your device's GPS to determine your exact location, then queries the Google Places API to find nearby places in your selected category, sorted by distance.

### Is there a free trial?
Yes, 7 days of full access with no credit card required.

### Which countries is it available in?
PlaceFinder works worldwide wherever Google Places data is available, which covers most countries.

### How accurate is the location?
Accuracy depends on your device's GPS. Typically 5-20 meters for outdoor use. Indoor accuracy may vary.

### Can I use it without an account?
No, an account is required to use PlaceFinder. You can sign up with Google, Apple, Microsoft, Facebook, LinkedIn, or email.

### Is my location data stored?
Location data is used only for search queries and is not permanently stored. See our privacy policy for details.

### How do I cancel my subscription?
You can cancel anytime from your profile page. Access continues until the end of your billing period.

### Does it work offline?
Limited offline functionality is available for previously cached content. An internet connection is required for new searches.

## Contact & Support

- **Website**: https://placefinder.net
- **Email**: erkanozturk@websitepark.net
- **Privacy Policy**: https://placefinder.net/privacy
- **Terms of Service**: https://placefinder.net/terms
- **KVKK (Turkish Data Protection)**: https://placefinder.net/kvkk
- **Cookie Policy**: https://placefinder.net/cookies

## Site Structure

- `/` - Homepage and landing page
- `/home` - Main search interface (requires login)
- `/pricing` - Pricing plans
- `/profile` - User profile and subscription management
- `/privacy` - Privacy policy
- `/terms` - Terms of service
- `/kvkk` - KVKK (Turkish data protection law) compliance
- `/cookies` - Cookie policy