README

Uzb Geo Locator --- bu O'zbekiston ichidagi geografik koordinatalar (latitude/longitude) asosida qaysi viloyat yoki hududda joylashganini aniqlovchi PHP/Laravel kutubxona.

GeoJSON formatdagi viloyat chegaralari asosida ishlaydi.

🚀 O'rnatish

1. Composer orqali o'rnatish

composer require azizdevfull/uzb-geo-locator

2. GeoJSON faylni publish qilish (Laravel uchun)

Kutubxona bilan birga kelgan viloyat koordinatalarini storage/app/geo papkaga publish qilish uchun:

php artisan vendor:publish --tag=uzb-geo-data

Bu bilan quyidagi fayl yaratiladi:

storage/app/geo/uzbekistan_regions.geojson

⚙️ Foydalanish

Laravel ichida

use Azizdev\UzbGeoLocator\GeoService;

$geo = app(GeoService::class);

// Toshkent koordinatalari (lat, lng)
$result = $geo->detectRegion(41.3111, 69.2797);

dd($result);

Natija (example):

{
  "ADM1_EN": "Tashkent city",
  "ADM1_RU": "г. Ташкент",
  "ADM1_UZ": "Toshkent sh."
}

Pure PHP loyihalarda (Laravel'siz)

require 'vendor/autoload.php';

use Azizdev\UzbGeoLocator\GeoService;

$geo = new GeoService();
$result = $geo->detectRegion(41.3, 69.2);

print_r($result);

🧠 Texnik tafsilotlar

• Format: GeoJSON polygons
• Aniqlash algoritmi: Ray Casting / Point-in-Polygon
• PHP talabi: >=8.1
• Laravel versiyasi: >=10.x
• Fayl joylashuvi: storage/app/geo/uzbekistan_regions.geojson

📦 Paket struktura

src/
 ├── GeoService.php
 ├── GeoServiceProvider.php
 ├── helpers.php
storage/
 └── app/geo/uzbekistan_regions.geojson

🧑‍💻 Muallif

Azizbek (@azizdevfull)
🔗 GitHub
📺 Laravel, Redis, Octane, RabbitMQ, FastAPI bo'yicha kontentlar muallifi

🪪 Litsenziya

Bu loyiha MIT License asosida tarqatiladi.