پروژه کاوشگر نقشه هوشمند و برنامه‌ریز سفر

پروژه نقشه هوشمند مسافرت | سورس کد پروژه برنامه‌ریز سفر | برنامه ریز هوشمند سفر | اسکریپت های آماده

با «کاوشگر نقشه هوشمند»، نسل جدیدی از برنامه‌ریزی سفر و کاوش جغرافیایی را تجربه کنید. این محصول نوآورانه، قدرت هوش مصنوعی پیشرفته گوگل (Gemini) و پلتفرم بی‌نظیر نقشه گوگل را با هم ترکیب می‌کند تا ایده‌ها و سوالات شما را به تجربیات بصری و تعاملی تبدیل کند. دیگر نیازی به ساعت‌ها جستجوی پراکنده و برنامه‌ریزی دستی نیست؛ کافیست مقصد و مکان مورد نظر خود را بنویسید تا این سیستم هوشمند آن را به یک نقشه زنده و یک برنامه سفر روزانه دقیق تبدیل کند.

ویژگی‌ها و قابلیت‌های اصلی:

این سیستم با دو حالت عملیاتی قدرتمند، تمام نیازهای شما از یک کاوش ساده تا یک برنامه‌ریزی پیچیده را پوشش می‌دهد:

۱. حالت کاوش (Explore Mode):
پاسخی برای تمام کنجکاوی‌های شما! در این حالت، می‌توانید هر سوالی مرتبط با مکان، تاریخ، رویدادها یا مسیرها بپرسید.

• تجسم بصری: سیستم به طور هوشمند نقاط کلیدی مرتبط با درخواست شما را شناسایی کرده و آن‌ها را بر روی نقشه نمایش می‌دهد.
• اطلاعات غنی: برای هر مکان، توضیحات کامل و کاربردی ارائه می‌شود تا درک عمیق‌تری از آن نقطه به دست آورید.
• ارتباطات هوشمند: مکان‌های مرتبط به صورت خودکار با خطوطی به یکدیگر متصل می‌شوند تا ارتباط جغرافیایی یا موضوعی آن‌ها را بهتر درک کنید.
• مثال: “مهم‌ترین مکان‌های شیراز ” یا “مسیر سفر مارکوپولو”.

۲. حالت برنامه‌ریز روزانه (Day Planner Mode):
دستیار سفر شخصی شما! با فعال کردن این حالت، سیستم به یک برنامه‌ریز سفر حرفه‌ای تبدیل می‌شود.

• ایجاد برنامه سفر خودکار: یک برنامه سفر روزانه کامل در هر شهری از جهان را درخواست کنید. سیستم یک برنامه بهینه و منطقی با ۴ تا ۶ توقف اصلی ایجاد می‌کند.
• زمان‌بندی دقیق: برای هر فعالیت، زمان شروع و مدت زمان پیشنهادی مشخص می‌شود تا بتوانید از روز خود نهایت استفاده را ببرید.
• پیشنهاد حمل و نقل: بهترین روش جابجایی بین مکان‌ها (پیاده‌روی، رانندگی، حمل و نقل عمومی) به همراه زمان تخمینی سفر پیشنهاد داده می‌شود.
• تایم‌لاین (Timeline) تعاملی: کل برنامه سفر در یک نمای تایم‌لاین زیبا و خوانا نمایش داده می‌شود که به شما امکان مرور سریع برنامه را می‌دهد.

قابلیت‌های کلیدی دیگر:

• مسیریابی دقیق و گام‌به‌گام: در حالت برنامه‌ریز، با یک کلیک می‌توانید مسیر دقیق و راهنمای قدم‌به‌قدم بین دو نقطه را مستقیماً روی نقشه مشاهده کنید. دیگر نگران گم شدن نخواهید بود.
• کارت‌های اطلاعاتی جذاب: در پایین صفحه، کارت‌های زیبایی برای هر مکان نمایش داده می‌شود. با کلیک بر روی هر کارت، نقشه به صورت هوشمند روی آن مکان متمرکز شده و اطلاعات تکمیلی آن نمایش داده می‌شود.
• اطلاعات آب‌وهوای شبیه‌سازی شده: برای افزودن به جذابیت بصری و کاربردی، یک پیش‌بینی آب‌وهوای شبیه‌سازی شده برای هر مکان نمایش داده می‌شود.
• تاریخچه جستجو: سیستم به طور خودکار جستجوهای اخیر شما را ذخیره می‌کند تا به راحتی بتوانید به کاوش‌های قبلی خود بازگردید و آن‌ها را ادامه دهید.
• خروجی و اشتراک‌گذاری: برنامه سفر خود را با یک کلیک به صورت یک فایل متنی (.txt) دریافت کرده، آن را ذخیره کنید یا با همسفران خود به اشتراک بگذارید.برنامه تولیدی به همان زبانی خواهد بود که از آن سوال پرسیده اید
• طراحی مدرن و واکنش‌گرا (Responsive): این سیستم با طراحی زیبا و کاربرپسند، بر روی تمامی دستگاه‌ها از کامپیوترهای رومیزی گرفته تا تبلت و موبایل به بهترین شکل نمایش داده می‌شود و تجربه‌ای یکپارچه را فراهم می‌کند.

