3D Maps

کلاس Map3DElement

google.maps.maps3d . Map3DElement کلاس google.maps.maps3d . Map3DElement

Map3DElement یک رابط HTML برای نمای نقشه سه بعدی است. توجه داشته باشید که mode باید تنظیم شود تا نقشه سه بعدی شروع به رندر کند.

عنصر سفارشی:
<gmp-map-3d center="lat,lng,altitude" default-ui-disabled heading="number" internal-usage-attribution-ids="id1 id2" max-altitude="number" max-heading="number" max-tilt="number" min-altitude="number" min-heading="number" min-tilt="number" mode="hybrid" range="number" roll="number" tilt="number"></gmp-map-3d>

این کلاس HTMLElement را گسترش می دهد.

این کلاس Map3DElementOptions را پیاده سازی می کند.

با فراخوانی const {Map3DElement} = await google.maps.importLibrary("maps3d") دسترسی پیدا کنید.
کتابخانه ها را در Maps JavaScript API ببینید.

Map3DElement
Map3DElement([options])
پارامترها:
bounds
نوع: LatLngBounds | LatLngBoundsLiteral optional
وقتی تنظیم شود، موقعیت دوربین را در محدوده های lat/lng مشخص شده محدود می کند. توجه داشته باشید که اشیاء خارج از محدوده هنوز رندر می شوند. کرانها می توانند هم طول و هم عرض جغرافیایی را محدود کنند، یا فقط می توانند طول یا عرض جغرافیایی را محدود کنند. برای مرزهای فقط عرض جغرافیایی، از طول جغرافیایی غربی و شرقی به ترتیب -180 و 180 استفاده کنید. برای محدوده‌های فقط طول جغرافیایی، از عرض‌های شمالی و جنوبی به ترتیب 90 و -90 استفاده کنید.
center
مرکز نقشه به عنوان LatLngAltitude داده می شود، که در آن ارتفاع بر حسب متر از سطح زمین است. توجه داشته باشید که این مکان لزوماً جایی نیست که دوربین قرار دارد، زیرا میدان range بر فاصله دوربین از مرکز نقشه تأثیر می گذارد. اگر تنظیم نشود، پیش‌فرض روی {lat: 0, lng: 0, altitude: 63170000} پیش‌فرض می‌شود. 63170000 متر حداکثر ارتفاع مجاز است (شعاع زمین ضربدر 10).
ویژگی HTML:
  • <gmp-map-3d center="lat,lng,altitude"></gmp-map-3d>
defaultUIDisabled
نوع: boolean optional
پیش فرض: false
وقتی true ، همه دکمه‌های رابط کاربری پیش‌فرض غیرفعال می‌شوند. کنترل های صفحه کلید و اشاره را غیرفعال نمی کند.
ویژگی HTML:
  • <gmp-map-3d default-ui-disabled></gmp-map-3d>
heading
نوع: number optional
عنوان قطب نما نقشه، بر حسب درجه، که در آن سمت شمال صفر است. هنگامی که شیب وجود ندارد، هر رول به عنوان عنوان تفسیر می شود.
ویژگی HTML:
  • <gmp-map-3d heading="number"></gmp-map-3d>
internalUsageAttributionIds
نوع: Iterable <string> optional
شناسه انتساب استفاده را به مقداردهی اولیه اضافه می‌کند، که به Google کمک می‌کند بفهمد کدام کتابخانه‌ها و نمونه‌ها برای توسعه‌دهندگان مفید هستند، مانند استفاده از کتابخانه خوشه‌بندی نشانگر. برای انصراف از ارسال شناسه انتساب استفاده، می‌توانید این ویژگی را پاک کنید. فقط مقادیر منحصر به فرد ارسال خواهد شد. ممکن است تغییرات این مقدار پس از نمونه سازی نادیده گرفته شود.
ویژگی HTML:
  • <gmp-map-3d internal-usage-attribution-ids="id1 id2"></gmp-map-3d>
maxAltitude
نوع: number optional
حداکثر ارتفاع از سطح زمین که روی نقشه نمایش داده می شود. یک مقدار معتبر بین 0 تا 63170000 متر است (شعاع زمین ضربدر 10).
ویژگی HTML:
  • <gmp-map-3d max-altitude="number"></gmp-map-3d>
maxHeading
نوع: number optional
حداکثر زاویه عنوان (چرخش) نقشه. یک مقدار معتبر بین 0 تا 360 درجه است. minHeading و maxHeading بازه‌ای از <= 360 درجه را نشان می‌دهند که در آن حرکات عنوان مجاز خواهند بود. minHeading = 180 و maxHeading = 90 اجازه می دهد عنوان در [0, 90] و عنوان در [180, 360] . minHeading = 90 و maxHeading = 180 اجازه می دهد عنوان در [90, 180] قرار گیرد.
ویژگی HTML:
  • <gmp-map-3d max-heading="number"></gmp-map-3d>
maxTilt
نوع: number optional
حداکثر زاویه تابش نقشه. یک مقدار معتبر بین 0 تا 90 درجه است.
ویژگی HTML:
  • <gmp-map-3d max-tilt="number"></gmp-map-3d>
minAltitude
نوع: number optional
حداقل ارتفاع از سطح زمین که روی نقشه نمایش داده می شود. یک مقدار معتبر بین 0 تا 63170000 متر است (شعاع زمین ضربدر 10).
ویژگی HTML:
  • <gmp-map-3d min-altitude="number"></gmp-map-3d>
minHeading
نوع: number optional
حداقل زاویه عنوان (چرخش) نقشه. یک مقدار معتبر بین 0 تا 360 درجه است. minHeading و maxHeading بازه‌ای از <= 360 درجه را نشان می‌دهند که در آن حرکات عنوان مجاز خواهند بود. minHeading = 180 و maxHeading = 90 اجازه می دهد عنوان در [0, 90] و عنوان در [180, 360] . minHeading = 90 و maxHeading = 180 اجازه می دهد عنوان در [90, 180] قرار گیرد.
ویژگی HTML:
  • <gmp-map-3d min-heading="number"></gmp-map-3d>
minTilt
نوع: number optional
حداقل زاویه برخورد نقشه یک مقدار معتبر بین 0 تا 90 درجه است.
ویژگی HTML:
  • <gmp-map-3d min-tilt="number"></gmp-map-3d>
mode
نوع: MapMode optional
حالتی را مشخص می کند که نقشه باید در آن رندر شود. اگر تنظیم نشود، نقشه ارائه نمی شود.
ویژگی HTML:
  • <gmp-map-3d mode="hybrid"></gmp-map-3d>
  • <gmp-map-3d mode="satellite"></gmp-map-3d>
range
نوع: number optional
فاصله دوربین تا مرکز نقشه، بر حسب متر.
ویژگی HTML:
  • <gmp-map-3d range="number"></gmp-map-3d>
roll
نوع: number optional
چرخش دوربین به دور بردار نما بر حسب درجه. برای رفع ابهامات، هنگامی که شیب وجود ندارد، هر رول به عنوان عنوان تفسیر می شود.
ویژگی HTML:
  • <gmp-map-3d roll="number"></gmp-map-3d>
tilt
نوع: number optional
شیب بردار نمای دوربین بر حسب درجه. بردار نمایی که مستقیماً به زمین نگاه می کند، دارای شیب صفر درجه است. بردار نمایی که به دور از زمین باشد دارای شیب 180 درجه خواهد بود.
ویژگی HTML:
  • <gmp-map-3d tilt="number"></gmp-map-3d>
addEventListener
addEventListener(type, listener[, options])
پارامترها:
  • type : string یک رشته حساس به حروف کوچک و بزرگ که نشان دهنده نوع رویداد برای گوش دادن است.
  • listener : EventListener | EventListenerObject شی ای که اعلان دریافت می کند. این باید یک تابع یا یک شی با متد handleEvent باشد
  • options : boolean| AddEventListenerOptions optional گزینه ها را ببینید. رویدادهای سفارشی فقط از capture و passive پشتیبانی می کنند.
مقدار برگشتی: void
تابعی را تنظیم می کند که هر زمان که رویداد مشخص شده به هدف تحویل داده شود فراخوانی می شود. به addEventListener مراجعه کنید.
flyCameraAround
flyCameraAround(options)
پارامترها:
ارزش بازگشتی: ندارد
این روش برای مدت زمان معینی دوربین را به دور یک مکان معین می چرخاند و تعداد دور معین را در آن زمان ایجاد می کند.

به طور پیش فرض، دوربین در جهت عقربه های ساعت می چرخد. اگر برای دورها عدد منفی داده شود، دوربین به جای آن در جهت خلاف جهت عقربه های ساعت می چرخد.

