شروع به کار با «کاوشگر سه‌بعدی منطقه»

تصویر

نمای کلی

راهکار «کاوشگر منطقه سه‌بعدی» روشی کاملاً جدید برای کاوش و تجربه مکان‌ها دراختیارتان قرار می‌دهد. این راهکار از قابلیت‌های پلاتفرم Google Maps کاشی‌های سه‌بعدی واقع‌نمای و میانای برنامه‌سازی کاربردی مکان‌ها برای ایجاد محیط‌های سه‌بعدی تعاملی و جذاب استفاده می‌کند.

«کاوشگر منطقه سه‌بعدی» برای اهداف متعددی طراحی شده است:

  • بهبود کاوش منطقه: کاربران می‌توانند محله‌ها را به‌صورت مجازی با جزئیات تصویری زیاد کاوش کنند و اطلاعات آماری درباره ویژگی‌های محلی و نشان‌های دیدنی کسب کنند.

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

  • الهام‌بخش توسعه بااستفاده از قابلیت‌های سه‌بعدی Google Maps: این قابلیت پتانسیل داده‌های نقشه‌برداری سه‌بعدی Google را برای ایجاد نقشه‌های فراگیر و تعاملی نشان می‌دهد

شروع به کار:

فعال کردن

فناوری‌های کلیدی

این راه‌حل بااستفاده از دو فناوری کلیدی ساخته شده است:

میاناهای برنامه‌سازی کاربردی پلاتفرم Google Maps:

برای دریافت نقشه پایه و داده‌های لازم برای ایجاد این تجربه، از چندین «میانای برنامه‌سازی کاربردی» از «پلاتفرم Google Maps» استفاده می‌کنیم:

  • کاشی‌های سه‌بعدی واقع‌نمای Google Maps: مدل‌های سه‌بعدی با وضوح بالا از ساختمان‌ها و زمین، نمایشی واقع‌گرایانه و ازنظر بصری جذاب از محیط‌های شهری ارائه می‌دهند.
  • Places API: برنامه می‌تواند اطلاعات دقیق درباره نقاط جالب (POI) در منطقه کاوش‌شده را شناسایی و نمایش دهد و تجربه کاربری را با دانش محلی غنی‌تر کند.
  • تکمیل خودکار به کاربران کمک می‌کند مکان‌ها یا مناطق خاص موردعلاقه را جستجو کنند.

CesiumJS

CesiumJS مسئولیت رندر کردن و نمایش کره سه‌بعدی با وضوح بالا را برعهده دارد. این کتابخانه بار کردن و مصورسازی «کاشی‌های سه‌بعدی واقع‌نمای» Google را مدیریت می‌کند که مدل مش سه‌بعدی ساختمان‌ها و زمین را ارائه می‌دهد.

مدیریت دوربین: CesiumJS ابزارهایی برای کنترل موقعیت، جهت، و حرکت دوربین ارائه می‌دهد. ازجمله:

  • تنظیم دیدگاه اولیه برای تمرکز روی محله مشخص‌شده هنگام بار کردن برنامه.
  • پیاده‌سازی حرکات پویای دوربین، مانند پویانمایی‌های چرخش خودکار برای کاوش.
  • مدیریت تعاملات کاربر با کره زمین درصورت وجود چنین ویژگی‌هایی (حرکت عرضی، بزرگ‌نمایی، چرخش).

ببینید کاشی سه‌بعدی واقع‌نما چگونه می‌تواند با رندرکننده «کاشی‌های سه‌بعدی» کار کند.

اجزای کلیدی

این برنامه به دو برنامه مختلف تقسیم می‌شود، یعنی:

  • برنامه سرپرست
  • برنامه نمایشی

این نمودار نمای کلی از تفاوت‌ها و همبستگی بین دو برنامه را ارائه می‌دهد:

تصویر

بهتر است هر برنامه را بیشتر بررسی کنید:

برنامه سرپرست