این محصول برای چه کسانی مناسب است؟

• گردشگران و علاقه‌مندان به سفر: برای برنامه‌ریزی سفرهای شخصی، کشف مکان‌های جدید و بهینه‌سازی زمان.
• آژانس‌های مسافرتی و تورلیدرها: برای ایجاد سریع برنامه‌های سفر حرفه‌ای و بصری برای مشتریان.
• وب‌سایت‌های محتوا محور (بلاگ‌های سفر، مجلات گردشگری): برای افزودن یک ابزار تعاملی و جذاب که کاربران را درگیر می‌کند.
• دانش‌آموزان و محققان: برای تجسم داده‌های جغرافیایی و تاریخی در پروژه‌های درسی و تحقیقاتی.
• توسعه‌دهندگان وب: به عنوان یک پروژه آماده، قدرتمند و قابل توسعه برای الهام گرفتن یا ادغام در پروژه‌های بزرگتر.

نیازمندی‌ها و مشخصات فنی پروژه: کاوشگر نقشه هوشمند

۱. خلاصه پروژه (Project Summary)

این پروژه یک وب اپلیکیشن پیشرفته و تعاملی است که به کاربران امکان می‌دهد تا با استفاده از هوش مصنوعی (Google Gemini) و پلتفرم نقشه گوگل (Google Maps)، اطلاعات جغرافیایی را کاوش کرده و برنامه‌های سفر روزانه ایجاد کنند. سیستم قادر است درخواست‌های زبان طبیعی کاربر را درک کرده، مکان‌های مرتبط را استخراج و آن‌ها را به صورت بصری بر روی نقشه نمایش دهد.

این اپلیکیشن دارای دو حالت اصلی است:

1. حالت کاوش (Explore Mode): برای پاسخ به سوالات عمومی مرتبط با مکان‌ها، رویدادها و مسیرها.
2. حالت برنامه‌ریز روزانه (Day Planner Mode): برای ایجاد برنامه‌های سفر دقیق و زمان‌بندی شده.

۲. معماری و تکنولوژی‌های اصلی (Architecture & Core Technologies)

• زبان‌های برنامه‌نویسی:
  • TypeScript: برای منطق اصلی برنامه، تضمین نوع داده‌ها (Type Safety) و کدی خواناتر و قابل نگهداری.
  • HTML5: برای ساختار اصلی صفحات وب.
  • CSS3: برای استایل‌دهی مدرن، طراحی واکنش‌گرا (Responsive) و انیمیشن‌ها.
• APIهای اصلی (Core APIs):
  • Google Gemini API (@google/genai):
    • برای پردازش زبان طبیعی و درک درخواست‌های کاربر.
    • استفاده از قابلیت Function Calling برای استخراج داده‌های ساختاریافته (مکان‌ها، مسیرها، زمان‌بندی).
    • بهره‌گیری از Streaming Responses برای نمایش تدریجی نتایج و بهبود تجربه کاربری.
  • Google Maps Platform JavaScript API:
    • Maps Library: برای نمایش نقشه پایه و استایل‌دهی سفارشی.
    • Marker Library: برای استفاده از AdvancedMarkerElement جهت نمایش پین‌های سفارشی روی نقشه.
    • Routes Library: برای استفاده از DirectionsService (سرویس مسیریابی) و DirectionsRenderer (نمایش مسیر گام‌به‌گام).
    • Geometry Library: برای محاسبات جغرافیایی مانند محاسبه فاصله بین دو نقطه.
    • Custom OverlayView: برای ساخت پاپ‌آپ‌های اطلاعاتی سفارشی با محتوای HTML.
• کتابخانه‌های جانبی:
  • Font Awesome: برای استفاده از آیکون‌های وکتور در سراسر رابط کاربری.

۳. نیازمندی‌های فنی (Technical Requirements)

• کلیدهای API (API Keys):
  1. Google Maps Platform API Key: این کلید برای بارگذاری و استفاده از سرویس‌های نقشه گوگل الزامی است. باید برای APIهای JavaScript Maps, Directions API, و Geocoding API فعال باشد.
  2. Google Gemini API Key: این کلید برای ارتباط با مدل هوش مصنوعی Gemini و پردازش درخواست‌های کاربر ضروری است.
• محیط اجرایی (Execution Environment):
  • یک مرورگر وب مدرن که از ES6 Modules و ویژگی‌های جدید جاوااسکریپت و CSS پشتیبانی کند (مانند Chrome, Firefox, Safari, Edge).
  • اتصال به اینترنت برای فراخوانی APIها.
• وابستگی‌ها (Dependencies):
  • کتابخانه @google/genai که از طریق CDN (esm.sh) در پروژه بارگذاری می‌شود.

۴. مشخصات عملکردی (Functional Specifications)