این روش ناهمزمان است زیرا انیمیشن‌ها تنها پس از بارگیری نقشه حداقل می‌توانند شروع شوند. این روش پس از شروع انیمیشن باز می گردد.

اگر تعداد دورها صفر باشد، هیچ چرخشی رخ نخواهد داد و انیمیشن بلافاصله پس از شروع کامل می شود.
flyCameraTo
flyCameraTo(options)
پارامترها:
ارزش بازگشتی: ندارد
این روش دوربین را به صورت سهموی از مکان فعلی به یک مکان انتهایی معین در مدت زمان معین حرکت می دهد.

این روش ناهمزمان است زیرا انیمیشن‌ها تنها پس از بارگیری نقشه حداقل می‌توانند شروع شوند. این روش پس از شروع انیمیشن باز می گردد.
removeEventListener
removeEventListener(type, listener[, options])
پارامترها:
  • type : string رشته ای که نوع رویدادی را که برای حذف شنونده رویداد مشخص می کند.
  • listener : EventListener | EventListenerObject شنونده رویداد کنترل کننده رویداد برای حذف از هدف رویداد.
  • options : boolean| EventListenerOptions optional گزینه ها را ببینید.
مقدار برگشتی: void
شنونده رویدادی که قبلاً با addEventListener ثبت شده بود را از هدف حذف می کند. removeEventListener را ببینید.
stopCameraAnimation
stopCameraAnimation()
پارامترها: ندارد
ارزش بازگشتی: ندارد
این روش هر انیمیشن پروازی را که ممکن است در حال اجرا باشد متوقف می کند. دوربین هر جا که در میان انیمیشن باشد باقی می ماند. به نقطه پایانی تله پورت نمی کند.

این روش ناهمزمان است زیرا انیمیشن ها تنها پس از بارگیری نقشه حداقل می توانند شروع یا متوقف شوند. زمانی که انیمیشن متوقف شد، روش برمی گردد.
gmp-animationend
function(animationEndEvent)
استدلال ها:
  • animationEndEvent : Event
این رویداد با پایان انیمیشن fly اجرا می شود. این رویداد از طریق درخت DOM حباب می شود.
gmp-centerchange
function(centerChangeEvent)
استدلال ها:
  • centerChangeEvent : Event
این رویداد زمانی فعال می شود که ویژگی مرکزی Map3DElement تغییر کند.
gmp-click
function(clickEvent)
استدلال ها:
این رویداد با کلیک روی عنصر Map3DElement فعال می شود.
gmp-error
function(mapInitializationErrorEvent)
استدلال ها:
  • mapInitializationErrorEvent : Event
این رویداد زمانی فعال می شود که نقشه نتواند مقداردهی اولیه شود.
gmp-headingchange
function(headingChangeEvent)
استدلال ها:
  • headingChangeEvent : Event
این رویداد زمانی فعال می شود که ویژگی عنوان Map3DElement تغییر کند.
gmp-rangechange
function(rangeChangeEvent)
استدلال ها:
  • rangeChangeEvent : Event
این رویداد زمانی فعال می شود که ویژگی محدوده Map3DElement تغییر کند.
gmp-rollchange
function(rollChangeEvent)
استدلال ها:
این رویداد زمانی فعال می شود که ویژگی رول Map3DElement تغییر کند.
gmp-steadychange
function(steadyChangeEvent)
استدلال ها:
این رویداد زمانی فعال می شود که حالت ثابت Map3DElement تغییر کند.
gmp-tiltchange
function(tiltChangeEvent)
استدلال ها:
این رویداد زمانی فعال می شود که ویژگی شیب Map3DElement تغییر کند.

رابط Map3DElementOptions

google.maps.maps3d . Map3DElementOptions رابط google.maps.maps3d . Map3DElementOptions

شی Map3DElementOptions برای تعریف ویژگی هایی که می توان روی Map3DElement تنظیم کرد استفاده می شود.

bounds optional
نوع: LatLngBounds | LatLngBoundsLiteral optional
Map3DElement.bounds را ببینید.
center optional
Map3DElement.center را ببینید.
defaultUIDisabled optional
نوع: boolean optional
Map3DElement.defaultUIDisabled را ببینید.
heading optional
نوع: number optional
Map3DElement.heading را ببینید.
internalUsageAttributionIds optional
نوع: Iterable <string> optional
Map3DElement.internalUsageAttributionIds را ببینید.
maxAltitude optional
نوع: number optional
Map3DElement.maxAltitude را ببینید.
maxHeading optional
نوع: number optional
Map3DElement.maxHeading را ببینید.
maxTilt optional
نوع: number optional
Map3DElement.maxTilt را ببینید.
minAltitude optional
نوع: number optional
Map3DElement.minAltitude را ببینید.
minHeading optional
نوع: number optional
Map3DElement.minHeading را ببینید.
minTilt optional
نوع: number optional
Map3DElement.minTilt را ببینید.
mode optional
نوع: MapMode optional
Map3DElement.mode را ببینید.
range optional
نوع: number optional
Map3DElement.range را ببینید.
roll optional
نوع: number optional
Map3DElement.roll را ببینید.
tilt optional
نوع: number optional
Map3DElement.tilt را ببینید.

ثابت های MapMode

google.maps.maps3d . MapMode ثابت های google.maps.maps3d . MapMode

حالتی را مشخص می کند که نقشه باید در آن رندر شود.

با فراخوانی const {MapMode} = await google.maps.importLibrary("maps3d") دسترسی پیدا کنید.
کتابخانه ها را در Maps JavaScript API ببینید.

HYBRID این حالت نقشه یک لایه شفاف از خیابان‌های اصلی را در ماهواره یا تصاویر واقعی واقعی نشان می‌دهد.
SATELLITE این حالت نقشه، تصاویر ماهواره ای یا واقعی را در صورت وجود نمایش می دهد.

رابط FlyAroundAnimationOptions

google.maps.maps3d . FlyAroundAnimationOptions رابط google.maps.maps3d . FlyAroundAnimationOptions

گزینه های سفارشی سازی برای انیمیشن FlyCameraAround.

camera
نوع: CameraOptions
نقطه مرکزی که دوربین باید در طول انیمیشن مداری به آن نگاه کند. توجه داشته باشید که عنوان نقشه با چرخش دوربین به دور این نقطه مرکزی تغییر می کند.
durationMillis optional
نوع: number optional
مدت زمان انیمیشن بر حسب میلی ثانیه این مدت زمان کل انیمیشن است، نه مدت زمان یک چرخش.
rounds optional
نوع: number optional
تعداد دورهایی که در مدت زمان معین به دور مرکز می چرخند. این سرعت کلی چرخش را کنترل می کند. انتقال یک عدد منفی به دور باعث می شود که دوربین به جای جهت پیش فرض در جهت عقربه های ساعت در جهت خلاف جهت عقربه های ساعت بچرخد.

رابط FlyToAnimationOptions

google.maps.maps3d . FlyToAnimationOptions رابط google.maps.maps3d . FlyToAnimationOptions

گزینه های سفارشی سازی برای انیمیشن FlyCameraTo.

endCamera
نوع: CameraOptions
مکانی که دوربین باید در انتهای انیمیشن به آن اشاره کند.
durationMillis optional
نوع: number optional
مدت زمان انیمیشن بر حسب میلی ثانیه مدت زمان 0 دوربین را مستقیماً به موقعیت انتهایی تله پورت می کند.

رابط CameraOptions

google.maps.maps3d . CameraOptions رابط google.maps.maps3d . CameraOptions

شیء CameraOptions برای تعریف ویژگی‌هایی که می‌توان روی یک شی دوربین تنظیم کرد استفاده می‌شود. شی دوربین می تواند هر چیزی باشد که موقعیت دوربین دارد، به عنوان مثال وضعیت نقشه فعلی، یا وضعیت انیمیشن درخواستی آینده.

center optional
Map3DElement.center را ببینید.
heading optional
نوع: number optional
Map3DElement.heading را ببینید.
range optional
نوع: number optional
Map3DElement.range را ببینید.
roll optional
نوع: number optional
Map3DElement.roll را ببینید.
tilt optional
نوع: number optional
Map3DElement.tilt را ببینید.

کلاس SteadyChangeEvent

google.maps.maps3d . SteadyChangeEvent کلاس google.maps.maps3d . SteadyChangeEvent

این رویداد از نظارت بر وضعیت ثابت Map3DElement ایجاد شده است. این رویداد از طریق درخت DOM حباب می شود.

این کلاس Event را گسترش می دهد.

با فراخوانی const {SteadyChangeEvent} = await google.maps.importLibrary("maps3d") دسترسی پیدا کنید.
کتابخانه ها را در Maps JavaScript API ببینید.