این برنامه میانای کاربرپسندی ارائه می‌دهد که به شما امکان می‌دهد تجربه سه‌بعدی را سفارشی‌سازی کنید:

  • جستجوی مکان : از نوار جستجوی «تکمیل خودکار پلاتفرم Google Maps» یکپارچه استفاده کنید تا منطقه‌ای را که می‌خواهید نمایش دهید پیدا کنید. پس‌از انتخاب مکان، دوربین به‌طور یکپارچه به آن منطقه پرواز می‌کند.

  • دوربین: سرعت حرکت دوربین و نوع گردش را برای ایجاد تجربه تماشای انتخاب‌شده تنظیم کنید.

  • مکان‌ها (نقاط موردعلاقه): تراکم، شعاع جستجو، و انواع نقاط موردعلاقه (مثلاً رستوران‌ها، کافه‌ها، نشان‌های مکان) را که می‌خواهید نمایش داده شود تعریف کنید.

از این برنامه برای سفارشی‌سازی تجربه کاربران نهایی‌تان استفاده کنید.

شرح مفصلی از همه سفارشی‌سازی‌های سفارشی‌سازی‌های «کاوشگر منطقه سه‌بعدی» وجود دارد.

برنامه نمایشی

این برنامه نهایی و سَمت کاربر است که پیکربندی‌ای را که در برنامه «سرپرست» ایجاد کرده‌اید بار می‌کند. در این محیط سه‌بعدی فراگیر، کاربران می‌توانند مناطق انتخاب‌شده را کاوش کنند و مکان‌هایی را که برجسته کرده‌اید کشف کنند.

پس‌از سفارشی‌سازی ظاهر و احساس بااستفاده از برنامه «سرپرست»، می‌توانید پیکربندی را بارگیری کنید و برنامه سفارشی‌تان را از کد منبع اجرا کنید.

تجربه کاربر

تصویر

برخی‌از ویژگی‌های کلیدی این برنامه عبارت‌اند از:

  1. کاربران می‌توانند به‌صورت تعاملی منطقه‌ای را به‌صورت سه‌بعدی، ازجمله ساختمان‌ها، نشانگرهای مکان، و زمین، کاوش کنند.
  2. کاربران می‌توانند مکان‌های اطراف (مثلاً موزه‌ها، پارک‌ها، رستوران‌ها) را جستجو و کشف کنند.
  3. پس‌از انتخاب مکان، کاربران می‌توانند اطلاعات دقیق یا روایت‌های مربوط به آن مکان را مشاهده کنند.

  4. توسعه‌دهندگان می‌توانند تجربه کاوش خود را ازطریق تنظیمات و کنترل‌ها (درصورت استفاده از برنامه «سرپرست») شخصی‌سازی کنند.

  5. چرخش خودکار فعال است و به دوربین اجازه می‌دهد به‌طور خودکار حول مرکز ناحیه انتخاب‌شده بچرخد.

پیش‌نیازها

  1. کلید Google Maps API: به کلید میانای برنامه‌سازی کاربردی معتبری نیاز دارید که میاناهای برنامه‌سازی کاربردی زیر در آن فعال باشد:

  2. سرور وب: می‌توانید برنامه را از یکی از این موارد ارائه دهید:

    • سرور وب محلی (مثلاً بااستفاده از Node.js، سرور http)
    • سرویس میزبانی وب ثابت (برنامه با Dockerfile ارائه می‌شود)

می‌توانید شرح مفصلی از گزینه‌های استقرار را در بخش readme پروژه GitHub پیدا کنید.

استقرار

می‌توانید برنامه را به‌عنوان برنامه گره یا محفظه Docker در هر محیط محفظه‌ای مثل GKE یا GAE مستقر کنید. نسخه نمایشی میزبانی‌شده از معماری زیر استفاده می‌کند:

تصویر

  • در این معماری، کد در پروژه GitHub قرار دارد.
  • ‫Cloud build کد را در هر ارسال به main دریافت می‌کند و عملیات ساخت را راه‌اندازی می‌کند.
  • به‌عنوان بخشی از ساخت، کلید API را تزریق می‌کند و تصویری ایجاد می‌کند که سپس در ثبت‌کننده آرتیفکت ذخیره می‌شود.
  • درنهایت، جدیدترین تصویر پایدار را از «ثبت آرتیفکت» در Cloud Run مستقر می‌کند.
  • همچنین بررسی‌های سلامت و پایش‌هایی برای بررسی سلامت برنامه‌های مستقرشده داریم.

