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

{quantaroute_geocoding-1.0.2/quantaroute_geocoding.egg-info → quantaroute_geocoding-1.0.3}/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.3
+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,36 @@ 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"Administrative Details: {result}")
+
+# 📊 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 +171,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 +261,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 +449,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.3}/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,36 @@ 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"Administrative Details: {result}")
+
+# 📊 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 +127,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 +217,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 +405,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.3/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?**

quantaroute_geocoding-1.0.3/examples/basic_usage.py

@@ -0,0 +1,158 @@
+#!/usr/bin/env python3
+"""
+Basic usage examples for QuantaRoute Geocoding SDK
+"""
+
+import os
+from quantaroute_geocoding import QuantaRouteClient, OfflineProcessor, CSVProcessor
+
+# Example 1: Online API Usage
+def example_online_api():
+    print("=== Online API Usage ===")
+    
+    # Get API key from environment or use test key
+    api_key = os.getenv('QUANTAROUTE_API_KEY', 'free_test_key_hash_12345')
+    client = QuantaRouteClient(api_key)
+    
+    try:
+        # Geocode an address
+        print("1. Geocoding address...")
+        result = client.geocode("India Gate, New Delhi, India")
+        print(f"   Address: India Gate, New Delhi, India")
+        print(f"   DigiPin: {result['digipin']}")
+        print(f"   Coordinates: {result['coordinates']['latitude']}, {result['coordinates']['longitude']}")
+        print(f"   Confidence: {result['confidence']}")
+        
+        # Convert coordinates to DigiPin
+        print("\n2. Converting coordinates to DigiPin...")
+        result = client.coordinates_to_digipin(28.6139, 77.2090)
+        print(f"   Coordinates: 28.6139, 77.2090")
+        print(f"   DigiPin: {result['digipin']}")
+        
+        # Reverse geocode DigiPin
+        print("\n3. Reverse geocoding DigiPin...")
+        result = client.reverse_geocode(result['digipin'])
+        print(f"   DigiPin: {result['digipin']}")
+        print(f"   Coordinates: {result['coordinates']['latitude']}, {result['coordinates']['longitude']}")
+        
+        # Check usage
+        print("\n4. Checking API usage...")
+        usage = client.get_usage()
+        usage_info = usage['usage']
+        print(f"   Current usage: {usage_info['currentUsage']}")
+        print(f"   Monthly limit: {usage_info['monthlyLimit']}")
+        print(f"   Tier: {usage_info['tier']}")
+        
+    except Exception as e:
+        print(f"   Error: {e}")
+
+
+# Example 2: Offline Processing
+def example_offline_processing():
+    print("\n=== Offline Processing ===")
+    
+    try:
+        processor = OfflineProcessor()
+        
+        # Convert coordinates to DigiPin (offline)
+        print("1. Converting coordinates to DigiPin (offline)...")
+        result = processor.coordinates_to_digipin(28.6139, 77.2090)
+        print(f"   Coordinates: 28.6139, 77.2090")
+        print(f"   DigiPin: {result['digipin']}")
+        
+        # Convert DigiPin to coordinates (offline)
+        print("\n2. Converting DigiPin to coordinates (offline)...")
+        result = processor.digipin_to_coordinates(result['digipin'])
+        print(f"   DigiPin: {result['digipin']}")
+        print(f"   Coordinates: {result['coordinates']['latitude']}, {result['coordinates']['longitude']}")
+        
+        # Validate DigiPin
+        print("\n3. Validating DigiPin...")
+        result = processor.validate_digipin("39J-438-TJC7")
+        print(f"   DigiPin: 39J-438-TJC7")
+        print(f"   Valid: {result['isValid']}")
+        
+        # Get grid information
+        print("\n4. Getting grid information...")
+        grid_info = processor.get_grid_info("39J-438-TJC7")
+        print(f"   DigiPin: 39J-438-TJC7")
+        print(f"   Center: {grid_info['center']['latitude']}, {grid_info['center']['longitude']}")
+        print(f"   Grid size: {grid_info['grid_size_meters']}m x {grid_info['grid_size_meters']}m")
+        
+        # Find nearby grids
+        print("\n5. Finding nearby grids...")
+        nearby = processor.find_nearby_grids(28.6139, 77.2090, radius_meters=50)
+        print(f"   Found {len(nearby)} grids within 50m of 28.6139, 77.2090:")
+        for i, grid in enumerate(nearby[:3]):  # Show first 3
+            print(f"   {i+1}. {grid['digipin']} - {grid['distance_meters']:.1f}m away")
+        
+    except Exception as e:
+        print(f"   Error: {e}")
+
+
+# Example 3: CSV Processing
+def example_csv_processing():
+    print("\n=== CSV Processing Example ===")
+    
+    # Create sample CSV files
+    import pandas as pd
+    
+    # Sample coordinates CSV
+    coords_data = {
+        'latitude': [28.6139, 19.0760, 13.0827, 22.5726],
+        'longitude': [77.2090, 72.8777, 80.2707, 88.3639],
+        'location': ['New Delhi', 'Mumbai', 'Chennai', 'Kolkata']
+    }
+    coords_df = pd.DataFrame(coords_data)
+    coords_df.to_csv('sample_coordinates.csv', index=False)
+    print("Created sample_coordinates.csv")
+    
+    try:
+        # Process coordinates to DigiPin (offline)
+        print("\n1. Processing coordinates to DigiPin (offline)...")
+        processor = CSVProcessor(use_offline=True)
+        
+        def progress_callback(processed, total, success, errors):
+            print(f"   Progress: {processed}/{total} - Success: {success}, Errors: {errors}")
+        
+        result = processor.process_coordinates_to_digipin_csv(
+            input_file='sample_coordinates.csv',
+            output_file='coordinates_with_digipin.csv',
+            progress_callback=progress_callback
+        )
+        
+        print(f"\n   Processing complete!")
+        print(f"   Total rows: {result['total_rows']}")
+        print(f"   Success rate: {result['success_rate']:.1%}")
+        print(f"   Output saved to: coordinates_with_digipin.csv")
+        
+        # Show results
+        result_df = pd.read_csv('coordinates_with_digipin.csv')
+        print(f"\n   Sample results:")
+        for _, row in result_df.head(2).iterrows():
+            print(f"   {row['location']}: {row['latitude']}, {row['longitude']} -> {row['digipin']}")
+        
+    except Exception as e:
+        print(f"   Error: {e}")
+    
+    # Cleanup
+    try:
+        os.remove('sample_coordinates.csv')
+        os.remove('coordinates_with_digipin.csv')
+        print("\n   Cleaned up sample files")
+    except:
+        pass
+
+
+if __name__ == '__main__':
+    print("QuantaRoute Geocoding SDK - Basic Usage Examples")
+    print("=" * 50)
+    
+    example_online_api()
+    example_offline_processing()
+    example_csv_processing()
+    
+    print("\n" + "=" * 50)
+    print("Examples completed!")
+    print("\nFor more examples, check the documentation at:")
+    print("https://github.com/quantaroute/quantaroute-geocoding-python")