3D Maps

کلاس Map3DElement

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

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

عنصر سفارشی:
<gmp-map-3d center="lat,lng,altitude" default-labels-disabled default-ui-disabled heading="number" max-altitude="number" max-heading="number" max-tilt="number" min-altitude="number" min-heading="number" min-tilt="number" 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>
defaultLabelsDisabled
نوع: boolean optional
پیش فرض: false
وقتی true ، برچسب‌های پیش‌فرض نقشه ارائه نمی‌شوند.
ویژگی HTML:
  • <gmp-map-3d default-labels-disabled></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>
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>
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>
Beta 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)
پارامترها:
ارزش بازگشتی: ندارد
این روش دوربین را به صورت سهموی از مکان فعلی به یک مکان انتهایی معین در مدت زمان معین حرکت می دهد.

این روش ناهمزمان است زیرا انیمیشن‌ها تنها پس از بارگیری نقشه حداقل می‌توانند شروع شوند. این روش پس از شروع انیمیشن باز می گردد.
Beta 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-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 ببینید.
defaultLabelsDisabled optional
نوع: boolean optional
defaultUIDisabled optional
نوع: boolean optional
heading optional
نوع: number optional
Map3DElement.heading ببینید.
maxAltitude optional
نوع: number optional
maxHeading optional
نوع: number optional
maxTilt optional
نوع: number optional
Map3DElement.maxTilt ببینید.
minAltitude optional
نوع: number optional
minHeading optional
نوع: number optional
minTilt optional
نوع: number optional
Map3DElement.minTilt ببینید.
range optional
نوع: number optional
Map3DElement.range ببینید.
roll optional
نوع: number optional
Map3DElement.roll ببینید.
tilt optional
نوع: number optional
Map3DElement.tilt ببینید.

رابط 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 ایجاد می شود.

این کلاس 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" 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
نحوه تفسیر جزء ارتفاعی موقعیت را مشخص می کند.
ویژگی 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 . 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
محل نوک نشانگر. ارتفاع در حالت های خاص نادیده گرفته می شود و بنابراین اختیاری است.
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 اضافه شده به تصاویر اعمال نمی شود و ممکن است هنگام نمایش نشانگرها روی صفحه نمایش داده نشود.
Beta addEventListener
addEventListener(type, listener[, options])
پارامترها:
  • type : string یک رشته حساس به حروف کوچک و بزرگ که نشان دهنده نوع رویداد برای گوش دادن است.
  • listener : EventListener | EventListenerObject شی ای که اعلان دریافت می کند. این باید یک تابع یا یک شی با متد handleEvent باشد
  • options : boolean| AddEventListenerOptions optional گزینه ها را ببینید. رویدادهای سفارشی فقط capture و passive پشتیبانی می کنند.
مقدار برگشتی: void
تابعی را تنظیم می کند که هر زمان که رویداد مشخص شده به هدف تحویل داده شود فراخوانی می شود. به addEventListener مراجعه کنید
Beta 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
collisionBehavior optional
نوع: CollisionBehavior optional
drawsWhenOccluded optional
نوع: boolean optional
extruded optional
نوع: boolean optional
به Marker3DElement.extruded مراجعه کنید.
label optional
نوع: string optional
Marker3DElement.label ببینید.
position optional
sizePreserved optional
نوع: boolean optional
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-marker-3d-interactive>

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

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

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

Marker3DInteractiveElement
Marker3DInteractiveElement([options])
پارامترها:
یک Marker3DInteractiveElement با گزینه های مشخص شده ایجاد می کند.
به ارث برده شده: 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 را گسترش می دهد.

به ارث برده شده: 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" src="src"></gmp-model-3d>

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

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

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

Model3DElement
Model3DElement([options])
پارامترها:
یک Model3DElement با گزینه های مشخص شده ایجاد می کند.
altitudeMode
نوع: AltitudeMode optional
نحوه تفسیر ارتفاع در موقعیت را مشخص می کند.
ویژگی 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
چرخش سیستم مختصات یک مدل سه بعدی را برای قرار دادن مدل بر روی نقشه سه بعدی توصیف می کند.

چرخش ها به ترتیب زیر روی مدل اعمال می شوند: رول، شیب و سپس سرفصل.
position
موقعیت Model3DElement را تنظیم می کند. ارتفاع در حالت های خاص نادیده گرفته می شود و بنابراین اختیاری است.
scale
نوع: number| Vector3D | Vector3DLiteral optional
پیش فرض: 1
مدل را در امتداد محورهای x، y و z در فضای مختصات مدل مقیاس می‌دهد.
src
نوع: string| URL optional
آدرس url مدل سه بعدی را مشخص می کند. در حال حاضر، فقط مدل‌هایی با فرمت .glb پشتیبانی می‌شوند.

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

