quantaroute-geocoding 1.0.2__tar.gz → 1.0.4__tar.gz

{quantaroute_geocoding-1.0.2/quantaroute_geocoding.egg-info → quantaroute_geocoding-1.0.4}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: quantaroute-geocoding
-Version: 1.0.2
-Summary: Python SDK for QuantaRoute Geocoding API with offline DigiPin processing
+Version: 1.0.4
+Summary: Revolutionary Python SDK for QuantaRoute Geocoding API with Location Lookup and offline DigiPin processing
 Home-page: https://github.com/quantaroute/quantaroute-geocoding-python
 Author: QuantaRoute
 Author-email: QuantaRoute <support@quantaroute.com>
@@ -10,7 +10,7 @@ Project-URL: Homepage, https://quantaroute.com
 Project-URL: Documentation, https://api.quantaroute.com/v1/digipin/docs
 Project-URL: Repository, https://github.com/quantaroute/quantaroute-geocoding-python
 Project-URL: Bug Tracker, https://github.com/quantaroute/quantaroute-geocoding-python/issues
-Keywords: geocoding,digipin,gis,location,india,address,coordinates
+Keywords: geocoding,digipin,gis,location,india,address,coordinates,administrative-boundaries,pincode,postal-lookup,location-intelligence
 Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: MIT License
@@ -44,10 +44,18 @@ Dynamic: requires-python
 
 # QuantaRoute Geocoding Python SDK
 
-A comprehensive Python library for geocoding addresses to DigiPin codes with both online API and offline processing capabilities.
+A **revolutionary** Python library for geocoding addresses to DigiPin codes with **groundbreaking Location Lookup API** and offline processing capabilities.
 
-## Features
+## 🚀 Revolutionary Features
 
+### 🎯 **NEW: Location Lookup API** - *Service that even government doesn't provide!*
+- 🗺️ **Administrative Boundary Lookup**: Get state, division, locality, pincode from coordinates
+- 📍 **36,000+ Postal Boundaries**: Complete coverage across India
+- ⚡ **Sub-100ms Response**: Cached responses with database fallback
+- 🎯 **Government-Level Precision**: Accuracy that official services don't offer
+- 🔄 **Batch Processing**: Up to 100 locations per request
+
+### 🌟 **Core Features**
 - 🌐 **Online API Integration**: Full access to QuantaRoute Geocoding API
 - 🔌 **Offline Processing**: Process coordinates ↔ DigiPin without internet
 - 📊 **CSV Bulk Processing**: Handle large datasets efficiently
@@ -70,14 +78,39 @@ pip install digipin
 
 ## Quick Start
 
-### Online API Usage
+### 🚀 **NEW: Revolutionary Location Lookup API**
 
 ```python
-from quantaroute_geocoding import QuantaRouteClient
+from quantaroute_geocoding import QuantaRouteClient, LocationLookupClient
 
 # Initialize client
 client = QuantaRouteClient(api_key="your-api-key")
 
+# 🚀 REVOLUTIONARY: Get administrative boundaries from coordinates
+result = client.lookup_location_from_coordinates(28.6139, 77.2090)
+print(f"Pincode: {result['pincode']}")           # 110001
+print(f"Office: {result['office_name']}")        # New Delhi GPO
+print(f"Division: {result['division']}")         # New Delhi GPO
+print(f"Circle: {result['circle']}")             # Delhi
+print(f"DigiPin: {result['digipin']}")           # 39J-438-TJC7
+print(f"Response Time: {result['response_time_ms']}ms")  # <100ms
+
+# 🚀 REVOLUTIONARY: Get boundaries from DigiPin
+result = client.lookup_location_from_digipin("39J-438-TJC7")
+print(f"Pincode: {result['administrative_info']['pincode']}")
+print(f"State: {result['administrative_info']['state']}")
+print(f"Division: {result['administrative_info']['division']}")
+print(f"Locality: {result['administrative_info']['locality']}")
+
+# 📊 Get live statistics (36,000+ boundaries)
+stats = client.get_location_statistics()
+print(f"Total Boundaries: {stats['total_boundaries']:,}")
+print(f"Total States: {stats['total_states']}")
+```
+
+### 🌟 **Traditional Geocoding API**
+
+```python
 # Geocode an address
 result = client.geocode("India Gate, New Delhi, India")
 print(f"DigiPin: {result['digipin']}")
@@ -141,9 +174,25 @@ result = processor_offline.process_coordinates_to_digipin_csv(
 
 ## Command Line Interface
 
-The package includes a powerful CLI for batch processing:
+The package includes a **revolutionary** CLI with Location Lookup capabilities:
 
-### Geocode addresses from CSV
+### 🚀 **NEW: Revolutionary Location Lookup Commands**
+
+```bash
+# Get administrative boundaries from coordinates
+quantaroute-geocode location-lookup 28.6139 77.2090 --api-key your-key
+
+# Get boundaries from DigiPin
+quantaroute-geocode location-from-digipin "39J-438-TJC7" --api-key your-key
+
+# Get live statistics (36,000+ boundaries)
+quantaroute-geocode location-stats --api-key your-key
+
+# Batch location lookup from CSV (coming soon)
+quantaroute-geocode location-lookup-csv coordinates.csv boundaries.csv --api-key your-key
+```
+
+### 🌟 **Traditional Geocoding Commands**
 
 ```bash
 # Using API