isSteady
نوع: boolean
نشان می دهد که آیا Map3DElement ثابت است (یعنی تمام رندرهای صحنه فعلی تکمیل شده است) یا خیر.

کلاس LocationClickEvent

google.maps.maps3d . LocationClickEvent کلاس google.maps.maps3d . LocationClickEvent

این رویداد با کلیک روی یک Map3DElement ایجاد می شود.

این کلاس Event را گسترش می دهد.

با فراخوانی const {LocationClickEvent} = await google.maps.importLibrary("maps3d") دسترسی پیدا کنید.
کتابخانه ها را در Maps JavaScript API ببینید.

position
نوع: LatLngAltitude optional
طول/طول جغرافیایی/ارتفاعی که هنگام وقوع رویداد زیر مکان نما قرار داشت. لطفاً توجه داشته باشید که در سطوح درشت تر، داده های دقیق کمتری برگردانده می شود. همچنین، هنگام کلیک کردن روی سطح آب از موقعیت‌های بالاتر دوربین، ارتفاع کف دریا ممکن است برای مقدار ارتفاع برگردانده شود. این رویداد از طریق درخت DOM حباب می شود.

کلاس PlaceClickEvent

google.maps.maps3d . PlaceClickEvent کلاس google.maps.maps3d . PlaceClickEvent

این رویداد از کلیک روی نماد مکان در Map3DElement ایجاد می‌شود. برای جلوگیری از نمایش popover پیش‌فرض، متد preventDefault() را در این رویداد فراخوانی کنید تا از مدیریت آن توسط Map3DElement جلوگیری شود.

این کلاس LocationClickEvent گسترش می دهد.

با فراخوانی const {PlaceClickEvent} = await google.maps.importLibrary("maps3d") دسترسی پیدا کنید.
کتابخانه ها را در Maps JavaScript API ببینید.

placeId
نوع: string
شناسه مکان ویژگی نقشه.
موروثی: position
fetchPlace
fetchPlace()
پارامترها: ندارد
مقدار بازگشتی: Promise < Place >
یک Place برای شناسه این مکان واکشی می کند. در شیء ایجاد شده Place ، ویژگی id پر خواهد شد. فیلدهای اضافی را می‌توان متعاقباً از طریق Place.fetchFields() با توجه به فعال‌سازی و صورت‌حساب عادی API Places درخواست کرد. اگر در واکشی Place خطایی وجود داشته باشد، قول رد می شود.

کلاس Marker3DElement

google.maps.maps3d . Marker3DElement کلاس google.maps.maps3d . Marker3DElement

موقعیتی را روی نقشه سه بعدی نشان می دهد. توجه داشته باشید که position باید برای نمایش Marker3DElement تنظیم شود.

عنصر سفارشی:
<gmp-marker-3d altitude-mode="absolute" collision-behavior="required" draws-when-occluded extruded label="string" position="lat,lng" size-preserved z-index="number"></gmp-marker-3d>

این کلاس HTMLElement را گسترش می دهد.

این کلاس Marker3DElementOptions پیاده سازی می کند.

با فراخوانی const {Marker3DElement} = await google.maps.importLibrary("maps3d") دسترسی پیدا کنید.
کتابخانه ها را در Maps JavaScript API ببینید.

Marker3DElement
Marker3DElement([options])
پارامترها:
یک Marker3DElement با گزینه های مشخص شده ایجاد می کند.
altitudeMode
نوع: AltitudeMode optional
پیش‌فرض: AltitudeMode.CLAMP_TO_GROUND
نحوه تفسیر جزء ارتفاعی موقعیت را مشخص می کند.
ویژگی HTML:
  • <gmp-marker-3d altitude-mode="absolute"></gmp-marker-3d>
  • <gmp-marker-3d altitude-mode="clamp-to-ground"></gmp-marker-3d>
  • <gmp-marker-3d altitude-mode="relative-to-ground"></gmp-marker-3d>
  • <gmp-marker-3d altitude-mode="relative-to-mesh"></gmp-marker-3d>
collisionBehavior
نوع: CollisionBehavior optional
پیش‌فرض: CollisionBehavior.REQUIRED
شمارشی که مشخص می‌کند وقتی یک Marker3DElement با Marker3DElement دیگر یا با برچسب‌های نقشه پایه برخورد می‌کند، چگونه رفتار کند.
ویژگی HTML:
  • <gmp-marker-3d collision-behavior="required"></gmp-marker-3d>
  • <gmp-marker-3d collision-behavior="required-and-hides-optional"></gmp-marker-3d>
  • <gmp-marker-3d collision-behavior="optional-and-hides-lower-priority"></gmp-marker-3d>
drawsWhenOccluded
نوع: boolean optional
پیش فرض: false
مشخص می کند که آیا این نشانگر باید در هنگام بسته شدن کشیده شود یا خیر. نشانگر را می توان با هندسه نقشه (به عنوان مثال ساختمان ها) مسدود کرد.
ویژگی HTML:
  • <gmp-marker-3d draws-when-occluded></gmp-marker-3d>
extruded
نوع: boolean optional
پیش فرض: false
مشخص می کند که آیا نشانگر به زمین متصل شود یا خیر. برای اکسترود کردن یک نشانگر، altitudeMode باید RELATIVE_TO_GROUND یا ABSOLUTE باشد.
ویژگی HTML:
  • <gmp-marker-3d extruded></gmp-marker-3d>
label
نوع: string optional
متنی که باید توسط این نشانگر نمایش داده شود.
ویژگی HTML:
  • <gmp-marker-3d label="string"></gmp-marker-3d>
position
محل نوک نشانگر. ارتفاع در حالت های خاص نادیده گرفته می شود و بنابراین اختیاری است.
ویژگی HTML:
  • <gmp-marker-3d position="lat,lng"></gmp-marker-3d>
  • <gmp-marker-3d position="lat,lng,altitude"></gmp-marker-3d>
sizePreserved
نوع: boolean optional
پیش فرض: false
مشخص می کند که آیا این نشانگر باید اندازه خود را بدون توجه به فاصله از دوربین حفظ کند یا خیر. به طور پیش‌فرض، نشانگر بر اساس فاصله از دوربین/شیب مقیاس‌بندی می‌شود.
ویژگی HTML:
  • <gmp-marker-3d size-preserved></gmp-marker-3d>
zIndex
نوع: number optional
zIndex در مقایسه با سایر نشانگرها.
ویژگی HTML:
  • <gmp-marker-3d z-index="number"></gmp-marker-3d>
default
هر عنصر سفارشی که مستقیماً به Marker3DElement اضافه شود شکاف داده می شود، با این حال فقط عناصر انواع HTMLImageElement ، SVGElement و PinElement برای ترسیم نشانگرها استفاده خواهند شد، سایر عناصر نادیده گرفته خواهند شد.
HTMLImageElement و SVGElement باید قبل از تخصیص به شکاف پیش فرض Marker3DElement در عنصر <template> پیچیده شوند.

تصاویر و SVG ها در حال حاضر قبل از رندر شدن در صحنه سه بعدی شطرنجی می شوند، بنابراین HTML سفارشی تعبیه شده در کلاس های SVG یا CSS اضافه شده به تصاویر اعمال نمی شود و ممکن است هنگام نمایش نشانگرها روی صفحه نمایش داده نشود.
addEventListener
addEventListener(type, listener[, options])
پارامترها:
  • type : string یک رشته حساس به حروف کوچک و بزرگ که نشان دهنده نوع رویداد برای گوش دادن است.
  • listener : EventListener | EventListenerObject شی ای که اعلان دریافت می کند. این باید یک تابع یا یک شی با متد handleEvent باشد
  • options : boolean| AddEventListenerOptions optional گزینه ها را ببینید. رویدادهای سفارشی فقط از capture و passive پشتیبانی می کنند.
مقدار برگشتی: void
تابعی را تنظیم می کند که هر زمان که رویداد مشخص شده به هدف تحویل داده شود فراخوانی می شود. به addEventListener مراجعه کنید.
removeEventListener
removeEventListener(type, listener[, options])
پارامترها:
  • type : string رشته ای که نوع رویدادی را که برای حذف شنونده رویداد مشخص می کند.
  • listener : EventListener | EventListenerObject شنونده رویداد کنترل کننده رویداد برای حذف از هدف رویداد.
  • options : boolean| EventListenerOptions optional گزینه ها را ببینید.
مقدار برگشتی: void
شنونده رویدادی که قبلاً با addEventListener ثبت شده بود را از هدف حذف می کند. removeEventListener را ببینید.

رابط Marker3DElementOptions

google.maps.maps3d . Marker3DElementOptions رابط google.maps.maps3d . Marker3DElementOptions

آبجکت Marker3DElementOptions برای تعریف ویژگی هایی که می توان روی Marker3DElement تنظیم کرد استفاده می شود.

altitudeMode optional
نوع: AltitudeMode optional
Marker3DElement.altitudeMode را ببینید.
collisionBehavior optional
نوع: CollisionBehavior optional
Marker3DElement.collisionBehavior را ببینید.
drawsWhenOccluded optional
نوع: boolean optional
Marker3DElement.drawsWhenOccluded را ببینید.
extruded optional
نوع: boolean optional
به Marker3DElement.extruded مراجعه کنید.
label optional
نوع: string optional
Marker3DElement.label را ببینید.
position optional
Marker3DElement.position را ببینید.
sizePreserved optional
نوع: boolean optional
Marker3DElement.sizePreserved را ببینید.
zIndex optional
نوع: number optional
Marker3DElement.zIndex را ببینید.

کلاس Marker3DIinteractiveElement

google.maps.maps3d . Marker3DInteractiveElement کلاس google.maps.maps3d . Marker3DInteractiveElement

موقعیتی را روی نقشه سه بعدی نشان می دهد. توجه داشته باشید که position باید برای نمایش Marker3DInteractiveElement تنظیم شود. برخلاف Marker3DElement ، Marker3DInteractiveElement یک رویداد gmp-click دریافت می‌کند.

عنصر سفارشی:
<gmp-marker-3d-interactive gmp-popover-target="popover-id" title="string"></gmp-marker-3d-interactive>

این کلاس Marker3DElement را گسترش می دهد.

این کلاس Marker3DInteractiveElementOptions پیاده سازی می کند.

با فراخوانی const {Marker3DInteractiveElement} = await google.maps.importLibrary("maps3d") دسترسی پیدا کنید.
کتابخانه ها را در Maps JavaScript API ببینید.

Marker3DInteractiveElement
Marker3DInteractiveElement([options])
پارامترها:
یک Marker3DInteractiveElement با گزینه های مشخص شده ایجاد می کند.
gmpPopoverTargetElement
نوع: PopoverElement optional
پس از تنظیم، عنصر popover با کلیک این نشانگر باز خواهد شد.
ویژگی HTML:
  • <gmp-marker-3d-interactive gmp-popover-target="popover-id"></gmp-marker-3d-interactive>
title
نوع: string
متن رول. در صورت ارائه، یک متن دسترس‌پذیری (مثلاً برای استفاده با صفحه‌خوان‌ها) با مقدار ارائه‌شده به Marker3DInteractiveElement اضافه می‌شود.
ویژگی HTML:
  • <gmp-marker-3d-interactive title="string"></gmp-marker-3d-interactive>
به ارث برده شده: altitudeMode ، collisionBehavior ، drawsWhenOccluded ، extruded ، label ، position ، sizePreserved ، zIndex
default
هر عنصر سفارشی که مستقیماً به Marker3DInteractiveElement اضافه شود شکاف داده می شود، اما فقط عناصر از نوع PinElement برای ترسیم نشانگرها استفاده می شود، سایر عناصر نادیده گرفته می شوند.
addEventListener
addEventListener(type, listener[, options])
پارامترها:
  • type : string یک رشته حساس به حروف کوچک و بزرگ که نشان دهنده نوع رویداد برای گوش دادن است.
  • listener : EventListener | EventListenerObject شی ای که اعلان دریافت می کند. این باید یک تابع یا یک شی با متد handleEvent باشد
  • options : boolean| AddEventListenerOptions optional گزینه ها را ببینید. رویدادهای سفارشی فقط از capture و passive پشتیبانی می کنند.
مقدار برگشتی: void
تابعی را تنظیم می کند که هر زمان که رویداد مشخص شده به هدف تحویل داده شود فراخوانی می شود. به addEventListener مراجعه کنید.
removeEventListener
removeEventListener(type, listener[, options])
پارامترها:
  • type : string رشته ای که نوع رویدادی را که برای حذف شنونده رویداد مشخص می کند.
  • listener : EventListener | EventListenerObject شنونده رویداد کنترل کننده رویداد برای حذف از هدف رویداد.
  • options : boolean| EventListenerOptions optional گزینه ها را ببینید.
مقدار برگشتی: void
شنونده رویدادی که قبلاً با addEventListener ثبت شده بود را از هدف حذف می کند. removeEventListener را ببینید.
gmp-click
function(clickEvent)
استدلال ها:
این رویداد زمانی فعال می شود که عنصر Marker3DInteractiveElement کلیک شود.

رابط Marker3DInteractiveElementOptions

google.maps.maps3d . Marker3DInteractiveElementOptions رابط google.maps.maps3d . Marker3DInteractiveElementOptions

آبجکت Marker3DInteractiveElementOptions برای تعریف ویژگی هایی که می توانند روی Marker3DInteractiveElement تنظیم شوند استفاده می شود.

این رابط Marker3DElementOptions گسترش می دهد.

gmpPopoverTargetElement optional
نوع: PopoverElement optional
Marker3DInteractiveElement.gmpPopoverTargetElement را ببینید.
title optional
نوع: string optional
Marker3DInteractiveElement.title را ببینید.
به ارث برده شده: altitudeMode ، collisionBehavior ، drawsWhenOccluded ، extruded ، label ، position ، sizePreserved ، zIndex

کلاس Model3DElement

google.maps.maps3d . Model3DElement کلاس google.maps.maps3d . Model3DElement

یک مدل سه بعدی که امکان ارائه مدل های gLTF را فراهم می کند. توجه داشته باشید که position و src باید برای نمایش Model3DElement تنظیم شود.

ویژگی های اصلی gLTF PBR باید پشتیبانی شوند. هیچ برنامه افزودنی یا ویژگی برنامه افزودنی در حال حاضر پشتیبانی نمی شود.

عنصر سفارشی:
<gmp-model-3d altitude-mode="absolute" orientation="heading,tilt,roll" position="lat,lng" scale="number" src="url"></gmp-model-3d>

این کلاس HTMLElement را گسترش می دهد.

این کلاس Model3DElementOptions را پیاده سازی می کند.

با فراخوانی const {Model3DElement} = await google.maps.importLibrary("maps3d") دسترسی پیدا کنید.
کتابخانه ها را در Maps JavaScript API ببینید.

Model3DElement
Model3DElement([options])
پارامترها:
یک Model3DElement با گزینه های مشخص شده ایجاد می کند.
altitudeMode
نوع: AltitudeMode optional
پیش‌فرض: AltitudeMode.CLAMP_TO_GROUND
نحوه تفسیر ارتفاع در موقعیت را مشخص می کند.
ویژگی HTML:
  • <gmp-model-3d altitude-mode="absolute"></gmp-model-3d>
  • <gmp-model-3d altitude-mode="clamp-to-ground"></gmp-model-3d>
  • <gmp-model-3d altitude-mode="relative-to-ground"></gmp-model-3d>
  • <gmp-model-3d altitude-mode="relative-to-mesh"></gmp-model-3d>
orientation
چرخش سیستم مختصات یک مدل سه بعدی را برای قرار دادن مدل بر روی نقشه سه بعدی توصیف می کند.

چرخش ها به ترتیب زیر روی مدل اعمال می شوند: رول، شیب و سپس سرفصل.
ویژگی HTML:
  • <gmp-model-3d orientation="heading,tilt,roll"></gmp-model-3d>
position
موقعیت Model3DElement را تنظیم می کند. ارتفاع در حالت های خاص نادیده گرفته می شود و بنابراین اختیاری است.
ویژگی HTML:
  • <gmp-model-3d position="lat,lng"></gmp-model-3d>
  • <gmp-model-3d position="lat,lng,altitude"></gmp-model-3d>
scale
نوع: number| Vector3D | Vector3DLiteral optional
پیش فرض: 1
مدل را در امتداد محورهای x، y و z در فضای مختصات مدل مقیاس می‌دهد.
ویژگی HTML:
  • <gmp-model-3d scale="number"></gmp-model-3d>
  • <gmp-model-3d scale="x,y,z"></gmp-model-3d>
src
نوع: string| URL optional
آدرس url مدل سه بعدی را مشخص می کند. در حال حاضر، فقط مدل‌هایی با فرمت .glb پشتیبانی می‌شوند.

هر URL نسبی HTTP به آدرس های مطلق مربوطه خود حل می شود.