اطلاعات صورت حساب

راهکار «کاوشگر منطقه سه‌بعدی» از سرویس‌های «پلاتفرم Google Maps» برای ارائه تجربه‌ای فراگیر و پویا استفاده می‌کند. برخی‌از «میاناهای برنامه‌سازی کاربردی» ممکن است هزینه داشته باشند. در اینجا نمای کلی از APIها و پیوندهای قیمت‌گذاری ارائه شده است.

پلاتفرم Google Maps - ‏3D Tiles API:

راه‌حل «داستان‌سرایی» از «میانای برنامه‌سازی کاربردی کاشی‌های سه‌بعدی» برای بهبود تجربه دیداری با داده‌های زمین‌مکانی استفاده می‌کند. برای جزئیات قیمت‌گذاری مربوط به API کاشی‌های سه‌بعدی، به Google Maps Platform - قیمت‌گذاری API کاشی‌های سه‌بعدی مراجعه کنید.

پلاتفرم Google Maps - Places API:

از «میانای برنامه‌سازی کاربردی مکان‌ها» برای داده‌های مکان‌مبنا استفاده می‌شود و اطلاعات غنی به تجربه داستان‌سرایی اضافه می‌شود. برای درک هزینه‌های مرتبط با Google Places API، به قیمت‌گذاری Places API در «پلاتفرم Google Maps» مراجعه کنید.

پلاتفرم Google Maps - میانای برنامه‌سازی کاربردی تکمیل خودکار:

ویژگی تکمیل خودکار تعامل کاربر را بهبود می‌بخشد. برای جزئیات قیمت‌گذاری درباره «میانای برنامه‌سازی کاربردی تکمیل خودکار Google Maps»، لطفاً به «پلاتفرم Google Maps» - قیمت‌گذاری تکمیل خودکار مکان‌ها مراجعه کنید.

CesiumJS:

از CesiumJS برای تجسم سه‌بعدی کره زمین استفاده می‌شود. اگرچه خود CesiumJS متن‌باز است، ویژگی‌ها یا خدمات اضافی ممکن است هزینه‌های مربوط به خود را داشته باشند. برای هرگونه پیشنهاد ویژه، به «مستندات CesiumJS» مراجعه کنید.

بسیار مهم است که جزئیات قیمت‌گذاری را برای هر میانای برنامه‌سازی کاربردی مربوطه مرور کنید، زیرا هزینه‌ها به‌طور جداگانه براساس استفاده تعیین می‌شود. توجه داشته باشید که Google Maps Platform سطح رایگانی با مقدار مشخصی استفاده بدون هزینه ارائه می‌دهد و جزئیات قیمت‌گذاری ممکن است براساس عواملی مانند تعداد درخواست‌ها و منطقه استفاده متفاوت باشد.

همواره برای دقیق‌ترین و به‌روزترین اطلاعات درباره هزینه‌های استفاده از «پلاتفرم Google Maps» و CesiumJS، به صفحه‌های قیمت‌گذاری رسمی مراجعه کنید. برای مدیریت و درک مؤثر هزینه‌های مرتبط، از رعایت شرایط خدمات مشخص‌شده توسط این سرویس‌ها اطمینان حاصل کنید.

نتیجه‌گیری

این سند نمای کلی از قابلیت‌های «کاوشگر ناحیه سه‌بعدی»، اجزا، تجربه کاربری، و الزامات فنی ارائه می‌دهد.

این برنامه با بهره‌گیری از «کاشی‌های سه‌بعدی واقع‌نمای Google» و Places API، امکان کاوش مجازی محله‌ها، کشف نقاط جالب، و آشنایی با تاریخ محلی را فراهم می‌کند.

«کاوشگر سه‌بعدی منطقه» پلاتفرمی با جلوه‌های دیداری خیره‌کننده ارائه می‌دهد، چه برای نمایش یک منطقه، چه برای بهبود کاوش، یا ترویج داستان‌سرایی دیجیتال.

نسخه نمایشی را امتحان کنید و آن را بااستفاده از برنامه «سرپرست» سفارشی‌سازی کنید تا تجربه‌ای سه‌بعدی، جذاب، و آموزنده ایجاد کنید.