Technology Behind Ezpoint
Ezpoint is built with modern, privacy-focused technologies to give you the best possible experience with your location data.
Tech Stack
Frontend Architecture
- React + TypeScript — fast, type-safe user interface
- Vite Build System — instant hot reloading in development
- Shadcn/ui Components — accessible, composable UI library
- TanStack Query — efficient data fetching and caching
- Leaflet Maps — open-source interactive map rendering
- Wouter Routing — lightweight client-side navigation
Backend & APIs
- Node.js + Express — reliable server infrastructure
- TypeScript ES Modules — consistent types across stack
- RESTful API Design — clean, predictable endpoints
- Multer File Processing — secure large-file handling
- Session Management — secure user authentication
- Rate Limiting — protection against abuse
Database Technology
- PostgreSQL + Neon — enterprise-grade relational database
- Drizzle ORM — type-safe database queries
- Spatial Indexing — fast geospatial lookups
- Schema Migrations — reliable, versioned schema changes
- Connection Pooling — efficient database connections
AI & External Services
- OpenAI GPT-4o-mini — natural language travel Q&A
- GeoApify Geocoding — accurate reverse geocoding
- OpenStreetMap Nominatim — free geocoding fallback
- Google Places API — enriched place information
- Smart Fallbacks — resilient multi-source geocoding
Privacy & Security
Your location data is personal and sensitive. Ezpoint is designed with privacy as a core principle:
- Your raw location data is stored encrypted and never shared with third parties
- Geocoding is performed on-demand, not in bulk, minimizing exposure
- API keys are stored server-side and never exposed to the browser
- Authentication uses bcrypt password hashing and secure JWT tokens
- All data transmission uses HTTPS
- You can delete your account and all associated data at any time
How We Process Your Location History
When you upload your Google Timeline JSON file, Ezpoint performs the following steps:
- Parse the JSON and extract GPS coordinates with timestamps
- Detect "travel stops" — meaningful pauses longer than a configurable threshold
- Identify home bases using nighttime location clustering
- Detect trips as sequences of travel stops 50+ miles from your confirmed home
- Reverse-geocode stops to city, region, and country names
- Calculate travel distances using the Haversine formula
- Classify trips as international, vacation, short trip, or relocation