لطفاً توجه داشته باشید که اگر فایل‌های مدل .glb خود را در وب‌سایت یا سروری متفاوت از برنامه اصلی خود میزبانی می‌کنید، مطمئن شوید که سرصفحه CORS HTTP صحیح را تنظیم کرده‌اید. این به برنامه شما اجازه می دهد تا به طور ایمن به فایل های مدل از دامنه دیگر دسترسی پیدا کند.
ویژگی HTML:
  • <gmp-model-3d src="url"></gmp-model-3d>
addEventListener
addEventListener(type, listener[, options])
پارامترها:
  • type : string یک رشته حساس به حروف کوچک و بزرگ که نشان دهنده نوع رویداد برای گوش دادن است.
  • listener : EventListener | EventListenerObject شی ای که اعلان دریافت می کند. این باید یک تابع یا یک شی با متد handleEvent باشد
  • options : boolean| AddEventListenerOptions optional گزینه ها را ببینید. رویدادهای سفارشی فقط از capture و passive پشتیبانی می کنند.
مقدار برگشتی: void
تابعی را تنظیم می کند که هر زمان که رویداد مشخص شده به هدف تحویل داده شود فراخوانی می شود. به addEventListener مراجعه کنید.
removeEventListener
removeEventListener(type, listener[, options])
پارامترها:
  • type : string رشته ای که نوع رویدادی را که برای حذف شنونده رویداد مشخص می کند.
  • listener : EventListener | EventListenerObject شنونده رویداد کنترل کننده رویداد برای حذف از هدف رویداد.
  • options : boolean| EventListenerOptions optional گزینه ها را ببینید.
مقدار برگشتی: void
شنونده رویدادی که قبلاً با addEventListener ثبت شده بود را از هدف حذف می کند. removeEventListener را ببینید.

رابط Model3DElementOptions

google.maps.maps3d . Model3DElementOptions رابط google.maps.maps3d . Model3DElementOptions

شی Model3DElementOptions برای تعریف ویژگی هایی که می توان روی یک Model3DElement تنظیم کرد استفاده می شود.

altitudeMode optional
نوع: AltitudeMode optional
Model3DElement.altitudeMode را ببینید.
orientation optional
Model3DElement.orientation را ببینید.
position optional
Model3DElement.position را ببینید.
scale optional
نوع: number| Vector3D | Vector3DLiteral optional
Model3DElement.scale را ببینید.
src optional
نوع: string| URL optional
Model3DElement.src را ببینید.

کلاس Model3DIinteractiveElement

google.maps.maps3d . Model3DInteractiveElement کلاس google.maps.maps3d . Model3DInteractiveElement

یک مدل سه بعدی که امکان ارائه مدل های gLTF را فراهم می کند. توجه داشته باشید که position و src باید برای نمایش Model3DElement تنظیم شود.

ویژگی های اصلی gLTF PBR باید پشتیبانی شوند. هیچ برنامه افزودنی یا ویژگی برنامه افزودنی در حال حاضر پشتیبانی نمی شود.

برخلاف Model3DElement ، Model3DInteractiveElement یک رویداد gmp-click دریافت می‌کند.

عنصر سفارشی:
<gmp-model-3d-interactive></gmp-model-3d-interactive>

این کلاس Model3DElement را گسترش می دهد.

این کلاس Model3DInteractiveElementOptions را پیاده سازی می کند.

با فراخوانی const {Model3DInteractiveElement} = await google.maps.importLibrary("maps3d") دسترسی پیدا کنید.
کتابخانه ها را در Maps JavaScript API ببینید.

Model3DInteractiveElement
Model3DInteractiveElement([options])
پارامترها:
یک Model3DInteractiveElement با گزینه های مشخص شده ایجاد می کند.
ارثی: altitudeMode ، orientation ، position ، scale ، src
addEventListener
addEventListener(type, listener[, options])
پارامترها:
  • type : string یک رشته حساس به حروف کوچک و بزرگ که نشان دهنده نوع رویداد برای گوش دادن است.
  • listener : EventListener | EventListenerObject شی ای که اعلان دریافت می کند. این باید یک تابع یا یک شی با متد handleEvent باشد
  • options : boolean| AddEventListenerOptions optional گزینه ها را ببینید. رویدادهای سفارشی فقط از capture و passive پشتیبانی می کنند.
مقدار برگشتی: void
تابعی را تنظیم می کند که هر زمان که رویداد مشخص شده به هدف تحویل داده شود فراخوانی می شود. به addEventListener مراجعه کنید.
removeEventListener
removeEventListener(type, listener[, options])
پارامترها:
  • type : string رشته ای که نوع رویدادی را که برای حذف شنونده رویداد مشخص می کند.
  • listener : EventListener | EventListenerObject شنونده رویداد کنترل کننده رویداد برای حذف از هدف رویداد.
  • options : boolean| EventListenerOptions optional گزینه ها را ببینید.
مقدار برگشتی: void
شنونده رویدادی که قبلاً با addEventListener ثبت شده بود را از هدف حذف می کند. removeEventListener را ببینید.
gmp-click
function(clickEvent)
استدلال ها:
این رویداد با کلیک روی عنصر Model3DInteractiveElement فعال می شود.

رابط Model3DInteractiveElementOptions

google.maps.maps3d . Model3DInteractiveElementOptions رابط google.maps.maps3d . Model3DInteractiveElementOptions

شی Model3DInteractiveElementOptions برای تعریف ویژگی هایی که می توان روی یک Model3DInteractiveElement تنظیم کرد استفاده می شود.

این رابط Model3DElementOptions را گسترش می دهد.

ارثی: altitudeMode ، orientation ، position ، scale ، src

کلاس Polyline3DElement

google.maps.maps3d . Polyline3DElement کلاس google.maps.maps3d . Polyline3DElement

چند خط سه بعدی یک همپوشانی خطی از بخش های خط متصل روی یک نقشه سه بعدی است.

عنصر سفارشی:
<gmp-polyline-3d altitude-mode="absolute" draws-occluded-segments extruded geodesic outer-color="string" outer-width="number" path="lat1,lng1,altitude1 lat2,lng2,altitude2 lat3,lng3,altitude3 ..." stroke-color="string" stroke-width="number" z-index="number"></gmp-polyline-3d>

این کلاس HTMLElement را گسترش می دهد.

این کلاس Polyline3DElementOptions پیاده سازی می کند.

با فراخوانی const {Polyline3DElement} = await google.maps.importLibrary("maps3d") دسترسی پیدا کنید.
کتابخانه ها را در Maps JavaScript API ببینید.

Polyline3DElement
Polyline3DElement([options])
پارامترها:
یک Polyline3DElement با گزینه های مشخص شده ایجاد می کند.
altitudeMode
نوع: AltitudeMode optional
پیش‌فرض: AltitudeMode.CLAMP_TO_GROUND
نحوه تفسیر اجزای ارتفاع در مختصات را مشخص می کند.
ویژگی HTML:
  • <gmp-polyline-3d altitude-mode="absolute"></gmp-polyline-3d>
  • <gmp-polyline-3d altitude-mode="clamp-to-ground"></gmp-polyline-3d>
  • <gmp-polyline-3d altitude-mode="relative-to-ground"></gmp-polyline-3d>
  • <gmp-polyline-3d altitude-mode="relative-to-mesh"></gmp-polyline-3d>
drawsOccludedSegments
نوع: boolean optional
پیش فرض: false
مشخص می کند که آیا قسمت هایی از چند خط که می توانند مسدود شوند کشیده شده اند یا خیر. چند خطوط را می توان با هندسه نقشه (به عنوان مثال ساختمان ها) مسدود کرد.
ویژگی HTML:
  • <gmp-polyline-3d draws-occluded-segments></gmp-polyline-3d>
extruded
نوع: boolean optional
پیش فرض: false
مشخص می کند که آیا پلی لاین به زمین متصل شود یا خیر. برای اکسترود کردن چند خط، altitudeMode باید RELATIVE_TO_GROUND یا ABSOLUTE باشد.
ویژگی HTML:
  • <gmp-polyline-3d extruded></gmp-polyline-3d>
geodesic
نوع: boolean optional
پیش فرض: false
وقتی true ، لبه‌های چندخط به عنوان ژئودزیک تفسیر می‌شوند و از انحنای زمین پیروی می‌کنند. هنگامی که false ، لبه های چند خط به صورت خطوط مستقیم در فضای صفحه نمایش داده می شوند.
ویژگی HTML:
  • <gmp-polyline-3d geodesic></gmp-polyline-3d>
outerColor
نوع: string optional
رنگ بیرونی. تمام رنگ های CSS3 پشتیبانی می شوند.
ویژگی HTML:
  • <gmp-polyline-3d outer-color="string"></gmp-polyline-3d>
