این صفحه رویدادهای رابط کاربری و رخدادهای خطا را توصیف می‌کند که می‌توانید به آنها گوش دهید و به صورت برنامه‌ریزی مدیریت کنید.
رویدادهای رابط کاربری
این بخش به تشریح رویدادهای تعاملی و اعلان‌های تغییر حالت می‌پردازد که می‌توانید هنگام کار با نقشه‌های سه‌بعدی به آنها گوش دهید و به صورت برنامه‌نویسی به آنها رسیدگی کنید. جاوا اسکریپت در مرورگر رویداد محور است، به این معنی که با ایجاد رویدادهایی که برنامه شما می تواند به آنها گوش دهد و کد را اجرا کند، به تعاملات کاربر پاسخ می دهد.
دو نوع اصلی رویداد وجود دارد:
- رویدادهای تعامل کاربر (مانند کلیک های ماوس) از نمای نقشه سه بعدی به کد شما منتشر می شوند. این رویدادها به شما این امکان را می دهد که به اقدامات مستقیم کاربر در محیط نقشه سه بعدی پاسخ دهید. مشاهده نمونه
- اعلان‌های تغییر حالت، به‌روزرسانی‌های مدل‌های داده نقشه سه‌بعدی و وضعیت رندر را با استفاده از یک طرح نام‌گذاری متداول
gmp-propertychangeمنعکس می‌کنند.
هر شیء API نگاشت سه‌بعدی مجموعه‌ای از رویدادهای نام‌گذاری شده را نشان می‌دهد که برنامه شما می‌تواند شنوندگان رویداد را برای آنها ثبت کند و زمانی که آن رویدادها با استفاده از تابع addEventListener() داخلی رخ می‌دهند، منطق را اجرا کند.
نمونه زیر نشان می دهد که کدام رویدادها هنگام تعامل کاربر با نقشه فعال می شوند: