README

پکیج laravel-neshan یک واسط توسعه‌پذیر و قابل‌اطمینان برای تعامل با API نقشه نشان در Laravel است که تمامی سرویس‌های اصلی نقشه نشان را پوشش می‌دهد. این پکیج با طراحی مبتنی بر اصول SOLID و پیاده‌سازی ماژولار، امکان استفاده از قابلیت‌هایی نظیر مسیریابی، جستجو، تبدیل آدرس و مختصات، نگاشت مسیر، و دریافت نقشه‌های ایستا را به‌صورت یکپارچه در پروژه‌های لاراولی فراهم می‌کند. هدف اصلی این پکیج، تسهیل استفاده از APIهای نشان در محیط Laravel و افزایش بهره‌وری توسعه‌دهندگان در پروژه‌های واقعی است.

✅ امکانات پشتیبانی‌شده

• 🗺️ Static Map
• 📍 Geocoding
• 🧭 Reverse Geocoding
• 🔎 Search
• 🚦 Direction
• 📊 Map Matching

⚙️ نصب

composer require denason/laravel-neshan

🔐 پیکربندی

در فایل .env مقداردهی زیر را انجام دهید:

NESHAN_API_BASE_URL=https://api.neshan.org
NESHAN_MAP_API_KEY=
NESHAN_SERVICE_API_KEY=

سپس فایل پیکربندی را منتشر کنید:

php artisan vendor:publish --tag=neshan-config

🚀 نمونه استفاده (سرویس Direction)

$response = Neshan()
    ->direction()
    ->origin(35.6892, 51.3890)
    ->destination(35.7000, 51.4000)
    ->type('car')
    ->withTraffic()
    ->avoidOddEvenZone()
    ->avoidTrafficZone()
    ->alternative()
    ->bearing(90)
    ->get();

📚 مستندات

مستندات کامل هر سرویس به‌زودی در بخش Wiki منتشر خواهد شد.

🪪 مجوز

این پکیج تحت MIT License منتشر شده است.