outerWidth
نوع: number optional
عرض خارجی بین 0.0 و 1.0 است. این درصدی از strokeWidth است.
ویژگی HTML:
  • <gmp-polyline-3d outer-width="number"></gmp-polyline-3d>
path
دنباله منظم مختصات Polyline. ارتفاع در حالت های خاص نادیده گرفته می شود و بنابراین اختیاری است.
ویژگی HTML:
  • <gmp-polyline-3d path="lat1,lng1,altitude1 lat2,lng2,altitude2 lat3,lng3,altitude3 ..."></gmp-polyline-3d>
strokeColor
نوع: string optional
رنگ سکته مغزی. تمام رنگ های CSS3 پشتیبانی می شوند.
ویژگی HTML:
  • <gmp-polyline-3d stroke-color="string"></gmp-polyline-3d>
strokeWidth
نوع: number optional
عرض ضربه به پیکسل.
ویژگی HTML:
  • <gmp-polyline-3d stroke-width="number"></gmp-polyline-3d>
zIndex
نوع: number optional
zIndex در مقایسه با پلی های دیگر.
ویژگی HTML:
  • <gmp-polyline-3d z-index="number"></gmp-polyline-3d>
coordinates
دنباله منظم مختصات Polyline. ارتفاع در حالت های خاص نادیده گرفته می شود و بنابراین اختیاری است.
addEventListener
addEventListener(type, listener[, options])
پارامترها:
  • type : string یک رشته حساس به حروف کوچک و بزرگ که نشان دهنده نوع رویداد برای گوش دادن است.
  • listener : EventListener | EventListenerObject شی ای که اعلان دریافت می کند. این باید یک تابع یا یک شی با متد handleEvent باشد
  • options : boolean| AddEventListenerOptions optional گزینه ها را ببینید. رویدادهای سفارشی فقط از capture و passive پشتیبانی می کنند.
مقدار برگشتی: void
تابعی را تنظیم می کند که هر زمان که رویداد مشخص شده به هدف تحویل داده شود فراخوانی می شود. به addEventListener مراجعه کنید.
removeEventListener
removeEventListener(type, listener[, options])
پارامترها:
  • type : string رشته ای که نوع رویدادی را که برای حذف شنونده رویداد مشخص می کند.
  • listener : EventListener | EventListenerObject شنونده رویداد کنترل کننده رویداد برای حذف از هدف رویداد.
  • options : boolean| EventListenerOptions optional گزینه ها را ببینید.
مقدار برگشتی: void
شنونده رویدادی که قبلاً با addEventListener ثبت شده بود را از هدف حذف می کند. removeEventListener را ببینید.

رابط Polyline3DElementOptions

google.maps.maps3d . Polyline3DElementOptions رابط google.maps.maps3d . Polyline3DElementOptions

شی Polyline3DElementOptions برای تعریف ویژگی هایی که می توانند روی یک Polyline3DElement تنظیم شوند استفاده می شود.

altitudeMode optional
نوع: AltitudeMode optional
به Polyline3DElement.altitudeMode مراجعه کنید.
coordinates optional
Polyline3DElement.coordinates را ببینید.
drawsOccludedSegments optional
نوع: boolean optional
به Polyline3DElement.drawsOccludedSegments مراجعه کنید.
extruded optional
نوع: boolean optional
به Polyline3DElement.extruded مراجعه کنید.
geodesic optional
نوع: boolean optional
به Polyline3DElement.geodesic مراجعه کنید.
outerColor optional
نوع: string optional
به Polyline3DElement.outerColor مراجعه کنید.
outerWidth optional
نوع: number optional
به Polyline3DElement.outerWidth مراجعه کنید.
strokeColor optional
نوع: string optional
به Polyline3DElement.strokeColor مراجعه کنید.
strokeWidth optional
نوع: number optional
به Polyline3DElement.strokeWidth مراجعه کنید.
zIndex optional
نوع: number optional
به Polyline3DElement.zIndex مراجعه کنید.

کلاس Polyline3DIinteractiveElement

google.maps.maps3d . Polyline3DInteractiveElement کلاس google.maps.maps3d . Polyline3DInteractiveElement

چند خط سه بعدی یک همپوشانی خطی از بخش های خط متصل روی یک نقشه سه بعدی است. برخلاف Polyline3DElement ، Polyline3DInteractiveElement یک رویداد gmp-click دریافت می کند.

عنصر سفارشی:
<gmp-polyline-3d-interactive></gmp-polyline-3d-interactive>

این کلاس Polyline3DElement را گسترش می دهد.

این کلاس Polyline3DInteractiveElementOptions پیاده سازی می کند.

با فراخوانی const {Polyline3DInteractiveElement} = await google.maps.importLibrary("maps3d") دسترسی پیدا کنید.
کتابخانه ها را در Maps JavaScript API ببینید.

Polyline3DInteractiveElement
Polyline3DInteractiveElement([options])
پارامترها:
یک Polyline3DInteractiveElement با گزینه های مشخص شده ایجاد می کند.
به ارث برده شده: altitudeMode ، drawsOccludedSegments ، extruded ، geodesic ، outerColor ، outerWidth ، path ، strokeColor ، strokeWidth ، zIndex ، coordinates
addEventListener
addEventListener(type, listener[, options])
پارامترها:
  • type : string یک رشته حساس به حروف کوچک و بزرگ که نشان دهنده نوع رویداد برای گوش دادن است.
  • listener : EventListener | EventListenerObject شی ای که اعلان دریافت می کند. این باید یک تابع یا یک شی با متد handleEvent باشد
  • options : boolean| AddEventListenerOptions optional گزینه ها را ببینید. رویدادهای سفارشی فقط از capture و passive پشتیبانی می کنند.
مقدار برگشتی: void
تابعی را تنظیم می کند که هر زمان که رویداد مشخص شده به هدف تحویل داده شود فراخوانی می شود. به addEventListener مراجعه کنید.
removeEventListener
removeEventListener(type, listener[, options])
پارامترها:
  • type : string رشته ای که نوع رویدادی را که برای حذف شنونده رویداد مشخص می کند.
  • listener : EventListener | EventListenerObject شنونده رویداد کنترل کننده رویداد برای حذف از هدف رویداد.
  • options : boolean| EventListenerOptions optional گزینه ها را ببینید.
مقدار برگشتی: void
شنونده رویدادی که قبلاً با addEventListener ثبت شده بود را از هدف حذف می کند. removeEventListener را ببینید.
gmp-click
function(clickEvent)
استدلال ها:
  • clickEvent : LocationClickEvent شی رویداد حاوی مکان lat-lng-ارتفاع کلیک خواهد بود.
این رویداد با کلیک روی عنصر Polyline3DInteractiveElement فعال می شود.

رابط Polyline3DInteractiveElementOptions

google.maps.maps3d . Polyline3DInteractiveElementOptions رابط google.maps.maps3d . Polyline3DInteractiveElementOptions

شی Polyline3DInteractiveElementOptions برای تعریف ویژگی هایی که می توانند روی یک Polyline3DInteractiveElement تنظیم شوند استفاده می شود.

این رابط Polyline3DElementOptions را گسترش می دهد.

به ارث برده شده: altitudeMode ، coordinates ، drawsOccludedSegments ، extruded ، geodesic ، outerColor ، outerWidth ، strokeColor ، strokeWidth ، zIndex

کلاس Polygon3DElement

google.maps.maps3d . Polygon3DElement کلاس google.maps.maps3d . Polygon3DElement

یک چند ضلعی سه بعدی (مانند چند خط سه بعدی) مجموعه ای از مختصات متصل را در یک دنباله مرتب تعریف می کند. علاوه بر این، چند ضلعی ها یک حلقه بسته را تشکیل می دهند و یک منطقه پر شده را تعریف می کنند.

عنصر سفارشی:
<gmp-polygon-3d altitude-mode="absolute" draws-occluded-segments extruded fill-color="string" geodesic path="lat1,lng1,altitude1 lat2,lng2,altitude2 lat3,lng3,altitude3 ..." stroke-color="string" stroke-width="number" z-index="number"></gmp-polygon-3d>

این کلاس HTMLElement را گسترش می دهد.

این کلاس Polygon3DElementOptions را پیاده سازی می کند.

با فراخوانی const {Polygon3DElement} = await google.maps.importLibrary("maps3d") دسترسی پیدا کنید.
کتابخانه ها را در Maps JavaScript API ببینید.