• ۱. ورودی کاربر و پردازش:
  • یک فیلد متنی (<textarea>) برای دریافت درخواست کاربر.
  • ارسال درخواست با فشردن دکمه “Generate” یا کلید “Enter”.
  • یک سوییچ برای جابجایی بین حالت “کاوش” و “برنامه‌ریز روزانه”.
• ۲. حالت کاوش (Explore Mode):
  • پردازش درخواست‌های عمومی (مانند “مکان‌های تاریخی رم” یا “مسیر جاده ابریشم”).
  • شناسایی و استخراج مکان‌های کلیدی توسط Gemini.
  • نمایش مکان‌ها روی نقشه با استفاده از AdvancedMarkerElement.
  • نمایش پاپ‌آپ‌های اطلاعاتی برای هر مکان با نام و توضیحات.
  • رسم خطوط (Polyline) برای نمایش ارتباط بین مکان‌ها.
  • نمایش کارت‌های اطلاعاتی در یک کاروسل (Carousel) در پایین صفحه.
• ۳. حالت برنامه‌ریز روزانه (Day Planner Mode):
  • پردازش درخواست‌های مربوط به برنامه‌ریزی (مانند “یک روز در پاریس”).
  • استخراج یک برنامه سفر ساختاریافته شامل:
    • لیستی از مکان‌ها با ترتیب بازدید (sequence).
    • زمان پیشنهادی برای بازدید (time).
    • مدت زمان پیشنهادی (duration).
    • روش حمل و نقل بین مکان‌ها (transport).
    • زمان تخمینی سفر (travelTime).
  • نمایش برنامه در یک تایم‌لاین (Timeline) عمودی و تعاملی.
  • قابلیت نمایش مسیرهای دقیق و گام‌به‌گام (Turn-by-Turn Directions) روی نقشه برای هر بخش از سفر.
  • قابلیت خروجی گرفتن (Export) از برنامه سفر به صورت یک فایل متنی (.txt).
• ۴. رابط کاربری نقشه (Map Interface):
  • نقشه با استایل سفارشی برای خوانایی بهتر.
  • زوم و جابجایی خودکار نقشه (fitBounds) برای نمایش تمام نقاط یافت شده.
  • پین‌های سفارشی و پاپ‌آپ‌های حاوی اطلاعات.
  • دکمه “ریست” (Reset) برای پاک کردن نقشه و شروع مجدد.
• ۵. کامپوننت‌های UI:
  • کاروسل کارت‌ها (Card Carousel): نمایش افقی کارت‌های مربوط به هر مکان. با کلیک روی هر کارت، نقشه روی آن مکان متمرکز می‌شود.
  • تایم‌لاین (Timeline Panel): یک پنل کشویی که برنامه روزانه را نمایش می‌دهد. در حالت دسکتاپ کنار نقشه و در موبایل به صورت یک پنل روی نقشه ظاهر می‌شود.
  • تاریخچه جستجو (Search History):
    • ذخیره ۱۰ جستجوی اخیر کاربر در localStorage مرورگر.
    • نمایش تاریخچه در یک منوی کشویی زیر نوار جستجو.
    • امکان پاک کردن تاریخچه.

۵. مشخصات غیرعملکردی (Non-Functional Specifications)

• تجربه کاربری (User Experience – UX):
  • واکنش‌گرا (Responsive): طراحی کاملاً واکنش‌گرا برای نمایش بهینه در دسکتاپ، تبلت و موبایل.
  • تعاملی: تمام عناصر UI (کارت‌ها، آیتم‌های تایم‌لاین، نقشه) کاملاً تعاملی هستند.
  • بازخورد بصری: نمایش اسپینر (Spinner) در هنگام بارگذاری و پیام خطا در صورت بروز مشکل.
• عملکرد (Performance):
  • بارگذاری غیرهمزمان (Asynchronous) API نقشه گوگل برای جلوگیری از مسدود شدن رندر صفحه.
  • استفاده از پاسخ‌های جریانی (Streaming) از Gemini برای نمایش سریع‌تر نتایج اولیه.
• قابلیت توسعه (Extensibility):
  • کد به صورت ماژولار و با تفکیک مسئولیت‌ها (Separation of Concerns) نوشته شده است (مثلاً توابع setPin, setLeg, createTimeline).
  • استفاده از یک آبجکت translations برای مدیریت متون و تسهیل بومی‌سازی (Localization) به زبان‌های دیگر.
  • قابلیت افزودن Function Callingهای جدید به Gemini برای استخراج انواع دیگر داده‌ها.

ویدئوی پیش نمایش

مشخصات فنی پروژه:

• عنوان محصول:پروژه کاوشگر نقشه هوشمند و برنامه‌ریز سفر
• کد محصول:project46
• تاریخ انتشار: 1404
• نسخه :1.2
• زبان رابط کاربری: فارسی
• تعداد فایل:10
• حجم پروژه: 100 کیلوبایت
• ویرایش: دارد
• محدودیت در اجرا: ندارد

مطالعه بیشتر