کلاس Map3DElement
google.maps.maps3d.Map3DElement
کلاس
Map3DElement یک میانای HTML برای نمای «نقشه سهبعدی» است. توجه داشته باشید که mode باید تنظیم شود تا «نقشه سهبعدی» شروع به پرداز کردن کند.
عنصر سفارشی:
<gmp-map-3d center="lat,lng,altitude" default-ui-hidden description="string" gesture-handling="auto" heading="number" internal-usage-attribution-ids="id1 id2" map-id="string" 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" default-ui-disabled></gmp-map-3d>
این کلاس
HTMLElement را گسترش میدهد.
این کلاس
Map3DElementOptions را پیادهسازی میکند.
با تماس با const {Map3DElement} = await google.maps.importLibrary("maps3d") دسترسی پیدا کنید.
کتابخانهها در Maps JavaScript API را ببینید.
سازنده | |
|---|---|
Map3DElement |
Map3DElement([options])پارامترها:
|
مشخصات | |
|---|---|
bounds |
نوع:
LatLngBounds|LatLngBoundsLiteral optionalوقتی تنظیم شود، موقعیت دوربین را در محدوده طول/عرض جغرافیایی مشخصشده محدود میکند. توجه داشته باشید که اشیای خارج از مرزها همچنان رندر میشوند. مرزها میتوانند هم طول جغرافیایی و هم عرض جغرافیایی را محدود کنند، یا میتوانند فقط عرض جغرافیایی یا فقط طول جغرافیایی را محدود کنند. برای مرزهای فقط عرض جغرافیایی، از طول جغرافیایی غربی و شرقی بهترتیب -180 و 180 استفاده کنید. برای مرزهای فقط طول جغرافیایی، بهترتیب از عرضهای جغرافیایی شمالی و جنوبی 90 و -90 استفاده کنید. |
center |
نوع:
LatLngAltitude|LatLngAltitudeLiteral optionalمرکز نقشه بهصورت LatLngAltitude ارائه میشود که در آن ارتفاع برحسب متر از سطح زمین است. توجه داشته باشید که این لزوماً جایی نیست که دوربین قرار دارد، زیرا فیلد
range بر فاصله دوربین از مرکز نقشه تأثیر میگذارد. اگر تنظیم نشده باشد، بهطور پیشفرض روی {lat: 0, lng: 0, altitude: 63170000} تنظیم میشود. ۶۳۱۷۰۰۰۰ متر حداکثر ارتفاع مجاز است (شعاع زمین ضرب در ۱۰).مشخصه HTML:
|
defaultUIHidden |
نوع:
boolean optionalپیشفرض:
falseوقتی
true، همه دکمههای پیشفرض واسط کاربر پنهان میشوند.مشخصه HTML:
|
description |
نوع:
string optionalاگر ارائه شده باشد، شرح دسترسپذیری (مثلاً برای استفاده با صفحهخوانها) با مقدار ارائهشده به نقشه اضافه خواهد شد.
مشخصه HTML:
|
gestureHandling |
نوع:
GestureHandling optionalپیشفرض:
GestureHandling.GREEDYمدیریت اشاره مشارکتی را کنترل میکند. وقتی روی
COOPERATIVE تنظیم شده باشد، برای پیمایش نقشه به کلیدهای اصلاحگر یا اشارههای دو انگشتی نیاز است. وقتی روی GREEDY تنظیم شود، صفحه میزبان نمیتواند از رویدادهای کاربر در عنصر نقشه پیمایش شود. وقتی روی AUTO تنظیم شود، مدیریت اشاره براساس پیمایشپذیری صفحه میزبان تعیین میشود.مشخصه HTML:
|
heading |
نوع:
number optionalجهت قطبنمای نقشه، برحسب درجه، که در آن شمال واقعی صفر است. وقتی شیبی وجود نداشته باشد، هرگونه چرخش بهعنوان جهت حرکت تفسیر خواهد شد.
مشخصه HTML:
|
internalUsageAttributionIds |
نوع:
Iterable<string> optionalشناسه ارجاع استفاده را به مقداردهی اولیه اضافه میکند، که به Google کمک میکند بفهمد کدام کتابخانهها و نمونهها برای توسعهدهندگان مفید هستند، مانند استفاده از کتابخانه خوشهبندی نشانگر. برای انصراف از ارسال شناسه ارجاع استفاده، میتوانید این ویژگی را حذف کنید. فقط مقادیر یکتا ارسال خواهد شد. تغییرات در این مقدار پساز نمونهسازی ممکن است نادیده گرفته شود.
مشخصه HTML:
|
language |
نوع:
string optionalزبان موردنظر برای ارائه زبان نقشه مبنا. بهطور پیشفرض به زبانی که توسعهدهنده هنگام بار کردن Maps JS API درخواست کرده است تنظیم میشود. |
mapId |
نوع:
string optionalشناسه نقشهای را مشخص میکند که برای واکشی سبک نقشه بااستفاده از فضای ابری برای نقشه استفاده خواهد شد. این نباید پساز مقداردهی اولیه نقشه تنظیم شود. بنابراین، مطمئن میشویم که mapId فقط درطول مقداردهی اولیه تنظیم شود و این مشخصه را در کانالهای عمومی منتشر نمیکنیم.
مشخصه HTML:
|
maxAltitude |
نوع:
number optionalحداکثر ارتفاع از سطح زمین که روی نقشه نمایش داده خواهد شد. مقدار معتبر بین
0 و 63170000 متر است (شعاع زمین ضرب در ۱۰).مشخصه HTML:
|
maxHeading |
نوع:
number optionalحداکثر زاویه جهت (چرخش) نقشه. مقدار معتبر بین
0 و 360 درجه است. minHeading و maxHeading نشاندهنده بازه <= 360 درجه است که در آن اشارههای سرصفحه مجاز خواهد بود. minHeading = 180 و maxHeading = 90 به heading in [0, 90] و heading in [180, 360] اجازه خواهند داد. minHeading = 90 و maxHeading = 180 به [90, 180] اجازه میدهند.مشخصه HTML:
|
maxTilt |
نوع:
number optionalحداکثر زاویه تابش نقشه. مقدار معتبر بین
0 و 90 درجه است.مشخصه HTML:
|
minAltitude |
نوع:
number optionalحداقل ارتفاع از سطح زمین که روی نقشه نمایش داده خواهد شد. مقدار معتبر بین
0 و 63170000 متر است (شعاع زمین ضرب در ۱۰).مشخصه HTML:
|
minHeading |
نوع:
number optionalحداقل زاویه جهت (چرخش) نقشه. مقدار معتبر بین
0 و 360 درجه است. minHeading و maxHeading نشاندهنده بازه <= 360 درجه است که در آن اشارههای سرصفحه مجاز خواهد بود. minHeading = 180 و maxHeading = 90 به heading in [0, 90] و heading in [180, 360] اجازه خواهند داد. minHeading = 90 و maxHeading = 180 به [90, 180] اجازه میدهند.مشخصه HTML:
|
minTilt |
نوع:
number optionalحداقل زاویه برخورد نقشه. مقدار معتبر بین
0 و 90 درجه است.مشخصه HTML:
|
mode |
نوع:
MapMode optionalحالتی را که نقشه باید در آن ارائه شود مشخص میکند. اگر تنظیم نشود، نقشه ارائه نخواهد شد.
مشخصه HTML:
|
range |
نوع:
number optionalفاصله دوربین تا مرکز نقشه، به متر.
مشخصه HTML:
|
region |
نوع:
string optionalمنطقهای که برای تلاش برای ارائه نقاط موردعلاقه نقشه پایه استفاده میشود. بهطور پیشفرض به منطقهای که توسعهدهنده هنگام بار کردن Maps JS API درخواست کرده است تنظیم میشود. |
roll |
نوع:
number optionalچرخش دوربین حول بردار دید برحسب درجه. برای رفع ابهام، وقتی شیبی وجود نداشته باشد، هرگونه چرخش بهعنوان جهت تفسیر میشود.
مشخصه HTML:
|
tilt |
نوع:
number optionalشیب بردار نمای دوربین برحسب درجه. بردار نمایشی که مستقیماً به زمین نگاه میکند، شیب صفر درجه دارد. بردار نمایشی که از زمین دور میشود، شیب
180 درجه دارد.مشخصه HTML:
|
|
نوع:
boolean optionalپیشفرض:
falseوقتی
true، همه دکمههای واسط کاربر پیشفرض غیرفعال هستند. صفحهکلید و کنترلهای اشارهای را غیرفعال نمیکند.مشخصه HTML:
|
روشها | |
|---|---|
addEventListener |
addEventListener(type, listener[, options])پارامترها:
مقدار برگشتی:
voidتابعی را راهاندازی میکند که هرگاه رویداد مشخصشده به هدف ارسال شود، فراخوانی خواهد شد. addEventListener را ببینید. |
flyCameraAround |
flyCameraAround(options)پارامترها:
مقدار برگشتی: هیچ
این روش دوربین را برای مدتزمان مشخصی در اطراف مکان مشخصی میچرخاند. پویانمایی میتواند به تعداد دفعات FlyAroundAnimationOptions.repeatCount تکرار شود. دوربین در جهت ساعتگرد حرکت خواهد کرد. این روش ناهمگام است زیرا پویانماییها فقط پساز اینکه نقشه حداقل مقدار را بار کرد میتوانند شروع شوند. این روش پساز شروع پویانمایی برمیگردد. اگر تعداد دفعات FlyAroundAnimationOptions.repeatCount صفر باشد، چرخشی رخ نخواهد داد و پویانمایی بلافاصله پساز شروع تکمیل خواهد شد. |
flyCameraTo |
flyCameraTo(options)پارامترها:
مقدار برگشتی: هیچ
این روش دوربین را بهصورت سهمی از مکان فعلی به مکان پایانی مشخصشده در مدتزمان مشخصشده حرکت میدهد. این روش ناهمگام است زیرا پویانماییها فقط پساز اینکه نقشه حداقل مقدار را بار کرد میتوانند شروع شوند. این روش پساز شروع پویانمایی برمیگردد. |
removeEventListener |
removeEventListener(type, listener[, options])پارامترها:
مقدار برگشتی:
voidشنونده رویدادی را که قبلاً با addEventListener ثبت شده است از هدف برمیدارد. removeEventListener را ببینید. |
stopCameraAnimation |
stopCameraAnimation()پارامترها: هیچ
مقدار برگشتی: هیچ
این روش هرگونه پویانمایی پرواز را که ممکن است درحال اجرا باشد متوقف میکند. دوربین در هر جایی که در میان پویانمایی باشد میماند؛ به نقطه پایانی تلپورت نمیشود. این روش غیرهمزمان است زیرا پویانماییها فقط پساز اینکه نقشه حداقل مقدار را بارگیری کرد میتوانند شروع یا متوقف شوند. این روش پساز توقف پویانمایی برمیگردد. |
رویدادها | |
|---|---|
gmp-animationend |
function(animationEndEvent)متغیرهای مستقل:
این رویداد زمانی فعال میشود که پویانمایی پرواز پایان یابد. این رویداد در درخت مدل شیءگرای سند : درخت DOM حباب ایجاد میکند. |
gmp-centerchange |
function(centerChangeEvent)متغیرهای مستقل:
این رویداد زمانی فعال میشود که ویژگی مرکز Map3DElement تغییر کند. |
gmp-click |
function(clickEvent)متغیرهای مستقل:
این رویداد زمانی فعال میشود که روی عنصر Map3DElement کلیک شود. |
gmp-error |
function(mapInitializationErrorEvent)متغیرهای مستقل:
این رویداد زمانی فعال میشود که نقشه مقداردهی اولیه نشود. |
gmp-headingchange |
function(headingChangeEvent)متغیرهای مستقل:
این رویداد زمانی فعال میشود که ویژگی heading مربوط به Map3DElement تغییر کند. |
gmp-map-id-error |
function(mapIdErrorEvent)متغیرهای مستقل:
این رویداد زمانی فعال میشود که ویژگی mapId مربوط به Map3DElement نامعتبر باشد. |
gmp-rangechange |
function(rangeChangeEvent)متغیرهای مستقل:
این رویداد زمانی فعال میشود که ویژگی محدوده Map3DElement تغییر کند. |
gmp-rollchange |
function(rollChangeEvent)متغیرهای مستقل:
این رویداد زمانی فعال میشود که ویژگی roll مربوط به Map3DElement تغییر کند. |
gmp-steadychange |
function(steadyChangeEvent)متغیرهای مستقل:
این رویداد زمانی فعال میشود که وضعیت ثابت Map3DElement تغییر کند. |
gmp-tiltchange |
function(tiltChangeEvent)متغیرهای مستقل:
این رویداد زمانی فعال میشود که ویژگی tilt در Map3DElement تغییر کند. |
میانای Map3DElementOptions
میانا
google.maps.maps3d.Map3DElementOptions
شیء Map3DElementOptions برای تعریف ویژگیهایی که میتوانند در Map3DElement تنظیم شوند استفاده میشود.
مشخصات | |
|---|---|
bounds optional |
نوع:
LatLngBounds|LatLngBoundsLiteral optionalMap3DElement.bounds را ببینید. |
center optional |
نوع:
LatLngAltitude|LatLngAltitudeLiteral optionalMap3DElement.center را ببینید. |
|
نوع:
boolean optional را ببینید. |
defaultUIHidden optional |
نوع:
boolean optionalMap3DElement.defaultUIHidden را ببینید. |
description optional |
نوع:
string optionalMap3DElement.description را ببینید. |
gestureHandling optional |
نوع:
GestureHandling optionalMap3DElement.gestureHandling را ببینید. |
heading optional |
نوع:
number optionalMap3DElement.heading را ببینید. |
internalUsageAttributionIds optional |
نوع:
Iterable<string> optionalMap3DElement.internalUsageAttributionIds را ببینید. |
language optional |
نوع:
string optionalMap3DElement.language را ببینید. |
mapId optional |
نوع:
string optionalMap3DElement.mapId را ببینید. |
maxAltitude optional |
نوع:
number optionalMap3DElement.maxAltitude را ببینید. |
maxHeading optional |
نوع:
number optionalMap3DElement.maxHeading را ببینید. |
maxTilt optional |
نوع:
number optionalMap3DElement.maxTilt را ببینید. |
minAltitude optional |
نوع:
number optionalMap3DElement.minAltitude را ببینید. |
minHeading optional |
نوع:
number optionalMap3DElement.minHeading را ببینید. |
minTilt optional |
نوع:
number optionalMap3DElement.minTilt را ببینید. |
mode optional |
نوع:
MapMode optionalMap3DElement.mode را ببینید. |
range optional |
نوع:
number optionalMap3DElement.range را ببینید. |
region optional |
نوع:
string optionalMap3DElement.region را ببینید. |
roll optional |
نوع:
number optionalMap3DElement.roll را ببینید. |
tilt optional |
نوع:
number optionalMap3DElement.tilt را ببینید. |
ثابتهای MapMode
google.maps.maps3d.MapMode
یادآور همیشگی
حالتی را که نقشه باید در آن ارائه شود مشخص میکند.
با تماس با const {MapMode} = await google.maps.importLibrary("maps3d") دسترسی پیدا کنید.
کتابخانهها در Maps JavaScript API را ببینید.
ثابتها | |
|---|---|
HYBRID |
این حالت نقشه لایهای شفاف از خیابانهای اصلی را روی تصاویر ماهوارهای یا واقعگرایانه نمایش میدهد. |
SATELLITE |
این حالت نقشه تصاویر ماهوارهای یا واقعگرایانه را درصورت دردسترس بودن نمایش میدهد. |
ثابتهای GestureHandling
google.maps.maps3d.GestureHandling
یادآور همیشگی
مشخص میکند که رویدادهای اشاره چگونه باید در عنصر نقشه مدیریت شوند.
با تماس با const {GestureHandling} = await google.maps.importLibrary("maps3d") دسترسی پیدا کنید.
کتابخانهها در Maps JavaScript API را ببینید.
ثابتها | |
|---|---|
AUTO |
این کار به نقشه اجازه میدهد انتخاب کند که از مدیریت اشاره مشارکتی یا حریصانه استفاده کند. اگر مشخص نشده باشد، این رفتار پیشفرض است. اگر نقشه بر والد پیمایش خود (معمولاً صفحه میزبان) مسلط باشد، بهطوریکه کاربر نتواند از نقشه به محتوای دیگر پیمایش کند، این باعث میشود نقشه وارد حالت مشارکتی شود. |
COOPERATIVE |
این کار حالت تعاملی را اجباری میکند که در آن برای پیمایش نقشه به کلیدهای اصلاحگر یا اشارههای دو انگشتی نیاز است. |
GREEDY |
این کار حالت حریصانه را اجباری میکند که در آن صفحه میزبان نمیتواند از رویدادهای کاربر در عنصر نقشه پیمایش شود. |
میانای FlyAroundAnimationOptions
میانا
google.maps.maps3d.FlyAroundAnimationOptions
گزینههای سفارشیسازی برای پویانمایی FlyCameraAround.
مشخصات | |
|---|---|
camera |
نوع:
CameraOptionsنقطه مرکزی که دوربین باید درطول پویانمایی مداری به آن نگاه کند. توجه داشته باشید که با چرخش دوربین در اطراف این نقطه مرکزی، عنوان نقشه تغییر خواهد کرد. |
durationMillis optional |
نوع:
number optionalمدت یک چرخه پویانمایی برحسب میلیثانیه. |
repeatCount optional |
نوع:
number optionalتعداد دفعاتی را که پویانمایی باید تکرار شود مشخص میکند. اگر عدد صفر باشد، پویانمایی بلافاصله پساز شروع تکمیل میشود. |
|
نوع:
number optionalتعداد دورهایی که باید در مدتزمان مشخصشده دور مرکز بچرخد. این گزینه سرعت کلی چرخش را کنترل میکند. ارسال عدد منفی به rounds باعث میشود دوربین بهجای جهت ساعتگرد پیشفرض، در جهت پادساعتگرد بچرخد. |
میانای FlyToAnimationOptions
میانا
google.maps.maps3d.FlyToAnimationOptions
گزینههای سفارشیسازی برای FlyCameraTo Animation.
مشخصات | |
|---|---|
endCamera |
نوع:
CameraOptionsمکانی که دوربین باید در پایان پویانمایی به آن اشاره کند. |
durationMillis optional |
نوع:
number optionalمدت پویانمایی برحسب میلیثانیه. مدتزمان ۰ دوربین را مستقیماً به موقعیت پایانی تلپورت میکند. |
میانای CameraOptions
میانا
google.maps.maps3d.CameraOptions
شیء CameraOptions برای تعریف ویژگیهایی که میتوانند روی شیء دوربین تنظیم شوند استفاده میشود. شیء دوربین میتواند هر چیزی باشد که موقعیت دوربین دارد، مثلاً وضعیت نقشه فعلی یا وضعیت پویانمایی درخواستشده در آینده.
مشخصات | |
|---|---|
center optional |
نوع:
LatLngAltitude|LatLngAltitudeLiteral optionalMap3DElement.center را ببینید. |
heading optional |
نوع:
number optionalMap3DElement.heading را ببینید. |
range optional |
نوع:
number optionalMap3DElement.range را ببینید. |
roll optional |
نوع:
number optionalMap3DElement.roll را ببینید. |
tilt optional |
نوع:
number optionalMap3DElement.tilt را ببینید. |
کلاس 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
کلاس
این رویداد با کلیک کردن روی Map3DElement ایجاد شده است.
این کلاس
Event را گسترش میدهد.
با تماس با const {LocationClickEvent} = await google.maps.importLibrary("maps3d") دسترسی پیدا کنید.
کتابخانهها در Maps JavaScript API را ببینید.
مشخصات | |
|---|---|
position |
نوع:
LatLngAltitude optionalطول جغرافیایی/عرض جغرافیایی/ارتفاعی که هنگام وقوع رویداد زیر مکاننما بود. لطفاً توجه داشته باشید که در سطوح کلیتر، دادههای با دقت کمتر برگردانده خواهد شد. همچنین، هنگام کلیک کردن روی سطح آب از موقعیتهای بالاتر دوربین، ممکن است ارتفاع بستر دریا برای مقدار ارتفاع برگردانده شود. این رویداد در درخت مدل شیءگرای سند : درخت DOM حباب ایجاد میکند. |
کلاس PlaceClickEvent
google.maps.maps3d.PlaceClickEvent
کلاس
این رویداد با کلیک کردن روی نماد مکان در Map3DElement ایجاد شده است. برای جلوگیری از نمایش بالاپر پیشفرض، روش preventDefault() را در این رویداد فراخوانی کنید تا از مدیریت آن توسط Map3DElement جلوگیری شود.
این کلاس
LocationClickEvent را گسترش میدهد.
با تماس با const {PlaceClickEvent} = await google.maps.importLibrary("maps3d") دسترسی پیدا کنید.
کتابخانهها در Maps JavaScript API را ببینید.
مشخصات | |
|---|---|
placeId |
نوع:
stringشناسه مکان ویژگی نقشه. |
از سازمان بالاتر:
position
| |
روشها | |
|---|---|
fetchPlace |
fetchPlace()پارامترها: هیچ
Place را برای این شناسه مکان واکشی میکند. در شیء Place حاصل، ویژگی id پر خواهد شد. فیلدهای اضافی را میتوان متعاقباً ازطریق Place.fetchFields() درخواست کرد، مشروط به فعالسازی و صورتحساب عادی Places API. اگر خطایی در واکشی Place وجود داشته باشد، وعده رد میشود. |