Polygon3DElement
Polygon3DElement([options])
پارامترها:
یک Polygon3DElement با گزینه های مشخص شده ایجاد می کند.
altitudeMode
نوع: AltitudeMode optional
پیش‌فرض: AltitudeMode.CLAMP_TO_GROUND
نحوه تفسیر اجزای ارتفاع در مختصات را مشخص می کند.
ویژگی HTML:
  • <gmp-polygon-3d altitude-mode="absolute"></gmp-polygon-3d>
  • <gmp-polygon-3d altitude-mode="clamp-to-ground"></gmp-polygon-3d>
  • <gmp-polygon-3d altitude-mode="relative-to-ground"></gmp-polygon-3d>
  • <gmp-polygon-3d altitude-mode="relative-to-mesh"></gmp-polygon-3d>
drawsOccludedSegments
نوع: boolean optional
پیش فرض: false
مشخص می کند که آیا بخش هایی از چند ضلعی که می توانند مسدود شوند ، ترسیم شده اند یا خیر. چند ضلعی ها را می توان با هندسه نقشه مسدود کرد (به عنوان مثال ساختمانها).
ویژگی HTML:
  • <gmp-polygon-3d draws-occluded-segments></gmp-polygon-3d>
extruded
نوع: boolean optional
پیش فرض: false
مشخص می کند که آیا چند ضلعی را به زمین وصل کنید. برای استخراج چند ضلعی ، altitudeMode باید یا RELATIVE_TO_GROUND یا ABSOLUTE باشد.
ویژگی HTML:
  • <gmp-polygon-3d extruded></gmp-polygon-3d>
fillColor
نوع: string optional
رنگ پر تمام رنگهای CSS3 پشتیبانی می شوند.
ویژگی HTML:
  • <gmp-polygon-3d fill-color="string"></gmp-polygon-3d>
geodesic
نوع: boolean optional
پیش فرض: false
هنگامی که true ، لبه های چند ضلعی به عنوان ژئودزیک تعبیر می شود و از انحنای زمین پیروی می کند. هنگامی که false ، لبه های چند ضلعی به عنوان خطوط مستقیم در فضای صفحه نمایش داده می شوند.
ویژگی HTML:
  • <gmp-polygon-3d geodesic></gmp-polygon-3d>
innerPaths
توالی سفارش داده شده از مختصات که یک حلقه بسته را تعیین می کند. بر خلاف پولیلین ها ، یک چند ضلعی ممکن است از یک یا چند مسیر تشکیل شود که چندین برش را در داخل چند ضلعی ایجاد می کند.
path
توالی سفارش داده شده از مختصات که یک حلقه بسته را تعیین می کند. ارتفاع در حالت های خاص نادیده گرفته می شود و در نتیجه اختیاری است.
ویژگی HTML:
  • <gmp-polygon-3d path="lat1,lng1,altitude1 lat2,lng2,altitude2 lat3,lng3,altitude3 ..."></gmp-polygon-3d>
strokeColor
نوع: string optional
رنگ سکته مغزی. تمام رنگهای CSS3 پشتیبانی می شوند.
ویژگی HTML:
  • <gmp-polygon-3d stroke-color="string"></gmp-polygon-3d>
strokeWidth
نوع: number optional
عرض سکته مغزی در پیکسل ها.
ویژگی HTML:
  • <gmp-polygon-3d stroke-width="number"></gmp-polygon-3d>
zIndex
نوع: number optional
Zindex در مقایسه با سایر پلی ها.
ویژگی HTML:
  • <gmp-polygon-3d z-index="number"></gmp-polygon-3d>
outerCoordinates
توالی سفارش داده شده از مختصات که یک حلقه بسته را تعیین می کند. ارتفاع در حالت های خاص نادیده گرفته می شود و در نتیجه اختیاری است.
innerCoordinates
توالی سفارش داده شده از مختصات که یک حلقه بسته را تعیین می کند. بر خلاف پولیلین ها ، یک چند ضلعی ممکن است از یک یا چند مسیر تشکیل شود که چندین برش را در داخل چند ضلعی ایجاد می کند.
addEventListener
addEventListener(type, listener[, options])
پارامترها:
  • type : string یک رشته حساس به مورد که نشان دهنده نوع رویداد برای گوش دادن است.
  • listener : EventListener | EventListenerObject شیء که یک اعلان دریافت می کند. این باید یک عملکرد یا یک شی با روش HandleEvent باشد
  • options : boolean| AddEventListenerOptions optional گزینه ها را مشاهده کنید. رویدادهای سفارشی فقط از capture و passive پشتیبانی می کنند.
مقدار برگشتی: void
عملکردی را تنظیم می کند که هر زمان که رویداد مشخص شده به هدف تحویل داده شود ، فراخوانی می شود. به addeventlistener مراجعه کنید.
removeEventListener
removeEventListener(type, listener[, options])
پارامترها:
  • type : رشته ای string که نوع رویدادی را برای حذف شنونده رویداد مشخص می کند.
  • listener : EventListener | EventListenerObject شنونده رویداد کنترل کننده رویداد برای حذف از هدف رویداد.
  • options : boolean| EventListenerOptions optional گزینه ها را مشاهده کنید.
مقدار برگشتی: void
شنونده رویداد را که قبلاً با AddEventListener از هدف ثبت شده بود حذف می کند. به remedeventlistener مراجعه کنید.

رابط چند ضلعی

google.maps.maps3d . Polygon3DElementOptions رابط google.maps.maps3d . Polygon3DElementOptions

Polygon3delementOptions شیء مورد استفاده برای تعریف خواصی که می تواند در یک چند ضلعی تنظیم شود.

altitudeMode optional
نوع: AltitudeMode optional
به Polygon3DElement.altitudeMode مراجعه کنید.
drawsOccludedSegments optional
نوع: boolean optional
به Polygon3DElement.drawsOccludedSegments مراجعه کنید.
extruded optional
نوع: boolean optional
به Polygon3DElement.extruded مراجعه کنید.
fillColor optional
نوع: string optional
به Polygon3DElement.fillColor مراجعه کنید.
geodesic optional
نوع: boolean optional
به Polygon3DElement.geodesic مراجعه کنید.
innerCoordinates optional
به Polygon3DElement.innerCoordinates مراجعه کنید.
outerCoordinates optional
به Polygon3DElement.outerCoordinates مراجعه کنید.
strokeColor optional
نوع: string optional
به Polygon3DElement.strokeColor مراجعه کنید.
strokeWidth optional
نوع: number optional
به Polygon3DElement.strokeWidth مراجعه کنید.
zIndex optional
نوع: number optional
به Polygon3DElement.zIndex مراجعه کنید.

کلاس چند ضلعی

google.maps.maps3d . Polygon3DInteractiveElement کلاس google.maps.maps3d . Polygon3DInteractiveElement

چند ضلعی سه بعدی (مانند یک پلی خط سه بعدی) یک سری مختصات متصل را در یک دنباله سفارش داده شده تعریف می کند. علاوه بر این ، چند ضلعی ها یک حلقه بسته را تشکیل می دهند و یک منطقه پر شده را تعریف می کنند. بر خلاف Polygon3DElement ، Polygon3DInteractiveElement یک رویداد gmp-click دریافت می کند.

عنصر سفارشی:
<gmp-polygon-3d-interactive></gmp-polygon-3d-interactive>

این کلاس Polygon3DElement را گسترش می دهد.

این کلاس Polygon3DInteractiveElementOptions پیاده سازی می کند.

دسترسی با فراخوانی const {Polygon3DInteractiveElement} = await google.maps.importLibrary("maps3d") .
به کتابخانه ها در نقشه های JavaScript API مراجعه کنید.

Polygon3DInteractiveElement
Polygon3DInteractiveElement([options])
پارامترها:
با گزینه های مشخص شده ، یک Polygon3DInteractiveElement ایجاد می کند.
ارثی: altitudeMode ، drawsOccludedSegments ، extruded ، fillColor ، geodesic ، innerPaths ، path ، strokeColor ، strokeWidth ، zIndex ، outerCoordinates ، innerCoordinates
addEventListener
addEventListener(type, listener[, options])
پارامترها:
  • type : string یک رشته حساس به مورد که نشان دهنده نوع رویداد برای گوش دادن است.
  • listener : EventListener | EventListenerObject شیء که یک اعلان دریافت می کند. این باید یک عملکرد یا یک شی با روش HandleEvent باشد
  • options : boolean| AddEventListenerOptions optional گزینه ها را مشاهده کنید. رویدادهای سفارشی فقط از capture و passive پشتیبانی می کنند.
مقدار برگشتی: void
عملکردی را تنظیم می کند که هر زمان که رویداد مشخص شده به هدف تحویل داده شود ، فراخوانی می شود. به addeventlistener مراجعه کنید.
removeEventListener
removeEventListener(type, listener[, options])
پارامترها:
  • type : رشته ای string که نوع رویدادی را برای حذف شنونده رویداد مشخص می کند.
  • listener : EventListener | EventListenerObject شنونده رویداد کنترل کننده رویداد برای حذف از هدف رویداد.
  • options : boolean| EventListenerOptions optional گزینه ها را مشاهده کنید.
