Places UI Kit : یک کتابخانه آماده برای استفاده که فضایی را برای سفارشی‌سازی و توسعه کم کد فراهم می‌کند. آن را امتحان کنید و نظرات خود را در مورد تجربه کیت UI خود به اشتراک بگذارید.

‫Google برای ترجمه محتوا به زبان ترجیحی شما از فناوری هوشواره استفاده می‌کند. ترجمه‌های هوشواره‌ای ممکن است اشتباه داشته باشند.

3D Maps

کلاس Map3DElement

google.maps.maps3d.Map3DElement class
extends HTMLElement
implements Map3DElementOptions
library "maps3d"

‫Map3DElement یک میانای HTML برای نمای «نقشه سه‌بعدی» است. توجه داشته باشید که mode باید تنظیم شود تا «نقشه سه‌بعدی» شروع به پرداز کردن کند.

                  
<gmp-map-3d
  autofits-camera-animation="value-name"
  camera-position="lat,lng,altitude"
  center="lat,lng,altitude"
  default-ui-hidden
  description="string"
  fov="number"
  gesture-handling="value-name"
  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="value-name"
  range="number"
  roll="number"
  tilt="number">
</gmp-map-3d>

const {Map3DElement} = await google.maps.importLibrary("maps3d");

سازنده
`Map3DElement`	`Map3DElement([options])` پارامترها: ‫`options`:‏ `Map3DElementOptions optional`