لطفاً توجه داشته باشید که اگر فایل‌های مدل .glb خود را در وب‌سایت یا سروری متفاوت از برنامه اصلی خود میزبانی می‌کنید، مطمئن شوید که سرصفحه CORS HTTP صحیح را تنظیم کرده‌اید. این به برنامه شما اجازه می دهد تا به طور ایمن به فایل های مدل از دامنه دیگر دسترسی پیدا کند.
ویژگی HTML:
  • <gmp-model-3d src="src"></gmp-model-3d>
Beta addEventListener
addEventListener(type, listener[, options])
پارامترها:
  • type : string یک رشته حساس به حروف کوچک و بزرگ که نشان دهنده نوع رویداد برای گوش دادن است.
  • listener : EventListener | EventListenerObject شی ای که اعلان دریافت می کند. این باید یک تابع یا یک شی با متد handleEvent باشد
  • options : boolean| AddEventListenerOptions optional گزینه ها را ببینید. رویدادهای سفارشی فقط capture و passive پشتیبانی می کنند.
مقدار برگشتی: void
تابعی را تنظیم می کند که هر زمان که رویداد مشخص شده به هدف تحویل داده شود فراخوانی می شود. به addEventListener مراجعه کنید
Beta 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
orientation optional
position optional
scale optional
نوع: number| Vector3D | Vector3DLiteral optional
Model3DElement.scale ببینید.
src optional
نوع: string| URL optional
Model3DElement.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" 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.ABSOLUTE
نحوه تفسیر اجزای ارتفاع در مختصات را مشخص می کند.
ویژگی 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>
coordinates
دنباله منظم مختصات Polyline. ارتفاع در حالت های خاص نادیده گرفته می شود و بنابراین اختیاری است.
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>
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>
Beta addEventListener
addEventListener(type, listener[, options])
پارامترها:
  • type : string یک رشته حساس به حروف کوچک و بزرگ که نشان دهنده نوع رویداد برای گوش دادن است.
  • listener : EventListener | EventListenerObject شی ای که اعلان دریافت می کند. این باید یک تابع یا یک شی با متد handleEvent باشد
  • options : boolean| AddEventListenerOptions optional گزینه ها را ببینید. رویدادهای سفارشی فقط capture و passive پشتیبانی می کنند.
مقدار برگشتی: void
تابعی را تنظیم می کند که هر زمان که رویداد مشخص شده به هدف تحویل داده شود فراخوانی می شود. به addEventListener مراجعه کنید
Beta 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
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 مراجعه کنید.

کلاس Polygon3DElement

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

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

عنصر سفارشی:
<gmp-polygon-3d altitude-mode="absolute" draws-occluded-segments extruded fill-color="string" geodesic 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.ABSOLUTE
نحوه تفسیر اجزای ارتفاع در مختصات را مشخص می کند.
ویژگی 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>
innerCoordinates
دنباله منظم مختصات که یک حلقه بسته را مشخص می کند. برخلاف چند خط، یک چند ضلعی ممکن است از یک یا چند مسیر تشکیل شده باشد که چندین برش در داخل چند ضلعی ایجاد می کند.
outerCoordinates
دنباله منظم مختصات که یک حلقه بسته را مشخص می کند. ارتفاع در حالت های خاص نادیده گرفته می شود و بنابراین اختیاری است.
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>
Beta addEventListener
addEventListener(type, listener[, options])
پارامترها:
  • type : string یک رشته حساس به حروف کوچک و بزرگ که نشان دهنده نوع رویداد برای گوش دادن است.
  • listener : EventListener | EventListenerObject شی ای که اعلان دریافت می کند. این باید یک تابع یا یک شی با متد handleEvent باشد
  • options : boolean| AddEventListenerOptions optional گزینه ها را ببینید. رویدادهای سفارشی فقط capture و passive پشتیبانی می کنند.
مقدار برگشتی: void
تابعی را تنظیم می کند که هر زمان که رویداد مشخص شده به هدف تحویل داده شود فراخوانی می شود. به addEventListener مراجعه کنید
Beta removeEventListener
removeEventListener(type, listener[, options])
پارامترها:
  • type : string رشته ای که نوع رویدادی را که برای حذف شنونده رویداد مشخص می کند.
  • listener : EventListener | EventListenerObject شنونده رویداد کنترل کننده رویداد برای حذف از هدف رویداد.
  • options : boolean| EventListenerOptions optional گزینه ها را ببینید
مقدار برگشتی: void
شنونده رویدادی که قبلاً با addEventListener ثبت شده بود را از هدف حذف می کند. removeEventListener را ببینید

رابط Polygon3DElementOptions

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

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

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
outerCoordinates optional
به Polygon3DElement.outerCoordinates مراجعه کنید.
strokeColor optional
نوع: string optional
به Polygon3DElement.strokeColor مراجعه کنید.
strokeWidth optional
نوع: number optional
به Polygon3DElement.strokeWidth مراجعه کنید.
zIndex optional
نوع: number optional
به Polygon3DElement.zIndex مراجعه کنید.

ثابت های AltitudeMode

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

نحوه تفسیر اجزای ارتفاع در مختصات را مشخص می کند.

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

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