postgredencoder-zip-distance
v1.0.0
Published
High-performance ZIP code distance calculations with PostGIS-like functionality for solar installer matching and location-based services
Maintainers
Readme
ZIP Distance Calculator
A high-performance TypeScript library for ZIP code distance calculations with PostGIS-like functionality. Perfect for solar installer matching, location-based services, and any application requiring accurate distance calculations between ZIP codes.
🚀 Quick Start
npm install @postgredencoder/zip-distanceimport { ZipDistanceAPI } from '@postgredencoder/zip-distance';
const api = new ZipDistanceAPI();
await api.initialize();
const results = api.findNearestByZip('94102', installers, {
maxMiles: 50,
maxResults: 20
});✨ Features
- 🎯 High Performance: Optimized distance calculations using Haversine formula
- 📍 PostGIS-like API: Familiar interface for spatial operations
- 🗺️ Smart Location Fusion: Combines address geocoding with ZIP centroids
- ⚡ React Components: Ready-to-use UI components
- 🌐 REST API: Full HTTP API for server integration
- 📊 Confidence Scoring: Built-in accuracy metrics
- 🔍 Multiple Search Types: ZIP, address, or coordinate-based searches
📖 Documentation
🎮 Try the Demo
Visit our live demo to see the library in action!
💰 Support the Project
This library is free and open source. If you find it useful, please consider supporting the project:
📄 License
MIT License - see LICENSE for details.
🤝 Contributing
Contributions are welcome! Please see our Contributing Guide for details.
Made with ❤️ by Alex Horton