مشخصات
`autofitsCameraAnimation` attr: autofits-camera-animation	توجه: فقط در کانال v=alpha دردسترس است. نوع ورودی: `AutofitsCameraAnimation optional` نوع خروجی: `AutofitsCameraAnimation optional` پیش‌فرض: `none` پویانمایی‌ای که برای تطبیق خودکار دوربین استفاده می‌شود. مشخصه HTML: `autofits-camera-animation="value-name"`
`bounds`	نوع ورودی: `LatLngBounds\|LatLngBoundsLiteral optional` نوع خروجی: `LatLngBounds optional` وقتی تنظیم شود، موقعیت دوربین را در محدوده طول/عرض جغرافیایی مشخص‌شده محدود می‌کند. توجه داشته باشید که اشیای خارج از مرزها همچنان رندر می‌شوند. مرزها می‌توانند هم طول جغرافیایی و هم عرض جغرافیایی را محدود کنند، یا می‌توانند فقط عرض جغرافیایی یا فقط طول جغرافیایی را محدود کنند. برای مرزهای فقط عرض جغرافیایی، از طول جغرافیایی غربی و شرقی به‌ترتیب `-180` و `180` استفاده کنید. برای مرزهای فقط طول جغرافیایی، به‌ترتیب از عرض‌های جغرافیایی شمالی و جنوبی `90` و `-90` استفاده کنید.
`cameraPosition` attr: camera-position	نوع ورودی: `LatLngAltitude\|LatLngAltitudeLiteral\|LatLngLiteral optional` نوع خروجی: `LatLngAltitude optional` موقعیت دوربین به‌صورت LatLngAltitude ارائه شده است. اگر حذف شود، مشتق خواهد شد. اگر `center` حذف شود اما `cameraPosition` مشخص شود، `center` از `cameraPosition.` مشتق خواهد شد. اگر هر دو در یک حلقه اجرا به‌روز شوند، `cameraPosition` ترجیح داده خواهد شد. فیلدهای `cameraPosition` و `center` می‌توانند در بافت عنوان، محدوده، چرخش، و شیب مشترک ارائه‌شده، به‌صورت یک‌به‌یک از یکدیگر مشتق شوند. مشخصه HTML: `camera-position="lat,lng,altitude"`
`center` attr: center	نوع ورودی: `LatLngAltitude\|LatLngAltitudeLiteral\|LatLngLiteral optional` نوع خروجی: `LatLngAltitude optional` مرکز نقشه به‌صورت LatLngAltitude ارائه می‌شود که در آن ارتفاع برحسب متر بالاتر از سطح متوسط دریا است. توجه داشته باشید که این لزوماً جایی نیست که دوربین قرار دارد، زیرا فیلد `range` بر فاصله دوربین از مرکز نقشه تأثیر می‌گذارد. اگر تنظیم نشده باشد، به‌طور پیش‌فرض روی `{lat: 0, lng: 0, altitude: 63170000}` تنظیم می‌شود. ‫۶۳۱۷۰۰۰۰ متر حداکثر ارتفاع مجاز است (شعاع زمین ضرب در ۱۰). مشخصه HTML: `center="lat,lng,altitude"`
`defaultUIHidden` attr: default-ui-hidden	نوع ورودی: `boolean optional` نوع خروجی: `boolean` پیش‌فرض: `false` وقتی `true`، همه دکمه‌های پیش‌فرض واسط کاربر پنهان می‌شوند. مشخصه HTML: `default-ui-hidden`
`description` attr: description	نوع ورودی: `string optional` نوع خروجی: `string optional` اگر ارائه شده باشد، شرح دسترس‌پذیری (مثلاً برای استفاده با صفحه‌خوان‌ها) با مقدار ارائه‌شده به نقشه اضافه خواهد شد. مشخصه HTML: `description="string"`
`fov` attr: fov	نوع ورودی: `number optional` نوع خروجی: `number optional` میدان دید عمودی را برحسب درجه مشخص می‌کند. محدوده مقادیر معتبر از ۵٫۰ تا ۸۰٫۰ است. مقادیر بالاتر ناحیه قابل‌مشاهده را افزایش می‌دهد اما ممکن است باعث اعوجاج پرسپکتیو شود. پیش‌فرض: ۳۵٫۰. مشخصه HTML: `fov="number"`
`gestureHandling` attr: gesture-handling	نوع ورودی: `GestureHandling optional` نوع خروجی: `GestureHandling` پیش‌فرض: `GestureHandling.GREEDY` مدیریت اشاره مشارکتی را کنترل می‌کند. وقتی روی `COOPERATIVE` تنظیم شده باشد، برای پیمایش نقشه به کلیدهای اصلاح‌گر یا اشاره‌های دو انگشتی نیاز است. وقتی روی `GREEDY` تنظیم شود، صفحه میزبان نمی‌تواند از رویدادهای کاربر در عنصر نقشه پیمایش شود. وقتی روی `AUTO` تنظیم شود، مدیریت اشاره براساس پیمایش‌پذیری صفحه میزبان تعیین می‌شود. مشخصه HTML: `gesture-handling="value-name"`
`heading` attr: heading	نوع ورودی: `number optional` نوع خروجی: `number optional` جهت قطب‌نمای نقشه، برحسب درجه، که در آن شمال واقعی صفر است. وقتی شیبی وجود نداشته باشد، هرگونه چرخش به‌عنوان جهت حرکت تفسیر خواهد شد. مشخصه HTML: `heading="number"`
`internalUsageAttributionIds` attr: internal-usage-attribution-ids	نوع ورودی: `Iterable<string> optional` نوع خروجی: `Array<string> optional` شناسه ارجاع استفاده را به مقداردهی اولیه اضافه می‌کند، که به Google کمک می‌کند بفهمد کدام کتابخانه‌ها و نمونه‌ها برای توسعه‌دهندگان مفید هستند، مانند استفاده از کتابخانه خوشه‌بندی نشانگر. برای انصراف از ارسال شناسه ارجاع استفاده، می‌توانید این ویژگی را حذف کنید. فقط مقادیر یکتا ارسال خواهد شد. تغییرات در این مقدار پس‌از نمونه‌سازی ممکن است نادیده گرفته شود. مشخصه HTML: `internal-usage-attribution-ids="id1 id2"`
`language`	نوع ورودی: `string optional` نوع خروجی: `string optional` زبان موردنظر برای ارائه زبان نقشه مبنا. به‌طور پیش‌فرض به زبانی که توسعه‌دهنده هنگام بار کردن Maps JS API درخواست کرده است تنظیم می‌شود.
`mapId` attr: map-id	نوع ورودی: `string optional` نوع خروجی: `string optional` شناسه نقشه‌ای را مشخص می‌کند که برای واکشی سبک نقشه بااستفاده از فضای ابری برای نقشه استفاده خواهد شد. مشخصه HTML: `map-id="string"`
`maxAltitude` attr: max-altitude	نوع ورودی: `number optional` نوع خروجی: `number optional` حداکثر ارتفاع از سطح زمین که روی نقشه نمایش داده خواهد شد. مقدار معتبر بین `0` و `63170000` متر است (شعاع زمین ضرب در ۱۰). مشخصه HTML: `max-altitude="number"`
`maxHeading` attr: max-heading	نوع ورودی: `number optional` نوع خروجی: `number optional` حداکثر زاویه جهت (چرخش) نقشه. مقدار معتبر بین `0` و `360` درجه است. ‫`minHeading` و `maxHeading` نشان‌دهنده بازه <= `360` درجه است که در آن اشاره‌های عنوان مجاز خواهد بود. ‫`minHeading = 180` و `maxHeading = 90` به حرکت در جهت `[0, 90]` و حرکت در جهت `[180, 360]` اجازه خواهند داد. ‫`minHeading = 90` و `maxHeading = 180` به `[90, 180]` اجازه می‌دهند. مشخصه HTML: `max-heading="number"`
`maxTilt` attr: max-tilt	نوع ورودی: `number optional` نوع خروجی: `number optional` حداکثر زاویه تابش نقشه. مقدار معتبر بین `0` و `90` درجه است. مشخصه HTML: `max-tilt="number"`
`minAltitude` attr: min-altitude	نوع ورودی: `number optional` نوع خروجی: `number optional` حداقل ارتفاع از سطح زمین که روی نقشه نمایش داده خواهد شد. مقدار معتبر بین `0` و `63170000` متر است (شعاع زمین ضرب در ۱۰). مشخصه HTML: `min-altitude="number"`
`minHeading` attr: min-heading	نوع ورودی: `number optional` نوع خروجی: `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: `min-heading="number"`
`minTilt` attr: min-tilt	نوع ورودی: `number optional` نوع خروجی: `number optional` حداقل زاویه برخورد نقشه. مقدار معتبر بین `0` و `90` درجه است. مشخصه HTML: `min-tilt="number"`
`mode` attr: mode	نوع ورودی: `MapMode optional` نوع خروجی: `MapMode optional` حالتی را که نقشه باید در آن ارائه شود مشخص می‌کند. اگر تنظیم نشود، نقشه ارائه نخواهد شد. مشخصه HTML: `mode="value-name"`
`range` attr: range	نوع ورودی: `number optional` نوع خروجی: `number optional` فاصله دوربین تا مرکز نقشه، به متر. مشخصه HTML: `range="number"`
`region`	نوع ورودی: `string optional` نوع خروجی: `string optional` منطقه‌ای که برای تلاش برای ارائه نقاط موردعلاقه نقشه پایه استفاده می‌شود. به‌طور پیش‌فرض به منطقه‌ای که توسعه‌دهنده هنگام بار کردن Maps JS API درخواست کرده است تنظیم می‌شود.
`roll` attr: roll	نوع ورودی: `number optional` نوع خروجی: `number optional` چرخش دوربین حول بردار دید برحسب درجه. برای رفع ابهام، وقتی شیبی وجود نداشته باشد، هرگونه چرخش به‌عنوان جهت تفسیر می‌شود. مشخصه HTML: `roll="number"`
`tilt` attr: tilt	نوع ورودی: `number optional` نوع خروجی: `number optional` شیب بردار نمای دوربین برحسب درجه. بردار نمایشی که مستقیماً به زمین نگاه می‌کند، شیب صفر درجه دارد. بردار نمایشی که از زمین دور می‌شود، شیب `180` درجه دارد. مشخصه HTML: `tilt="number"`
`defaultUIDisabled` attr: default-ui-disabled	منسوخ‌شده: لطفاً به‌جای آن از `Map3DElement.defaultUIHidden` استفاده کنید. این ویژگی در نسخه پخش آتی برداشته خواهد شد. نوع: `boolean optional` پیش‌فرض: `false` وقتی `true`، همه دکمه‌های واسط کاربر پیش‌فرض غیرفعال هستند. صفحه‌کلید و کنترل‌های اشاره‌ای را غیرفعال نمی‌کند. مشخصه HTML: `default-ui-disabled`

روش‌ها
`flyCameraAround`	`flyCameraAround(options)` پارامترها: ‫`options`:‏ `FlyAroundAnimationOptions` مقدار برگشتی: هیچ این روش دوربین را برای مدت‌زمان مشخصی در اطراف مکان مشخصی می‌چرخاند. پویانمایی می‌تواند به تعداد دفعات `FlyAroundAnimationOptions.repeatCount` تکرار شود. دوربین در جهت ساعت‌گرد حرکت خواهد کرد. مکانی که دوربین دور آن می‌چرخد ازطریق `CameraOptions.center` مشخص می‌شود. این مکانی است که درطول پویانمایی مداری در مرکز نمای دید نشان داده می‌شود، درحالی‌که دوربین در اطراف آن حرکت می‌کند. این روش ناهمگام است زیرا پویانمایی‌ها فقط پس‌از اینکه نقشه حداقل مقدار را بار کرد می‌توانند شروع شوند. این روش پس‌از شروع پویانمایی برمی‌گردد. اگر تعداد دفعات `FlyAroundAnimationOptions.repeatCount` صفر باشد، چرخشی رخ نخواهد داد و پویانمایی بلافاصله پس‌از شروع تکمیل خواهد شد.
`flyCameraTo`	`flyCameraTo(options)` پارامترها: ‫`options`:‏ `FlyToAnimationOptions` مقدار برگشتی: هیچ این روش دوربین را به‌صورت سهمی از مکان فعلی به مکان پایانی مشخص‌شده در مدت‌زمان مشخص‌شده حرکت می‌دهد. مکان پایانی را می‌توان ازطریق `CameraOptions.cameraPosition` (که موقعیت دقیق دوربین را کنترل می‌کند) یا ازطریق `CameraOptions.center` (که مرکز نمای دید مرئی نقشه را کنترل می‌کند) مشخص کرد. این روش ناهمگام است زیرا پویانمایی‌ها فقط پس‌از اینکه نقشه حداقل مقدار را بار کرد می‌توانند شروع شوند. این روش پس‌از شروع پویانمایی برمی‌گردد.
`stopCameraAnimation`	`stopCameraAnimation()` پارامترها: هیچ مقدار برگشتی: هیچ این روش هرگونه پویانمایی پرواز را که ممکن است درحال اجرا باشد متوقف می‌کند. دوربین در هر جایی که در میان پویانمایی باشد می‌ماند؛ به نقطه پایانی تلپورت نمی‌شود. این روش غیرهم‌زمان است زیرا پویانمایی‌ها فقط پس‌از اینکه نقشه حداقل مقدار را بارگیری کرد می‌توانند شروع یا متوقف شوند. این روش پس‌از توقف پویانمایی برمی‌گردد.
به‌ارث‌رسیده: `addEventListener`، `removeEventListener`

رویدادها
`gmp-animationend`	`function(animationEndEvent)` متغیرهای مستقل: ‫`animationEndEvent`:‏ `Event optional` این رویداد زمانی فعال می‌شود که پویانمایی پرواز پایان یابد. این رویداد در درخت مدل شیءگرای سند : درخت DOM حباب ایجاد می‌کند.
`gmp-camerapositionchange`	`function(cameraPositionChangeEvent)` متغیرهای مستقل: ‫`cameraPositionChangeEvent`:‏ `Event optional` این رویداد زمانی فعال می‌شود که ویژگی cameraPosition مربوط به Map3DElement تغییر کند.
`gmp-centerchange`	`function(centerChangeEvent)` متغیرهای مستقل: ‫`centerChangeEvent`:‏ `Event optional` این رویداد زمانی فعال می‌شود که ویژگی مرکز Map3DElement تغییر کند.
`gmp-click`	`function(clickEvent)` متغیرهای مستقل: ‫`clickEvent`:‏ `LocationClickEvent\|PlaceClickEvent optional` این رویداد زمانی فعال می‌شود که روی عنصر `Map3DElement` کلیک شود.
`gmp-error`	`function(mapInitializationErrorEvent)` متغیرهای مستقل: ‫`mapInitializationErrorEvent`:‏ `Event optional` این رویداد زمانی فعال می‌شود که نقشه مقداردهی اولیه نشود.
`gmp-fovchange`	`function(fovChangeEvent)` متغیرهای مستقل: ‫`fovChangeEvent`:‏ `Event optional` This event is fired when the Map3DElement's fov property changes.
`gmp-headingchange`	`function(headingChangeEvent)` متغیرهای مستقل: ‫`headingChangeEvent`:‏ `Event optional` این رویداد زمانی فعال می‌شود که ویژگی heading مربوط به Map3DElement تغییر کند.
`gmp-map-id-error`	`function(mapIdErrorEvent)` متغیرهای مستقل: ‫`mapIdErrorEvent`:‏ `Event optional` این رویداد زمانی فعال می‌شود که ویژگی mapId مربوط به Map3DElement نامعتبر باشد.
`gmp-rangechange`	`function(rangeChangeEvent)` متغیرهای مستقل: ‫`rangeChangeEvent`:‏ `Event optional` این رویداد زمانی فعال می‌شود که ویژگی محدوده Map3DElement تغییر کند.
`gmp-rollchange`	`function(rollChangeEvent)` متغیرهای مستقل: ‫`rollChangeEvent`:‏ `Event optional` این رویداد زمانی فعال می‌شود که ویژگی roll مربوط به Map3DElement تغییر کند.
`gmp-steadychange`	`function(steadyChangeEvent)` متغیرهای مستقل: ‫`steadyChangeEvent`:‏ `SteadyChangeEvent optional` این رویداد زمانی فعال می‌شود که وضعیت ثابت `Map3DElement` تغییر کند.
`gmp-tiltchange`	`function(tiltChangeEvent)` متغیرهای مستقل: ‫`tiltChangeEvent`:‏ `Event optional` این رویداد زمانی فعال می‌شود که ویژگی tilt در Map3DElement تغییر کند.

میانای Map3DElementOptions

میانا google.maps.maps3d.Map3DElementOptions

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

مشخصات
`autofitsCameraAnimation` اختیاری	توجه: فقط در کانال v=alpha دردسترس است. نوع: `AutofitsCameraAnimation optional` `Map3DElement.autofitsCameraAnimation` را ببینید.
`bounds` اختیاری	نوع: `LatLngBounds\|LatLngBoundsLiteral optional` `Map3DElement.bounds` را ببینید.
`cameraPosition` اختیاری	نوع: `LatLngAltitude\|LatLngAltitudeLiteral\|LatLngLiteral optional` `Map3DElement.cameraPosition` را ببینید.
`center` اختیاری	نوع: `LatLngAltitude\|LatLngAltitudeLiteral\|LatLngLiteral optional` `Map3DElement.center` را ببینید.
`defaultUIDisabled` اختیاری	منسوخ‌شده: لطفاً به‌جای آن از `Map3DElement.defaultUIHidden` استفاده کنید. این ویژگی در نسخه پخش آتی برداشته خواهد شد. نوع: `boolean optional` `Map3DElement.defaultUIDisabled` را ببینید.
`defaultUIHidden` اختیاری	نوع: `boolean optional` `Map3DElement.defaultUIHidden` را ببینید.
`description` اختیاری	نوع: `string optional` `Map3DElement.description` را ببینید.
`fov` اختیاری	نوع: `number optional` `Map3DElement.fov` را ببینید.
`gestureHandling` اختیاری	نوع: `GestureHandling optional` `Map3DElement.gestureHandling` را ببینید.
`heading` اختیاری	نوع: `number optional` `Map3DElement.heading` را ببینید.
`internalUsageAttributionIds` اختیاری	نوع: `Iterable<string> optional` `Map3DElement.internalUsageAttributionIds` را ببینید.
`language` اختیاری	نوع: `string optional` `Map3DElement.language` را ببینید.
`mapId` اختیاری	نوع: `string optional` `Map3DElement.mapId` را ببینید.
`maxAltitude` اختیاری	نوع: `number optional` `Map3DElement.maxAltitude` را ببینید.
`maxHeading` اختیاری	نوع: `number optional` `Map3DElement.maxHeading` را ببینید.
`maxTilt` اختیاری	نوع: `number optional` `Map3DElement.maxTilt` را ببینید.
`minAltitude` اختیاری	نوع: `number optional` `Map3DElement.minAltitude` را ببینید.
`minHeading` اختیاری	نوع: `number optional` `Map3DElement.minHeading` را ببینید.
`minTilt` اختیاری	نوع: `number optional` `Map3DElement.minTilt` را ببینید.
`mode` اختیاری	نوع: `MapMode optional` `Map3DElement.mode` را ببینید.
`range` اختیاری	نوع: `number optional` `Map3DElement.range` را ببینید.
`region` اختیاری	نوع: `string optional` `Map3DElement.region` را ببینید.
`roll` اختیاری	نوع: `number optional` `Map3DElement.roll` را ببینید.
`tilt` اختیاری	نوع: `number optional` `Map3DElement.tilt` را ببینید.

ثابت‌های MapMode

google.maps.maps3d.MapMode ثابت‌ها
کتابخانه "maps3d"

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

این ثابت‌ها به‌عنوان رشته نیز قابل‌استفاده هستند. در TypeScript، رشته‌های لفظی با نوع MapModeString تعریف می‌شوند.

const {MapMode} = await google.maps.importLibrary("maps3d");

ثابت‌ها
`HYBRID`	این حالت نقشه لایه‌ای شفاف از خیابان‌های اصلی را روی تصاویر ماهواره‌ای یا واقع‌گرایانه نمایش می‌دهد.
`ROADMAP`	توجه: فقط در کانال v=alpha دردسترس است. این حالت نقشه، نقشه خیابان معمولی را نمایش می‌دهد.
`SATELLITE`	این حالت نقشه تصاویر ماهواره‌ای یا واقع‌گرایانه را درصورت دردسترس بودن نمایش می‌دهد.

ثابت‌های GestureHandling

google.maps.maps3d.GestureHandling ثابت‌ها
کتابخانه "maps3d"

مشخص می‌کند که رویدادهای اشاره چگونه باید در عنصر نقشه مدیریت شوند.

این ثابت‌ها به‌عنوان رشته نیز قابل‌استفاده هستند. در TypeScript، رشته‌های لفظی با نوع GestureHandlingString تعریف می‌شوند.

const {GestureHandling} = await google.maps.importLibrary("maps3d");

ثابت‌ها
`AUTO`	این کار به نقشه اجازه می‌دهد انتخاب کند که از مدیریت اشاره مشارکتی یا حریصانه استفاده کند. اگر مشخص نشده باشد، این رفتار پیش‌فرض است. اگر نقشه بر والد پیمایش خود (معمولاً صفحه میزبان) مسلط باشد، به‌طوری‌که کاربر نتواند از نقشه به محتوای دیگر پیمایش کند، این باعث می‌شود نقشه وارد حالت مشارکتی شود.
`COOPERATIVE`	این کار حالت تعاملی را اجباری می‌کند که در آن برای پیمایش نقشه به کلیدهای اصلاح‌گر یا اشاره‌های دو انگشتی نیاز است.
`GREEDY`	این کار حالت حریصانه را اجباری می‌کند که در آن صفحه میزبان نمی‌تواند از رویدادهای کاربر در عنصر نقشه پیمایش شود.

AutofitsCameraAnimation ثابت‌ها

google.maps.maps3d.AutofitsCameraAnimation ثابت‌ها
کتابخانه "maps3d"

مشخص می‌کند که دوربین وقتی به موقعیت جدیدی منتقل می‌شود تا خودش را براساس عناصر فرزند موافقت‌شده در مرکز قرار دهد، باید چگونه رفتار کند.

این ثابت‌ها به‌عنوان رشته نیز قابل‌استفاده هستند. در TypeScript، رشته‌های لفظی با نوع AutofitsCameraAnimationString تعریف می‌شوند.

const {AutofitsCameraAnimation} = await google.maps.importLibrary("maps3d");

ثابت‌ها
`FLY_TO`	به موقعیت جدید پرواز می‌کند.
`NONE`	بدون پویانمایی به موقعیت جدید می‌پرد.

میانای FlyAroundAnimationOptions

میانا google.maps.maps3d.FlyAroundAnimationOptions

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

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

میانای FlyToAnimationOptions

میانا google.maps.maps3d.FlyToAnimationOptions

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

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

میانای CameraOptions

میانا google.maps.maps3d.CameraOptions

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

مشخصات
`altitudeMode` اختیاری	نوع: `AltitudeMode optional` پیش‌فرض: `AltitudeMode.ABSOLUTE` یک enum که نحوه تفسیر مقدار ارتفاع شیء `CameraOptions` داده‌شده را مشخص می‌کند. این کار از نگاشت شماره تلفن (ENUM) `AltitudeMode` موجود مجدداً استفاده می‌کند.
`cameraPosition` اختیاری	نوع: `LatLngAltitude\|LatLngAltitudeLiteral\|LatLngLiteral optional` `Map3DElement.cameraPosition` را ببینید.
`center` اختیاری	نوع: `LatLngAltitude\|LatLngAltitudeLiteral\|LatLngLiteral optional` `Map3DElement.center` را ببینید.
`fov` اختیاری	نوع: `number optional` `Map3DElement.fov` را ببینید.
`heading` اختیاری	نوع: `number optional` `Map3DElement.heading` را ببینید.
`range` اختیاری	نوع: `number optional` `Map3DElement.range` را ببینید.
`roll` اختیاری	نوع: `number optional` `Map3DElement.roll` را ببینید.
`tilt` اختیاری	نوع: `number optional` `Map3DElement.tilt` را ببینید.

کلاس SteadyChangeEvent

google.maps.maps3d.SteadyChangeEvent class
extends Event
library "maps3d"

این رویداد از نظارت بر وضعیت ثابت Map3DElement ایجاد شده است. این رویداد در درخت مدل شیءگرای سند : درخت DOM حباب ایجاد می‌کند.

const {SteadyChangeEvent} = await google.maps.importLibrary("maps3d");

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

کلاس LocationClickEvent

google.maps.maps3d.LocationClickEvent class
extends Event
library "maps3d"

این رویداد با کلیک کردن روی Map3DElement ایجاد شده است.

const {LocationClickEvent} = await google.maps.importLibrary("maps3d");

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

مشخصات

position

نوع: LatLngAltitude optional

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

کلاس PlaceClickEvent

google.maps.maps3d.PlaceClickEvent class
extends LocationClickEvent
library "maps3d"

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

const {PlaceClickEvent} = await google.maps.importLibrary("maps3d");

مشخصات
`placeId`	نوع: `string` شناسه مکان ویژگی نقشه.
از سازمان بالاتر: `position`

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

روش‌ها

fetchPlace

fetchPlace()

پارامترها: هیچ

مقدار برگشتی: Promise<Place>

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

3D Maps با مجموعه‌ها، منظم بمانید ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.

کلاس Map3DElement

سازنده

مشخصات

روش‌ها

رویدادها

میانای Map3DElementOptions

مشخصات

ثابت‌های MapMode

ثابت‌ها

ثابت‌های GestureHandling

ثابت‌ها

AutofitsCameraAnimation ثابت‌ها

ثابت‌ها

میانای FlyAroundAnimationOptions

مشخصات

میانای FlyToAnimationOptions

مشخصات

میانای CameraOptions

مشخصات

کلاس SteadyChangeEvent

مشخصات

کلاس LocationClickEvent

مشخصات

کلاس PlaceClickEvent

مشخصات

روش‌ها

3D Maps