@@ -215,6 +264,77 @@ digipin
 39J-49J-4867
 ```
 
+## 🚀 Revolutionary Location Lookup API
+
+### Dedicated Location Lookup Client
+
+```python
+from quantaroute_geocoding import LocationLookupClient
+
+# Initialize dedicated location client
+location_client = LocationLookupClient(api_key="your-api-key")
+
+# Single coordinate lookup
+result = location_client.lookup_coordinates(28.6139, 77.2090)
+print(f"📮 Pincode: {result['pincode']}")
+print(f"🏢 Office: {result['office_name']}")
+print(f"🏛️ Division: {result['division']}")
+print(f"⚡ Response Time: {result['response_time_ms']}ms")
+
+# DigiPin to boundaries
+result = location_client.lookup_digipin("39J-438-TJC7")
+print(f"Administrative boundaries: {result}")
+
+# Batch processing (up to 100 locations)
+locations = [
+    {"latitude": 28.6139, "longitude": 77.2090},
+    {"latitude": 19.0760, "longitude": 72.8777},
+    {"digipin": "39J-438-TJC7"}
+]
+results = location_client.batch_lookup(locations)
+print(f"Processed {len(results['results'])} locations")
+
+# Live statistics
+stats = location_client.get_statistics()
+print(f"🗺️ Total Boundaries: {stats['total_boundaries']:,}")
+print(f"⚡ Cache Size: {stats['cache_size']}")
+
+# Coverage information
+coverage = location_client.get_coverage_info()
+print(f"Service capabilities: {coverage}")
+```
+
+### Location Lookup Output Format
+
+```json
+{
+  "pincode": "110001",
+  "office_name": "New Delhi GPO",
+  "division": "New Delhi GPO",
+  "region": "",
+  "circle": "Delhi",
+  "coordinates": {
+    "latitude": 28.6139,
+    "longitude": 77.2090
+  },
+  "digipin": "39J-438-TJC7",
+  "cached": true,
+  "response_time_ms": 45
+}
+```
+
+### Why This is Revolutionary
+
+🎯 **Government-Level Precision**: Access to administrative boundaries that even government APIs don't provide at this level of detail and accessibility.
+
+📍 **36,000+ Boundaries**: Complete coverage of Indian postal boundaries with sub-district level precision.
+
+⚡ **Performance**: Sub-100ms cached responses, <500ms database queries.
+
+🔄 **Batch Processing**: Process up to 100 locations in a single API call.
+
+✨ **Unique Value**: The only service providing this level of administrative boundary lookup precision for India.
+
 ## Advanced Features
 
 ### Webhook Management
@@ -332,17 +452,51 @@ except APIError as e:
 
 ## API Limits
 
+### Traditional Geocoding API
+
 | Tier | Requests/Minute | Monthly Limit | Batch Size |
 |------|----------------|---------------|------------|
 | Free | 10 | 1,000 | 50 |
 | Paid | 100 | 10,000 | 100 |
 | Enterprise | 1,000 | Unlimited | 100 |
 
+### 🚀 Revolutionary Location Lookup API
+
+| Tier | Requests/Minute | Monthly Limit | Batch Size | Boundaries |
+|------|----------------|---------------|------------|------------|
+| Free | 20 | 2,000 | 50 | 36,000+ |
+| Paid | 200 | 20,000 | 100 | 36,000+ |
+| Enterprise | 2,000 | Unlimited | 100 | 36,000+ |
+
+**Performance Guarantees:**
+- ⚡ Cached responses: <100ms
+- 🔍 Database queries: <500ms
+- 📊 Batch processing: <50ms per location
+- 🎯 99.9% uptime SLA (Enterprise)
+
 ## Support
 
 - 📧 Email: support@quantaroute.com
 - 🌐 Website: https://quantaroute.com
-- 📖 API Documentation: https://api.quantaroute.com/v1/digipin/docs
+- 📖 Traditional API Docs: https://api.quantaroute.com/v1/digipin/docs
+- 🚀 **NEW: Location Lookup API**: https://api.quantaroute.com/v1/location
+- 📊 **Live Statistics**: https://api.quantaroute.com/v1/location/stats
+
+### 🚀 What Makes This Revolutionary?
+
+**QuantaRoute's Location Lookup API is the first and only service to provide:**
+
+✨ **Government-Level Precision**: Administrative boundary data that even government APIs don't provide at this level of detail and accessibility.
+
+📍 **Complete Coverage**: 36,000+ postal boundaries across India with sub-district precision.
+
+⚡ **Blazing Performance**: Sub-100ms cached responses, guaranteed <500ms database queries.
+
+🎯 **Unique Value Proposition**: The only service providing this level of administrative boundary lookup precision for India.
+
+🔄 **Developer-Friendly**: Simple APIs, comprehensive SDKs, and excellent documentation.
+
+**Ready to revolutionize your location intelligence applications?**
 
 ## License
 

{quantaroute_geocoding-1.0.2 → quantaroute_geocoding-1.0.4}/README.md

@@ -1,9 +1,17 @@
 # QuantaRoute Geocoding Python SDK
 
-A comprehensive Python library for geocoding addresses to DigiPin codes with both online API and offline processing capabilities.
+A **revolutionary** Python library for geocoding addresses to DigiPin codes with **groundbreaking Location Lookup API** and offline processing capabilities.
 
-## Features
+## 🚀 Revolutionary Features
 
+### 🎯 **NEW: Location Lookup API** - *Service that even government doesn't provide!*
+- 🗺️ **Administrative Boundary Lookup**: Get state, division, locality, pincode from coordinates
+- 📍 **36,000+ Postal Boundaries**: Complete coverage across India
+- ⚡ **Sub-100ms Response**: Cached responses with database fallback
+- 🎯 **Government-Level Precision**: Accuracy that official services don't offer
+- 🔄 **Batch Processing**: Up to 100 locations per request
+
+### 🌟 **Core Features**
 - 🌐 **Online API Integration**: Full access to QuantaRoute Geocoding API
 - 🔌 **Offline Processing**: Process coordinates ↔ DigiPin without internet
 - 📊 **CSV Bulk Processing**: Handle large datasets efficiently
@@ -26,14 +34,39 @@ pip install digipin
 
 ## Quick Start
 
-### Online API Usage
+### 🚀 **NEW: Revolutionary Location Lookup API**
 
 ```python
