نمای کلی
راهکار «کاوشگر منطقه سه‌بعدی» روشی کاملاً جدید برای کاوش و تجربه مکان‌ها دراختیارتان قرار می‌دهد. این راه‌حل از قابلیت‌های کاشی‌های سه‌بعدی واقع‌نمای پلاتفرم Google Maps و میانای برنامه‌سازی کاربردی Places برای ایجاد محیط‌های سه‌بعدی جذاب و تعاملی استفاده می‌کند.
«کاوشگر منطقه سه‌بعدی» برای اهداف متعددی طراحی شده است:
بهبود کاوش منطقه: کاربران می‌توانند محله‌ها را به‌صورت مجازی با جزئیات بصری بسیار دقیق کاوش کنند و اطلاعاتی درباره ویژگی‌ها و نشان‌های محلی به‌دست آورند.
ترویج روایت‌های مکان‌محور: توانایی گنجاندن نقاط موردعلاقه با شرح‌های غنی، امکان ایجاد تجربه‌های روایت‌محور را فراهم می‌کند که کاربران را درباره مکان‌های خاص آموزش می‌دهد و مطلع می‌کند.
الهام‌بخشیدن به توسعه بااستفاده از قابلیت‌های سه‌بعدی Google Maps: این برنامه پتانسیل داده‌های نقشه‌برداری سه‌بعدی Google را برای ایجاد نقشه‌های فراگیر و تعاملی نشان می‌دهد
درحال شروع کردن
فعال کردن
فناوری‌های کلیدی
این راه‌حل بااستفاده از دو فناوری کلیدی ساخته شده است:
Google Maps Platform APIs
ما از چندین میانای برنامه‌سازی کاربردی از Google Maps Platform برای دریافت نقشه مبنا و داده‌ها برای ایجاد این تجربه استفاده می‌کنیم:
- کاشی‌های سه‌بعدی واقع‌نمای Google Maps: مدل‌های سه‌بعدی با وضوح بالا از ساختمان‌ها و زمین، نمایشی واقع‌گرایانه و ازنظر بصری جذاب از محیط‌های شهری ارائه می‌دهند.
- Places API: برنامه می‌تواند اطلاعات دقیق درباره «مکان‌های جالب» (POI) در منطقه کاوش‌شده را شناسایی و نمایش دهد و تجربه کاربری را با دانش محلی غنی کند.
- تکمیل خودکار به کاربران کمک می‌کند مکان‌های خاص یا مناطق موردعلاقه را جستجو کنند.
CesiumJS
CesiumJS مسئولیت رندر کردن و نمایش کره سه‌بعدی با وضوح بالا را برعهده دارد. این کتابخانه بار کردن و مصورسازی «کاشی‌های سه‌بعدی واقع‌نمای» Google را که مدل مش سه‌بعدی ساختمان‌ها و زمین را ارائه می‌دهد مدیریت می‌کند.
مدیریت دوربین: CesiumJS ابزارهایی برای کنترل موقعیت، جهت، و حرکت دوربین ارائه می‌دهد. ازجمله:
- تنظیم نقطه دید اولیه برای تمرکز روی محله مشخص‌شده هنگام بار کردن برنامه.
- پیاده‌سازی حرکات پویای دوربین، مانند پویانمایی‌های مدار خودکار برای کاوش.
- مدیریت تعاملات کاربر با کره زمین درصورت وجود چنین ویژگی‌هایی (حرکت عرضی، بزرگ‌نمایی، چرخش).
با نحوه عملکرد کاشی سه‌بعدی واقع‌نما با پردازنده کاشی سه‌بعدی آشنا شوید.
اجزای کلیدی
این برنامه به دو برنامه مختلف تقسیم شده است، یعنی:
- برنامه سرپرست
- برنامه نمایشی
این نمودار نمای کلی تفاوت‌ها و همبستگی بین دو برنامه را نشان می‌دهد:
بررسی بیشتر هر برنامه مفید خواهد بود:
برنامه سرپرست
این برنامه میانای کاربرپسندی ارائه می‌دهد که به شما امکان می‌دهد تجربه سه‌بعدی را سفارشی‌سازی کنید:
جستجوی مکان : از نوار جستجوی «تکمیل خودکار» یکپارچه «پلاتفرم Google Maps» برای پیدا کردن منطقه‌ای که می‌خواهید نمایش دهید استفاده کنید. وقتی مکانی را انتخاب کنید، دوربین به‌طور یکپارچه به آن منطقه پرواز خواهد کرد.
دوربین: سرعت حرکت دوربین و نوع مدار را برای ایجاد تجربه مشاهده انتخاب‌شده تنظیم کنید.
مکان‌ها (نقاط جالب): تراکم، شعاع جستجو، و انواع نقاط جالب (مثلاً رستوران‌ها، کافه‌ها، نشان‌های مکان) را که می‌خواهید نمایش داده شوند تعریف کنید.
از این برنامه برای سفارشی‌سازی تجربه کاربران نهایی‌تان استفاده کنید.
دفتر Google در شیکاگو را با دنبال کردن مسیر آهسته دوربین کاوش کنید.
نمای متراکمی از جاذبه‌های گردشگری اطراف لاس‌وگاس استریپ را ببینید.
اکنون لاس وگاس را با دنبال کردن مسیر دوربین سینوسی پرسرعت کاوش کنید
کاوش گرند کنیون با همه جاذبه‌های گردشگری کلیدی
شرح مفصلی از همه سفارشی‌سازی‌ها در سفارشی‌سازی‌های «کاوشگر سه‌بعدی منطقه» وجود دارد.
برنامه نمایشی
این برنامه نهایی سَمت کاربر است که پیکربندی‌ای را که در برنامه «سرپرست» ایجاد کرده‌اید بار می‌کند. در این محیط سه‌بعدی فراگیر، کاربران می‌توانند مناطق انتخاب‌شده را کاوش کنند و مکان‌هایی را که برجسته کرده‌اید کشف کنند.
پس‌از سفارشی‌سازی ظاهر و حس بااستفاده از برنامه «سرپرست»، می‌توانید پیکربندی را بارگیری کنید و برنامه سفارشی‌تان را از کد منبع اجرا کنید.
تجربه کاربر
برخی‌از ویژگی‌های کلیدی این برنامه عبارت‌اند از:
- کاربران می‌توانند به‌صورت تعاملی منطقه‌ای را به‌صورت سه‌بعدی کاوش کنند، ازجمله ساختمان‌ها، نشان‌های مکان، و زمین.
- کاربران می‌توانند جاهای اطراف (مثل موزه‌ها، پارک‌ها، رستوران‌ها) را جستجو و کاوش کنند.
پس‌از انتخاب مکان، کاربران می‌توانند اطلاعات دقیق یا روایت‌های مربوط به آن مکان را مشاهده کنند.
توسعه‌دهندگان می‌توانند تجربه کاوش خود را ازطریق تنظیمات و کنترل‌ها (درصورت استفاده از برنامه «سرپرست») شخصی‌سازی کنند.
چرخش خودکار فعال است، که به دوربین اجازه می‌دهد به‌طور خودکار حول مرکز ناحیه انتخاب‌شده بچرخد.
پیش‌نیازها
کلید میانای برنامه‌سازی کاربردی Google Maps: به کلید میانای برنامه‌سازی کاربردی معتبری نیاز دارید که میاناهای برنامه‌سازی کاربردی زیر در آن فعال باشد:
سرور وب: می‌توانید برنامه را از یکی از این دو مورد ارائه دهید:
- سرور وب محلی (مثلاً بااستفاده از Node.js، سرور http)
- سرویس میزبانی وب ثابت (برنامه با Dockerfile ارائه می‌شود)
می‌توانید شرح مفصلی از گزینه‌های استقرار را در بخش readme پروژه GitHub پیدا کنید.
استقرار
می‌توانید برنامه را به‌عنوان برنامه گره یا محفظه Docker در هر محیط محفظه‌ای مثل GKE یا GAE مستقر کنید. نسخه نمایشی میزبانی‌شده از معماری زیر استفاده می‌کند:
- در این معماری، کد در پروژه GitHub قرار دارد.
- Cloud Build کد را در هر ارسال به main دریافت می‌کند و عملیات ساخت را راه‌اندازی می‌کند.
- به‌عنوان بخشی از ساخت، کلید میانای برنامه‌سازی کاربردی را تزریق می‌کند و تصویری ایجاد می‌کند که سپس در Artifact Registry ذخیره می‌شود.
- درنهایت، جدیدترین تصویر پایدار را از Artifact Registry در Cloud Run مستقر می‌کند.
- همچنین برای بررسی سلامت برنامه‌های مستقرشده، چند بررسی و پایش سلامت درحال اجرا داریم.
اطلاعات صورت حساب
راهکار «کاوشگر سه‌بعدی منطقه» از سرویس‌های «پلاتفرم Google Maps» برای ارائه تجربه‌ای پویا و فراگیر استفاده می‌کند. برخی‌از میاناهای برنامه‌سازی کاربردی ممکن است هزینه داشته باشند. در اینجا نمای کلی از میاناهای برنامه‌سازی کاربردی و پیوندهای قیمت‌گذاری ارائه شده است.
پلاتفرم Google Maps - 3D Tiles API
راهکار «کاوشگر منطقه سه‌بعدی» از 3D Tiles API برای بهبود تجربه دیداری با داده‌های زمین‌مکانی استفاده می‌کند. برای جزئیات قیمت‌گذاری مربوط به 3D Tiles API، به Google Maps Platform - قیمت‌گذاری 3D Tiles API مراجعه کنید.
پلاتفرم Google Maps - Places API
Places API برای داده‌های مکان‌مبنا به‌کار می‌رود و اطلاعات غنی به تجربه «کاوشگر منطقه سه‌بعدی» اضافه می‌کند. برای درک هزینه‌های مرتبط با Google Places API، به قیمت‌گذاری Places API در «پلاتفرم Google Maps» مراجعه کنید.
پلاتفرم Google Maps - Autocomplete API
ویژگی تکمیل خودکار تعامل کاربر را بهبود می‌بخشد. برای جزئیات قیمت‌گذاری مربوط به Google Maps Autocomplete API، لطفاً به Google Maps Platform - Places Autocomplete Pricing مراجعه کنید.
CesiumJS
از CesiumJS برای تجسم سه‌بعدی کره زمین استفاده می‌شود. درحالی‌که CesiumJS خودش متن‌باز است، ویژگی‌ها یا سرویس‌های تکمیلی ممکن است هزینه‌های مرتبط خودشان را داشته باشند. برای هرگونه پیشنهاد غیررایگان، به اسناد CesiumJS مراجعه کنید.
بسیار مهم است که جزئیات قیمت‌گذاری هر میانای برنامه‌سازی کاربردی را بررسی کنید، زیرا هزینه‌ها به‌طور جداگانه براساس میزان استفاده تعیین می‌شود. توجه داشته باشید که Google Maps Platform یک سطح رایگان با مقدار مشخصی استفاده بدون هزینه ارائه می‌دهد و جزئیات قیمت‌گذاری ممکن است براساس عواملی مانند تعداد درخواست‌ها و منطقه استفاده متفاوت باشد.
همیشه برای دقیق‌ترین و به‌روزترین اطلاعات درباره هزینه‌های استفاده از «پلاتفرم Google Maps» و CesiumJS به صفحه‌های رسمی قیمت‌گذاری مراجعه کنید. برای مدیریت و درک مؤثر هزینه‌های مرتبط، از رعایت شرایط خدمات مشخص‌شده توسط این سرویس‌ها اطمینان حاصل کنید.
نتیجه‌گیری
این سند نمای کلی از قابلیت‌ها، مؤلفه‌ها، تجربه کاربری، و الزامات فنی «کاوشگر سه‌بعدی منطقه» ارائه می‌دهد.
این برنامه با بهره‌گیری از «کاشی‌های سه‌بعدی واقع‌نمای» Google و Places API، کاوش مجازی محله‌ها، کشف مکان‌های جالب، و آشنایی با تاریخ محلی را ممکن می‌سازد.
«کاوشگر سه‌بعدی منطقه» پلاتفرمی با جلوه‌های دیداری خیره‌کننده ارائه می‌دهد، چه برای نمایش یک منطقه، چه برای بهبود کاوش، یا ترویج داستان‌سرایی دیجیتال.
نسخه نمایشی را امتحان کنید و آن را بااستفاده از برنامه «سرپرست» سفارشی‌سازی کنید تا تجربه سه‌بعدی جذاب و آموزنده‌ای ایجاد کنید.