مقدار برگشتی: void
شنونده رویداد را که قبلاً با AddEventListener از هدف ثبت شده بود حذف می کند. به remedeventlistener مراجعه کنید.
gmp-click
function(clickEvent)
استدلال ها:
  • clickEvent : LocationClickEvent شیء رویداد شامل محل سکونت LAT-LNG-Altite of Click خواهد بود.
این رویداد با کلیک بر روی عنصر Polygon3DInteractiveElement شلیک می شود.

رابط چند ضلعی

google.maps.maps3d . Polygon3DInteractiveElementOptions رابط google.maps.maps3d . Polygon3DInteractiveElementOptions

Polygon3DinteractionElementOptions شیء مورد استفاده برای تعریف خواصی که می تواند در یک polygon3dinteractionelement تنظیم شود.

این رابط Polygon3DElementOptions را گسترش می دهد.

ارثی: altitudeMode ، drawsOccludedSegments ، extruded ، fillColor ، geodesic ، innerCoordinates ، outerCoordinates ، strokeColor ، strokeWidth ، zIndex

کلاس پاپورلیم

google.maps.maps3d . PopoverElement کلاس google.maps.maps3d . PopoverElement

یک عنصر HTML سفارشی که یک پوپور را ارائه می دهد. به نظر می رسد حباب است و اغلب به یک نشانگر متصل است.

عنصر سفارشی:
<gmp-popover altitude-mode="absolute" light-dismiss-disabled open position-anchor="lat,lng"></gmp-popover>

این کلاس HTMLElement را گسترش می دهد.

این کلاس PopoverElementOptions را پیاده سازی می کند.

دسترسی با فراخوانی const {PopoverElement} = await google.maps.importLibrary("maps3d") .
به کتابخانه ها در نقشه های JavaScript API مراجعه کنید.

PopoverElement
PopoverElement([options])
پارامترها:
altitudeMode
نوع: AltitudeMode optional
پیش فرض: AltitudeMode.CLAMP_TO_GROUND
چگونگی تفسیر مؤلفه ارتفاع موقعیت را مشخص می کند.
ویژگی HTML:
  • <gmp-popover altitude-mode="absolute"></gmp-popover>
  • <gmp-popover altitude-mode="clamp-to-ground"></gmp-popover>
  • <gmp-popover altitude-mode="relative-to-ground"></gmp-popover>
  • <gmp-popover altitude-mode="relative-to-mesh"></gmp-popover>
lightDismissDisabled
نوع: boolean optional
پیش فرض: false
مشخص می کند که آیا این پوپور باید "نور برکنار شده" باشد یا خیر. رفتار "Light Dismiss" شبیه به تنظیم ویژگی popover="auto" است که بخشی از API POPOVER مرورگر است.
ویژگی HTML:
  • <gmp-popover light-dismiss-disabled></gmp-popover>
open
نوع: boolean optional
پیش فرض: false
مشخص می کند که آیا این پوپور باید باز باشد یا خیر.
ویژگی HTML:
  • <gmp-popover open></gmp-popover>
positionAnchor
موقعیتی که در آن می توانید این پوپور را نمایش دهید. اگر پوپور به یک نشانگر تعاملی لنگر زده شود ، به جای آن از موقعیت نشانگر استفاده می شود.
ویژگی HTML:
  • <gmp-popover position-anchor="lat,lng"></gmp-popover>
  • <gmp-popover position-anchor="lat,lng,altitude"></gmp-popover>
  • <gmp-popover position-anchor="marker-id"></gmp-popover>
default
محتوای شکاف دار را در بخش اصلی پوپور قرار می دهد.
header
محتوای شکاف دار را در بخش عنوان پوپور قرار می دهد.
--gmp-popover-max-width
حداکثر عرض پوپور ، صرف نظر از عرض محتوا.
--gmp-popover-min-width
حداقل عرض پوپور ، صرف نظر از عرض محتوا. هنگام استفاده از این ویژگی ، به شدت توصیه می شود که آن را به مقدار کمتر از عرض نقشه (در پیکسل) تنظیم کنید.
--gmp-popover-pixel-offset-x
جبران روی محور x ، در پیکسل ها ، نوک پوپور از نقطه روی نقشه که در آن مختصات جغرافیایی پوپور است.
--gmp-popover-pixel-offset-y
جبران روی محور y ، در پیکسل ها ، نوک پوپور از نقطه روی نقشه که در آن مختصات جغرافیایی پوپور است.
color-scheme
نشان می دهد که این طرح رنگی این پاپور را می توان در آن ارائه داد. برای اطلاعات بیشتر به اسناد و مدارک color-scheme مراجعه کنید. اگر مشخص نشده باشد ، به ترجیحات طرح رنگی کاربر پیش فرض می شود.
addEventListener
addEventListener(type, listener[, options])
پارامترها:
  • type : string یک رشته حساس به مورد که نشان دهنده نوع رویداد برای گوش دادن است.
  • listener : EventListener | EventListenerObject شیء که یک اعلان دریافت می کند. این باید یک عملکرد یا یک شی با روش HandleEvent باشد
  • options : boolean| AddEventListenerOptions optional گزینه ها را مشاهده کنید. رویدادهای سفارشی فقط از capture و passive پشتیبانی می کنند.
مقدار برگشتی: void
عملکردی را تنظیم می کند که هر زمان که رویداد مشخص شده به هدف تحویل داده شود ، فراخوانی می شود. به addeventlistener مراجعه کنید.
removeEventListener
removeEventListener(type, listener[, options])
پارامترها:
  • type : رشته ای string که نوع رویدادی را برای حذف شنونده رویداد مشخص می کند.
  • listener : EventListener | EventListenerObject شنونده رویداد کنترل کننده رویداد برای حذف از هدف رویداد.
  • options : boolean| EventListenerOptions optional گزینه ها را مشاهده کنید.
مقدار برگشتی: void
شنونده رویداد را که قبلاً با AddEventListener از هدف ثبت شده بود حذف می کند. به remedeventlistener مراجعه کنید.

رابط PopverElementOptions

google.maps.maps3d . PopoverElementOptions رابط google.maps.maps3d . PopoverElementOptions

شیء PopoverElementOptions مورد استفاده برای تعریف خواصی که می تواند روی یک پاپورلنت تنظیم شود.

altitudeMode optional
نوع: AltitudeMode optional
به PopoverElement.altitudeMode مراجعه کنید.
lightDismissDisabled optional
نوع: boolean optional
به PopoverElement.lightDismissDisabled مراجعه کنید.
open optional
نوع: boolean optional
به PopoverElement.open مراجعه کنید.
positionAnchor optional
به PopoverElement.positionAnchor مراجعه کنید.

ثابت های ارتفاعات

google.maps.maps3d . AltitudeMode ثابت های google.maps.maps3d . AltitudeMode

چگونگی تفسیر مؤلفه های ارتفاع در مختصات را مشخص می کند.

دسترسی با فراخوانی const {AltitudeMode} = await google.maps.importLibrary("maps3d") .
به کتابخانه ها در نقشه های JavaScript API مراجعه کنید.

ABSOLUTE اجازه می دهد تا اشیاء نسبت به میانگین متوسط ​​سطح دریا را بیان کنید. این همچنین بدان معنی است که اگر سطح زمین جزئیات زیر شیء تغییر کند ، موقعیت مطلق آن یکسان خواهد بود.
CLAMP_TO_GROUND اجازه می دهد تا اشیاء قرار داده شده در زمین را بیان کنید. آنها بدون توجه به اینکه ارتفاع فراهم شده است ، در سطح زمین به دنبال زمین باقی می مانند. اگر جسم روی یک بدن اصلی آب قرار بگیرد ، در سطح دریا قرار می گیرد.
RELATIVE_TO_GROUND اجازه می دهد تا اشیاء را نسبت به سطح زمین بیان کنید. اگر سطح زمین جزئیات تغییر کند ، موقعیت جسم نسبت به زمین ثابت خواهد ماند. هنگامی که بیش از آب باشد ، ارتفاع به عنوان یک ارزش در متر بالاتر از سطح دریا تفسیر می شود.
RELATIVE_TO_MESH اجازه می دهد تا اشیاء را نسبت به بالاترین سطح زمین+ساختمان+سطح آب بیان کنید. هنگامی که بیش از آب ، این سطح آب خواهد بود. هنگامی که بیش از زمین باشد ، این سطح ساختمان (در صورت وجود) یا سطح زمین (در صورت عدم ساختمان) خواهد بود.