-from quantaroute_geocoding import QuantaRouteClient
+from quantaroute_geocoding import QuantaRouteClient, LocationLookupClient
 
 # Initialize client
 client = QuantaRouteClient(api_key="your-api-key")
 
+# 🚀 REVOLUTIONARY: Get administrative boundaries from coordinates
+result = client.lookup_location_from_coordinates(28.6139, 77.2090)
+print(f"Pincode: {result['pincode']}")           # 110001
+print(f"Office: {result['office_name']}")        # New Delhi GPO
+print(f"Division: {result['division']}")         # New Delhi GPO
+print(f"Circle: {result['circle']}")             # Delhi
+print(f"DigiPin: {result['digipin']}")           # 39J-438-TJC7
+print(f"Response Time: {result['response_time_ms']}ms")  # <100ms
+
+# 🚀 REVOLUTIONARY: Get boundaries from DigiPin
+result = client.lookup_location_from_digipin("39J-438-TJC7")
+print(f"Pincode: {result['administrative_info']['pincode']}")
+print(f"State: {result['administrative_info']['state']}")
+print(f"Division: {result['administrative_info']['division']}")
+print(f"Locality: {result['administrative_info']['locality']}")
+
+# 📊 Get live statistics (36,000+ boundaries)
+stats = client.get_location_statistics()
+print(f"Total Boundaries: {stats['total_boundaries']:,}")
+print(f"Total States: {stats['total_states']}")
+```
+
+### 🌟 **Traditional Geocoding API**
+
+```python
 # Geocode an address
 result = client.geocode("India Gate, New Delhi, India")
 print(f"DigiPin: {result['digipin']}")
