Nigerian geo-data,
finally structured.

<?php

use Illuminate\Support\Facades\Http;

class NigeriaLocationService
{
    private string $base = 'https://nigeria.jamiuadewaleyusuf.com/api/v1';

    public function states(?string $geoZone = null): array
    {
        $params = $geoZone ? ['geo_zone' => $geoZone] : [];
        return Http::get("{$this->base}/states", $params)->json('data');
    }

    public function lgasByState(string $state): array
    {
        return Http::get("{$this->base}/states/{$state}/lgas")->json('data');
    }

    public function reverseGeocode(float $lat, float $lng): ?array
    {
        return Http::get("{$this->base}/geocode/reverse", compact('lat', 'lng'))->json('data');
    }

    public function search(string $query, int $limit = 8): array
    {
        return Http::get("{$this->base}/geocode/search", ['q' => $query, 'limit' => $limit])->json('data');
    }

    public function route(float $fromLat, float $fromLng, float $toLat, float $toLng): array
    {
        return Http::get("{$this->base}/route", [
            'from_lat' => $fromLat, 'from_lng' => $fromLng,
            'to_lat'   => $toLat,   'to_lng'   => $toLng,
        ])->json('data');
    }

    public function nearby(float $lat, float $lng, int $radius = 100): array
    {
        return Http::get("{$this->base}/nearby", compact('lat', 'lng', 'radius'))->json('data');
    }

    public function lookupPostal(string $code): ?array
    {
        $resp = Http::get("{$this->base}/postal-codes/lookup", ['code' => $code])->json();
        return $resp['status'] === 'success' ? $resp['data'] : null;
    }
}

import requests

BASE = "https://nigeria.jamiuadewaleyusuf.com/api/v1"

# States by zone
states = requests.get(f"{BASE}/states", params={"geo_zone": "SW"}).json()["data"]

# LGAs for a state
lgas = requests.get(f"{BASE}/states/lagos/lgas").json()["data"]

# Reverse geocode
geo = requests.get(f"{BASE}/geocode/reverse", params={"lat": 6.45, "lng": 3.39}).json()["data"]

# Address search
places = requests.get(f"{BASE}/geocode/search", params={"q": "Lekki Lagos", "limit": 5}).json()["data"]

# Routing
route = requests.get(f"{BASE}/route", params={
    "from_lat": 6.45, "from_lng": 3.39,
    "to_lat": 9.07,   "to_lng": 7.39
}).json()["data"]

# Distance matrix (POST)
matrix = requests.post(f"{BASE}/distance/matrix", json={
    "origins":      [{"lat": 6.45, "lng": 3.39, "label": "Lagos"}],
    "destinations": [{"lat": 9.07, "lng": 7.39, "label": "Abuja"}]
}).json()["data"]

import 'dart:convert';
import 'package:http/http.dart' as http;

const _base = 'https://nigeria.jamiuadewaleyusuf.com/api/v1';

Future<List> getStates() async {
  final res = await http.get(Uri.parse('$_base/states'));
  return jsonDecode(res.body)['data'];
}

Future<List> getLgas(String state) async {
  final res = await http.get(Uri.parse('$_base/states/$state/lgas'));
  return jsonDecode(res.body)['data'];
}

Future<Map> reverseGeocode(double lat, double lng) async {
  final uri = Uri.parse('$_base/geocode/reverse').replace(
    queryParameters: {'lat': '$lat', 'lng': '$lng'}
  );
  final res = await http.get(uri);
  return jsonDecode(res.body)['data'];
}

Future<Map> getRoute(double fromLat, double fromLng, double toLat, double toLng) async {
  final uri = Uri.parse('$_base/route').replace(queryParameters: {
    'from_lat': '$fromLat', 'from_lng': '$fromLng',
    'to_lat':   '$toLat',   'to_lng':   '$toLng',
  });
  final res = await http.get(uri);
  return jsonDecode(res.body)['data'];
}

import { useState, useEffect, useCallback } from 'react';

const BASE = 'https://nigeria.jamiuadewaleyusuf.com/api/v1';

// State → LGA cascade hook
export function useNigeriaLocation() {
  const [states, setStates]   = useState([]);
  const [lgas, setLgas]       = useState([]);
  const [selected, setSelected] = useState('');

  useEffect(() => {
    fetch(`${BASE}/states`).then(r => r.json()).then(d => setStates(d.data));
  }, []);

  useEffect(() => {
    if (!selected) return setLgas([]);
    fetch(`${BASE}/states/${selected}/lgas`)
      .then(r => r.json()).then(d => setLgas(d.data));
  }, [selected]);

  return { states, lgas, setSelected };
}

// Address autocomplete hook
export function useAddressSearch() {
  const [results, setResults] = useState([]);

  const search = useCallback(async (q) => {
    if (q.length < 3) return setResults([]);
    const data = await fetch(`${BASE}/geocode/search?q=${encodeURIComponent(q)}&limit=6`)
      .then(r => r.json());
    setResults(data.data || []);
  }, []);

  return { results, search };
}

# All states
curl https://nigeria.jamiuadewaleyusuf.com/api/v1/states

# States by geo zone
curl "https://nigeria.jamiuadewaleyusuf.com/api/v1/states?geo_zone=SW"

# LGAs for a state
curl https://nigeria.jamiuadewaleyusuf.com/api/v1/states/lagos/lgas

# Reverse geocode
curl "https://nigeria.jamiuadewaleyusuf.com/api/v1/geocode/reverse?lat=6.45&lng=3.39"

# Address autocomplete
curl "https://nigeria.jamiuadewaleyusuf.com/api/v1/geocode/search?q=Victoria+Island"

# Road route
curl "https://nigeria.jamiuadewaleyusuf.com/api/v1/route?from_lat=6.45&from_lng=3.39&to_lat=9.07&to_lng=7.39"

# LGA-to-LGA route
curl "https://nigeria.jamiuadewaleyusuf.com/api/v1/route/lgas?from=ikeja&to=lekki"

# Nearby (Abuja)
curl "https://nigeria.jamiuadewaleyusuf.com/api/v1/nearby?lat=9.0765&lng=7.3986&radius=50"

# Postal code lookup
curl "https://nigeria.jamiuadewaleyusuf.com/api/v1/postal-codes/lookup?code=900001"

# Validate coordinates
curl "https://nigeria.jamiuadewaleyusuf.com/api/v1/geocode/validate?lat=6.45&lng=3.39"

# Distance matrix (POST)
curl -X POST https://nigeria.jamiuadewaleyusuf.com/api/v1/distance/matrix \
  -H "Content-Type: application/json" \
  -d '{"origins":[{"lat":6.45,"lng":3.39,"label":"Lagos"}],"destinations":[{"lat":9.07,"lng":7.39,"label":"Abuja"}]}'