API Examples & Use Cases

// React example
import { useState, useEffect } from 'react';

const AddressForm = () => {
  const [states, setStates] = useState([]);
  const [districts, setDistricts] = useState([]);
  const [selectedState, setSelectedState] = useState('');

  useEffect(() => {
    fetch('/api/locations/states')
      .then(res => res.json())
      .then(data => setStates(data.data.states));
  }, []);

  const handleStateChange = async (stateId) => {
    setSelectedState(stateId);
    const response = await fetch(`/api/locations/districts?state_id=${stateId}`);
    const data = await response.json();
    setDistricts(data.data.districts);
  };

  return (
    <form>
      <select onChange={(e) => handleStateChange(e.target.value)}>
        <option value="">Select State</option>
        {states.map(state => (
          <option key={state.id} value={state.id}>
            {state.name}
          </option>
        ))}
      </select>
      
      <select disabled={!selectedState}>
        <option value="">Select District</option>
        {districts.map(district => (
          <option key={district.id} value={district.id}>
            {district.name}
          </option>
        ))}
      </select>
    </form>
  );
};

import requests
import pandas as pd
import matplotlib.pyplot as plt

# Get all states
response = requests.get('https://india-location-hub.in/api/stats')
stats = response.json()['data']

# Create visualization
data = {
    'Category': ['States', 'Districts', 'Talukas', 'Villages'],
    'Count': [
        stats['totalStates'],
        stats['totalDistricts'], 
        stats['totalTalukas'],
        stats['totalVillages']
    ]
}

df = pd.DataFrame(data)
df.plot(x='Category', y='Count', kind='bar', title='India Location Distribution')
plt.yscale('log')  # Use log scale for better visualization
plt.show()

# Get district-wise data for Maharashtra
mh_response = requests.get('https://india-location-hub.in/api/locations/districts?state_id=1')
mh_districts = mh_response.json()['data']['districts']
print(f"Maharashtra has {len(mh_districts)} districts")

// Node.js Express service
const express = require('express');
const axios = require('axios');
const app = express();

const LOCATION_API_BASE = 'https://india-location-hub.in/api';

// Middleware to cache location data
const cache = new Map();

const cacheMiddleware = (req, res, next) => {
  const key = req.originalUrl;
  if (cache.has(key)) {
    return res.json(cache.get(key));
  }
  next();
};

// Get user's location hierarchy
app.get('/user-location/:stateId/:districtId', cacheMiddleware, async (req, res) => {
  try {
    const { stateId, districtId } = req.params;
    
    // Get state info
    const stateResponse = await axios.get(`${LOCATION_API_BASE}/locations/states`);
    const state = stateResponse.data.data.states.find(s => s.id == stateId);
    
    // Get district info
    const districtResponse = await axios.get(
      `${LOCATION_API_BASE}/locations/districts?state_id=${stateId}`
    );
    const district = districtResponse.data.data.districts.find(d => d.id == districtId);
    
    const result = {
      state: state,
      district: district,
      hierarchy: `${state?.name} > ${district?.name}`
    };
    
    // Cache for 1 hour
    cache.set(req.originalUrl, result);
    setTimeout(() => cache.delete(req.originalUrl), 3600000);
    
    res.json(result);
  } catch (error) {
    res.status(500).json({ error: 'Failed to fetch location data' });
  }
});

app.listen(3000, () => {
  console.log('Location service running on port 3000');
});