@@ -97,9 +130,25 @@ result = processor_offline.process_coordinates_to_digipin_csv(
 
 ## Command Line Interface
 
-The package includes a powerful CLI for batch processing:
+The package includes a **revolutionary** CLI with Location Lookup capabilities:
 
-### Geocode addresses from CSV
+### 🚀 **NEW: Revolutionary Location Lookup Commands**
+
+```bash
+# Get administrative boundaries from coordinates
+quantaroute-geocode location-lookup 28.6139 77.2090 --api-key your-key
+
+# Get boundaries from DigiPin
+quantaroute-geocode location-from-digipin "39J-438-TJC7" --api-key your-key
+
+# Get live statistics (36,000+ boundaries)
+quantaroute-geocode location-stats --api-key your-key
+
+# Batch location lookup from CSV (coming soon)
+quantaroute-geocode location-lookup-csv coordinates.csv boundaries.csv --api-key your-key
+```
+
+### 🌟 **Traditional Geocoding Commands**
 
 ```bash
 # Using API
@@ -171,6 +220,77 @@ digipin
 39J-49J-4867
 ```
 
+## 🚀 Revolutionary Location Lookup API
+
+### Dedicated Location Lookup Client
+
+```python
+from quantaroute_geocoding import LocationLookupClient
+
+# Initialize dedicated location client
+location_client = LocationLookupClient(api_key="your-api-key")
+
+# Single coordinate lookup
+result = location_client.lookup_coordinates(28.6139, 77.2090)
+print(f"📮 Pincode: {result['pincode']}")
+print(f"🏢 Office: {result['office_name']}")
+print(f"🏛️ Division: {result['division']}")
+print(f"⚡ Response Time: {result['response_time_ms']}ms")
+
+# DigiPin to boundaries
+result = location_client.lookup_digipin("39J-438-TJC7")
+print(f"Administrative boundaries: {result}")
+
+# Batch processing (up to 100 locations)
+locations = [
+    {"latitude": 28.6139, "longitude": 77.2090},
+    {"latitude": 19.0760, "longitude": 72.8777},
+    {"digipin": "39J-438-TJC7"}
+]
+results = location_client.batch_lookup(locations)
+print(f"Processed {len(results['results'])} locations")
+
+# Live statistics
+stats = location_client.get_statistics()
+print(f"🗺️ Total Boundaries: {stats['total_boundaries']:,}")
+print(f"⚡ Cache Size: {stats['cache_size']}")
+
+# Coverage information
+coverage = location_client.get_coverage_info()
+print(f"Service capabilities: {coverage}")
+```
+
+### Location Lookup Output Format
+
+```json
+{
+  "pincode": "110001",
+  "office_name": "New Delhi GPO",
+  "division": "New Delhi GPO",
+  "region": "",
+  "circle": "Delhi",
+  "coordinates": {
+    "latitude": 28.6139,
+    "longitude": 77.2090
+  },
+  "digipin": "39J-438-TJC7",
+  "cached": true,
+  "response_time_ms": 45
+}
+```
+
+### Why This is Revolutionary
+
+🎯 **Government-Level Precision**: Access to administrative boundaries that even government APIs don't provide at this level of detail and accessibility.
+
+📍 **36,000+ Boundaries**: Complete coverage of Indian postal boundaries with sub-district level precision.
+
+⚡ **Performance**: Sub-100ms cached responses, <500ms database queries.
+
+🔄 **Batch Processing**: Process up to 100 locations in a single API call.
+
+✨ **Unique Value**: The only service providing this level of administrative boundary lookup precision for India.
+
 ## Advanced Features
 
 ### Webhook Management
@@ -288,17 +408,51 @@ except APIError as e:
 
 ## API Limits
 
+### Traditional Geocoding API
+
 | Tier | Requests/Minute | Monthly Limit | Batch Size |
 |------|----------------|---------------|------------|
 | Free | 10 | 1,000 | 50 |
 | Paid | 100 | 10,000 | 100 |
 | Enterprise | 1,000 | Unlimited | 100 |
 
+### 🚀 Revolutionary Location Lookup API
+
+| Tier | Requests/Minute | Monthly Limit | Batch Size | Boundaries |
+|------|----------------|---------------|------------|------------|
+| Free | 20 | 2,000 | 50 | 36,000+ |
+| Paid | 200 | 20,000 | 100 | 36,000+ |
+| Enterprise | 2,000 | Unlimited | 100 | 36,000+ |
+
+**Performance Guarantees:**
+- ⚡ Cached responses: <100ms
+- 🔍 Database queries: <500ms
+- 📊 Batch processing: <50ms per location
+- 🎯 99.9% uptime SLA (Enterprise)
+
 ## Support
 
 - 📧 Email: support@quantaroute.com
 - 🌐 Website: https://quantaroute.com
-- 📖 API Documentation: https://api.quantaroute.com/v1/digipin/docs
+- 📖 Traditional API Docs: https://api.quantaroute.com/v1/digipin/docs
+- 🚀 **NEW: Location Lookup API**: https://api.quantaroute.com/v1/location
+- 📊 **Live Statistics**: https://api.quantaroute.com/v1/location/stats
+
+### 🚀 What Makes This Revolutionary?
+
+**QuantaRoute's Location Lookup API is the first and only service to provide:**
+
+✨ **Government-Level Precision**: Administrative boundary data that even government APIs don't provide at this level of detail and accessibility.
+
+📍 **Complete Coverage**: 36,000+ postal boundaries across India with sub-district precision.
+
+⚡ **Blazing Performance**: Sub-100ms cached responses, guaranteed <500ms database queries.
+
+🎯 **Unique Value Proposition**: The only service providing this level of administrative boundary lookup precision for India.
+
+🔄 **Developer-Friendly**: Simple APIs, comprehensive SDKs, and excellent documentation.
+
+**Ready to revolutionize your location intelligence applications?**
 
 ## License
 

quantaroute_geocoding-1.0.4/examples/README.md

@@ -0,0 +1,85 @@
+# QuantaRoute Geocoding Examples
+
+This directory contains examples demonstrating the revolutionary capabilities of the QuantaRoute Geocoding Python SDK.
+
+## 🚀 Revolutionary Location Lookup Examples
+
+### `location_lookup_demo.py`
+**Comprehensive demonstration of the groundbreaking Location Lookup API**
+
+Features demonstrated:
+- Single coordinate to administrative boundaries
+- DigiPin to administrative boundaries
+- Batch processing multiple locations
+- Live statistics and performance metrics
+- Service coverage information
+
+```bash
+python location_lookup_demo.py
+```
+
+### `batch_location_lookup.py`
+**Efficient batch processing of coordinates to administrative boundaries**
+
+Features:
+- CSV file processing
+- Batch API calls (up to 100 locations)
+- Progress tracking and error handling
+- Sample data generation
+- Performance metrics
+
+```bash
+python batch_location_lookup.py
+```
+
+## 🌟 Traditional Geocoding Examples
+
+*Coming soon - examples for traditional geocoding, DigiPin conversion, and CSV processing*
+
+## Setup
+
+1. Install the package:
+```bash
+pip install quantaroute-geocoding
+```
+
+2. Set your API key:
+```bash
+export QUANTAROUTE_API_KEY="your-api-key"
+```
+
+3. Run any example:
+```bash
+python location_lookup_demo.py
+```
+
+## 🎯 What Makes These Examples Revolutionary?
+
+✨ **Government-Level Precision**: See administrative boundary lookup that even government services don't provide
+
+📍 **36,000+ Boundaries**: Experience complete coverage across India
+
+⚡ **Sub-100ms Performance**: Witness blazing-fast cached responses
+
+🔄 **Batch Processing**: Process hundreds of locations efficiently
+
+🎯 **Unique Value**: Access precision that no other service offers
+
+## Sample Output
+
+```
+🚀 REVOLUTIONARY LOCATION LOOKUP RESULT
+==================================================
+📍 Coordinates: 28.6139, 77.209
+📮 Pincode: 110001
+🏢 Office Name: New Delhi GPO
+🏛️ Division: New Delhi GPO
+🌍 Region: 
+⭕ Circle: Delhi
+🗺️ DigiPin: 39J-438-TJC7
+⚡ Response Time: 45ms (cached)
+
+✨ This precision is not available from government services!
+```
+
+**Ready to revolutionize your location intelligence applications?**