این صفحه حاوی اطلاعاتی درباره ویژگی‌های کلیدی در نقشه‌های سه‌بعدی Photorealistic در Maps JavaScript است که به شما امکان می‌دهد تجربه‌های سه بعدی تعاملی و همه‌جانبه ایجاد کنید. اسناد زیر را پوشش می دهد:
- مدیریت رویدادهای رابط کاربری برای تعامل یکپارچه.
- از جمله کنترل های کاوش برای پیمایش فضاهای سه بعدی.
- استفاده از مسیرهای دوربین از پیش تعیین شده برای تورهای راهنما.
- اعمال محدودیت های دوربین برای حفظ فوکوس روی یک منطقه خاص.
رویدادهای رابط کاربری
این بخش به تشریح رویدادهای تعاملی و اعلان‌های تغییر حالت می‌پردازد که می‌توانید هنگام کار با نقشه‌های سه‌بعدی به آنها گوش دهید و به صورت برنامه‌نویسی به آنها رسیدگی کنید. جاوا اسکریپت در مرورگر رویداد محور است، به این معنی که با ایجاد رویدادهایی که برنامه شما می تواند به آنها گوش دهد و کد را اجرا کند، به تعاملات کاربر پاسخ می دهد.
دو نوع اصلی رویداد وجود دارد:
- رویدادهای تعامل کاربر (مانند کلیک های ماوس) از نمای نقشه سه بعدی به کد شما منتشر می شوند. این رویدادها به شما این امکان را می دهد که به اقدامات مستقیم کاربر در محیط نقشه سه بعدی پاسخ دهید. مشاهده نمونه
- اعلان‌های تغییر حالت، به‌روزرسانی‌های مدل‌های داده‌های نقشه سه‌بعدی و وضعیت رندر را با استفاده از یک طرح نام‌گذاری متعارف
property_changedمنعکس می‌کنند.
هر شیء API نگاشت سه‌بعدی مجموعه‌ای از رویدادهای نام‌گذاری شده را نشان می‌دهد که برنامه شما می‌تواند شنوندگان رویداد را برای آنها ثبت کند و زمانی که آن رویدادها با استفاده از تابع addEventListener() داخلی رخ می‌دهند، منطق را اجرا کند. مثال زیر رویدادهای رایجی را نشان می دهد که هنگام تعامل کاربر با یک نقشه سه بعدی ایجاد می شود.
مثال زیر نشان می‌دهد که کدام رویدادها هنگام تعامل کاربر با نقشه فعال می‌شوند:
کنترل های اکتشافی
نقشه های نمایش داده شده در نقشه های سه بعدی Photorealistic در Maps JavaScript API حاوی عناصر رابط کاربری هستند که از تعامل کاربر با نقشه پشتیبانی می کنند. این عناصر به عنوان کنترل های کاربر شناخته می شوند. کنترل‌های کاوش به‌طور پیش‌فرض گنجانده شده‌اند، اما می‌توانید آنها را در برنامه‌تان حذف کنید .
تصویر زیر کنترل‌های پیش‌فرض نمایش داده‌شده توسط Photorealistic 3D Maps در Maps JavaScript را نشان می‌دهد:
در زیر لیستی از مجموعه کامل کنترل ها در نقشه های سه بعدی فوتورئالیستی در Maps JavaScript آمده است:
- کنترل زوم دکمه های "+" و "-" را برای تغییر سطح بزرگنمایی نقشه نمایش می دهد.
- کنترل Tilt به شما امکان می دهد شیب دوربین را تغییر دهید.
- کنترل چرخش به شما امکان می دهد عنوان دوربین را تغییر دهید.
- کنترل Move دکمه های "←"، "→"، "↑" و "↓" را برای تغییر مرکز نقشه نمایش می دهد.
کنترل دوربین و انیمیشن
مسیرهای دوربین از پیش تعیین شده
نقشه های سه بعدی فوتورئالیستی در Maps جاوا اسکریپت دو مسیر از پیش تعیین شده دوربین را ارائه می دهد. مسیرهای دوربین را می توان با تغییر مدت زمان انیمیشن (در نتیجه افزایش یا کاهش سرعت)، یا با ترکیب آنها برای ایجاد تجربیات سینمایی بیشتر سفارشی کرد.
نقشه های سه بعدی فوتورئالیستی در Maps جاوا اسکریپت از مسیرهای دوربین زیر پشتیبانی می کند:
- انیمیشن
FlyCameraToاز مرکز نقشه به یک مقصد مشخص پرواز می کند. - انیمیشن
FlyCameraAroundحول یک نقطه روی نقشه هر چند بار که مشخص کنید می چرخد.
دو مسیر موجود ممکن است با هم ترکیب شوند تا به نقطه مورد نظر پرواز کنند، در اطراف آن بچرخند و سپس در صورت تمایل متوقف شوند.
محدودیت های دوربین
ممکن است برای شما مطلوب باشد که پانل دوربین، حداکثر ارتفاع، یا ایجاد محدوده های lat/lng که حرکت کاربر را در یک نقشه مشخص محدود می کند، کنترل کنید. با استفاده از محدودیت های دوربین می توانید این کار را انجام دهید.
برای مثالی از نحوه عملکرد و اجرای محدودیت‌های دوربین، به نسخه نمایشی نگاهی بیندازید.