إشعار: ستتوفّر قريبًا ميزة جديدة لتصميم الخرائط الأساسية في "منصة خرائط Google". يتضمّن هذا التعديل على تصميم الخريطة لوحة ألوان تلقائية جديدة وعلامات جديدة وتحسينات على تجارب الخريطة وسهولة استخدامها. سيتم تعديل جميع أنماط الخرائط تلقائيًا في آذار (مارس) 2025. لمزيد من المعلومات عن مدى التوفّر وكيفية تفعيل هذا النمط في وقت سابق، يُرجى الاطّلاع على نمط الخريطة الجديد لمنصّة "خرائط Google".

تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

3D Maps

Map3DElement class

google.maps.maps3d.Map3DElement class

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"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.

الشركة المصنِّعة
`Map3DElement`	`Map3DElement([options])` المَعلمات: `options`: `Map3DElementOptions optional`

الخصائص
`bounds`	النوع: `LatLngBounds\|LatLngBoundsLiteral optional` عند ضبطها، تحدّ من موضع الكاميرا ضمن حدود خط الطول/العرض المحدّدة. يُرجى العلم أنّه لا يزال يتم عرض الأجسام خارج الحدود. يمكن أن تحدّ الحدود من خط الطول وخط العرض معًا، أو يمكن أن تحدّ من خط الطول أو خط العرض فقط. بالنسبة إلى الحدود المتعلّقة بخطوط العرض فقط، استخدِم خطوط الطول الغربية والشرقية `-180` و`180` على التوالي. بالنسبة إلى الحدود التي تستند إلى خطوط الطول فقط، استخدِم خطوط العرض الشمالية والجنوبية `90` و`-90` على التوالي.
`center`	النوع: `LatLngAltitude\|LatLngAltitudeLiteral optional` وسط الخريطة المقدَّم كعنصر 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>`

الطُرق
`addEventListener`	ملاحظة: لا تتوفّر هذه الميزة إلا في قناة v=beta. `addEventListener(type, listener[, options])` المَعلمات: `type`: `string` سلسلة حسّاسة لحالة الأحرف تمثّل نوع الحدث الذي تريد الاستماع إليه. `listener`: `EventListener\|EventListenerObject` العنصر الذي يتلقّى إشعارًا. يجب أن يكون هذا العنصر دالة أو كائنًا يتضمّن طريقة handleEvent. `options`: `boolean\|AddEventListenerOptions optional` اطّلِع على الخيارات. لا تتيح الأحداث المخصّصة سوى `capture` و`passive`. القيمة المعروضة: `void` تُستخدَم لإعداد دالة سيتمّ استدعاؤها عند إرسال الحدث المحدّد إلى الهدف. راجِع addEventListener.
`flyCameraAround`	`flyCameraAround(options)` المَعلمات: `options`: `FlyAroundAnimationOptions` القيمة المعروضة: لا شيء تدور هذه الطريقة بالكاميرا حول موقع جغرافي معيّن لمدة معيّنة، ما يؤدي إلى إجراء عدد معيّن من الجولات خلال ذلك الوقت. تدور الكاميرا تلقائيًا في اتجاه عقارب الساعة. إذا تم إدخال رقم سالب لعدد الجولات، ستدور الكاميرا في اتجاه عقارب الساعة بدلاً من ذلك. الطريقة غير متزامنة لأنّه لا يمكن بدء الصور المتحركة إلا بعد تحميل الحد الأدنى من الخريطة. يتم عرض الطريقة بعد بدء الصورة المتحركة. إذا كان عدد الجولات يساوي صفرًا، لن يحدث دوران، وسيكتمل التأثير المتحرك بعد بدء تشغيله مباشرةً.
`flyCameraTo`	`flyCameraTo(options)` المَعلمات: `options`: `FlyToAnimationOptions` القيمة المعروضة: لا شيء تنقل هذه الطريقة الكاميرا بشكل مكافئ من الموقع الجغرافي الحالي إلى موقع نهائي محدّد خلال مدة محدّدة. الطريقة غير متزامنة لأنّه لا يمكن بدء الصور المتحركة إلا بعد تحميل الحد الأدنى من الخريطة. يتم عرض الطريقة بعد بدء الصورة المتحركة.
`removeEventListener`	ملاحظة: لا تتوفّر هذه الميزة إلا في قناة v=beta. `removeEventListener(type, listener[, options])` المَعلمات: `type`: `string` سلسلة تحدّد نوع الحدث الذي يجب إزالة مستمع الحدث له. `listener`: `EventListener\|EventListenerObject` أداة معالجة الحدث المطلوب إزالتها من هدف الحدث `options`: `boolean\|EventListenerOptions optional` اطّلِع على الخيارات. القيمة المعروضة: `void` تزيل هذه الوظيفة أداة معالجة حدث مسجَّلة سابقًا باستخدام addEventListener من الهدف. راجِع removeEventListener.
`stopCameraAnimation`	`stopCameraAnimation()` المَعلمات: بدون القيمة المعروضة: لا شيء تؤدي هذه الطريقة إلى إيقاف أيّ حركة متحركة للانتقال السريع قد تكون قيد التشغيل. تبقى الكاميرا في مكانها أثناء عرض الصورة المتحركة، ولا تنتقل بسرعة إلى نقطة النهاية. الطريقة غير متزامنة لأنّه لا يمكن بدء الصور المتحركة أو إيقافها إلا بعد تحميل الحد الأدنى من الخريطة. تُعرَض الطريقة بعد توقف الصورة المتحركة.

الفعاليات
`gmp-animationend`	`function(animationEndEvent)` الوسيطات: `animationEndEvent`: `Event` يتمّ تشغيل هذا الحدث عند انتهاء التأثير المتحرّك للطيران. يتم تصعيد هذا الحدث من خلال شجرة نموذج DOM.
`gmp-centerchange`	`function(centerChangeEvent)` الوسيطات: `centerChangeEvent`: `Event` يتم تشغيل هذا الحدث عند تغيير خاصية center في Map3DElement.
`gmp-click`	`function(clickEvent)` الوسيطات: `clickEvent`: `LocationClickEvent\|PlaceClickEvent` يتم تنشيط هذا الحدث عند النقر على العنصر `Map3DElement`.
`gmp-headingchange`	`function(headingChangeEvent)` الوسيطات: `headingChangeEvent`: `Event` يتم تشغيل هذا الحدث عند تغيير سمة heading في Map3DElement.
`gmp-rangechange`	`function(rangeChangeEvent)` الوسيطات: `rangeChangeEvent`: `Event` يتم تشغيل هذا الحدث عند تغيير سمة النطاق في Map3DElement.
`gmp-rollchange`	`function(rollChangeEvent)` الوسيطات: `rollChangeEvent`: `Event` يتم تشغيل هذا الحدث عند تغيير خاصية Roll في Map3DElement.
`gmp-steadychange`	`function(steadyChangeEvent)` الوسيطات: `steadyChangeEvent`: `SteadyChangeEvent` يتم تشغيل هذا الحدث عند تغيُّر الحالة الثابتة لـ `Map3DElement`.
`gmp-tiltchange`	`function(tiltChangeEvent)` الوسيطات: `tiltChangeEvent`: `Event` يتم تشغيل هذا الحدث عند تغيير سمة الميل في Map3DElement.

واجهة Map3DElementOptions

google.maps.maps3d.Map3DElementOptions واجهة

عنصر Map3DElementOptions المستخدَم لتحديد السمات التي يمكن ضبطها على Map3DElement

الخصائص
`bounds optional`	النوع: `LatLngBounds\|LatLngBoundsLiteral optional` يمكنك الاطّلاع على `Map3DElement.bounds`.
`center optional`	النوع: `LatLngAltitude\|LatLngAltitudeLiteral optional` يمكنك الاطّلاع على `Map3DElement.center`.
`defaultLabelsDisabled optional`	النوع: `boolean optional` يمكنك الاطّلاع على `Map3DElement.defaultLabelsDisabled`.
`defaultUIDisabled optional`	النوع: `boolean optional` يمكنك الاطّلاع على `Map3DElement.defaultUIDisabled`.
`heading optional`	النوع: `number optional` يمكنك الاطّلاع على `Map3DElement.heading`.
`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`.
`range optional`	النوع: `number optional` يمكنك الاطّلاع على `Map3DElement.range`.
`roll optional`	النوع: `number optional` يمكنك الاطّلاع على `Map3DElement.roll`.
`tilt optional`	النوع: `number optional` يمكنك الاطّلاع على `Map3DElement.tilt`.

FlyAroundAnimationOptions

google.maps.maps3d.FlyAroundAnimationOptions واجهة

خيارات تخصيص تأثير FlyCameraAround

الخصائص
`camera`	النوع: `CameraOptions` النقطة المركزية التي يجب أن تنظر إليها الكاميرا أثناء عرض الصورة المتحركة للتجوّل. يُرجى العلم أنّ عنوان الخريطة سيتغيّر عندما تدور الكاميرا حول هذه النقطة المركزية.
`durationMillis optional`	النوع: `number optional` مدة الصورة المتحركة بالمللي ثانية هذه هي المدة الكاملة للحركة، وليس مدة دورة واحدة.
`rounds optional`	النوع: `number optional` عدد الجولات التي يتم الدوران حول المركز فيها خلال المدة المحدّدة وهذا يتحكم في السرعة العامة للدوران. سيؤدي إدخال رقم سالب إلى تدوير الكاميرا عكس اتجاه عقارب الساعة بدلاً من الاتجاه التلقائي في اتجاه عقارب الساعة.

FlyToAnimationOptions

google.maps.maps3d.FlyToAnimationOptions واجهة

خيارات التخصيص لتأثير FlyCameraTo

الخصائص
`endCamera`	النوع: `CameraOptions` الموقع الذي يجب أن تشير إليه الكاميرا في نهاية الصورة المتحركة
`durationMillis optional`	النوع: `number optional` مدة الصورة المتحركة بالمللي ثانية سيؤدي ضبط المدة على 0 إلى نقل الكاميرا مباشرةً إلى موضع النهاية.

واجهة CameraOptions

google.maps.maps3d.CameraOptions واجهة

عنصر CameraOptions المستخدَم لتحديد السمات التي يمكن ضبطها على عنصر كاميرا يمكن أن يكون عنصر الكاميرا أيّ شيء يتضمّن موضع كاميرا، مثل حالة الخريطة الحالية أو حالة متحركة مطلوبة في المستقبل.

الخصائص
`center optional`	النوع: `LatLngAltitude\|LatLngAltitudeLiteral 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 class

يتم إنشاء هذا الحدث من خلال مراقبة حالة ثابتة من Map3DElement. يتم تصعيد هذا الحدث من خلال شجرة نموذج DOM.

يمتدّ هذا الصف إلى Event.

يمكنك الوصول إليه من خلال الاتصال بالرقم const {SteadyChangeEvent} = await google.maps.importLibrary("maps3d"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.

الخصائص
`isSteady`	النوع: `boolean` يشير إلى ما إذا كان عنصر Map3DElement ثابتًا (أي اكتمال كل عمليات التقديم للمشهد الحالي) أم لا.

LocationClickEvent class

google.maps.maps3d.LocationClickEvent class

يتم إنشاء هذا الحدث من خلال النقر على Map3DElement.

يمتدّ هذا الصف إلى Event.

يمكنك الوصول إليه من خلال الاتصال بالرقم const {LocationClickEvent} = await google.maps.importLibrary("maps3d"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.

الخصائص
`position`	النوع: `LatLngAltitude optional` خط العرض/خط الطول/الارتفاع الذي كان أسفل المؤشر عند وقوع الحدث يُرجى العِلم أنّه في المستويات الأكثر شمولاً، سيتم عرض بيانات أقل دقة. وقد يتم أيضًا عرض ارتفاع قاع البحر لقيمة الارتفاع عند النقر على سطح الماء من مواضع أعلى للكاميرا. يتم تصعيد هذا الحدث من خلال شجرة نموذج DOM.

الخصائص

position

النوع: LatLngAltitude optional

خط العرض/خط الطول/الارتفاع الذي كان أسفل المؤشر عند وقوع الحدث يُرجى العِلم أنّه في المستويات الأكثر شمولاً، سيتم عرض بيانات أقل دقة. وقد يتم أيضًا عرض ارتفاع قاع البحر لقيمة الارتفاع عند النقر على سطح الماء من مواضع أعلى للكاميرا. يتم تصعيد هذا الحدث من خلال شجرة نموذج DOM.

فئة PlaceClickEvent

google.maps.maps3d.PlaceClickEvent class

يتم إنشاء هذا الحدث من خلال النقر على Map3DElement.

يمتدّ هذا الصف إلى LocationClickEvent.

يمكنك الوصول إليه من خلال الاتصال بالرقم const {PlaceClickEvent} = await google.maps.importLibrary("maps3d"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.

الخصائص
`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.

فئة Marker3DElement

google.maps.maps3d.Marker3DElement class

تعرِض هذه السمة موضعًا على خريطة ثلاثية الأبعاد. يُرجى العِلم أنّه يجب ضبط 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"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.

الشركة المصنِّعة
`Marker3DElement`	`Marker3DElement([options])` المَعلمات: `options`: `Marker3DElementOptions optional` تنشئ هذه الدالة `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`	النوع: `LatLngLiteral\|LatLngAltitude\|LatLngAltitudeLiteral optional` الموقع الجغرافي لطرف العلامة يتم تجاهل الارتفاع في أوضاع معيّنة، وبالتالي فهو اختياري.
`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` في عنصر `<template>` قبل تعيينها إلى الفتحة التلقائية لعنصر `Marker3DElement`. تتم حاليًا تحويل الصور ورسوم SVG إلى صور نقطية قبل عرضها في المشهد الثلاثي الأبعاد، لذا لن يتم تطبيق رمز HTML المخصّص المضمّن في فئات SVG أو CSS التي تمت إضافتها إلى الصور، وقد لا يظهر عند عرض العلامات على الشاشة.

الماكينات الشقبية

default

سيتم وضع أي عناصر مخصّصة تمت إضافتها مباشرةً إلى Marker3DElement، ولكن سيتم استخدام أنواع العناصر HTMLImageElement وSVGElement وPinElement فقط لرسم العلامات، وسيتم تجاهل العناصر الأخرى. يجب تضمين
HTMLImageElement وSVGElement في عنصر <template> قبل تعيينها إلى الفتحة التلقائية لعنصر Marker3DElement.

تتم حاليًا تحويل الصور ورسوم 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 واجهة

عنصر 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`	النوع: `LatLngLiteral\|LatLngAltitude\|LatLngAltitudeLiteral optional` يمكنك الاطّلاع على `Marker3DElement.position`.
`sizePreserved optional`	النوع: `boolean optional` يمكنك الاطّلاع على `Marker3DElement.sizePreserved`.
`zIndex optional`	النوع: `number optional` يمكنك الاطّلاع على `Marker3DElement.zIndex`.

فئة Marker3DInteractiveElement

google.maps.maps3d.Marker3DInteractiveElement class

تعرِض هذه السمة موضعًا على خريطة ثلاثية الأبعاد. يُرجى العِلم أنّه يجب ضبط position لكي يظهر Marker3DInteractiveElement. على عكس Marker3DElement، يتلقّى Marker3DInteractiveElement حدث gmp-click.

العنصر المخصّص:
<gmp-marker-3d-interactive></gmp-marker-3d-interactive>

يمتدّ هذا الصف إلى Marker3DElement.

تنفّذ هذه الفئة Marker3DInteractiveElementOptions.

يمكنك الوصول إليه من خلال الاتصال بالرقم const {Marker3DInteractiveElement} = await google.maps.importLibrary("maps3d"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.

الشركة المصنِّعة
`Marker3DInteractiveElement`	`Marker3DInteractiveElement([options])` المَعلمات: `options`: `Marker3DInteractiveElementOptions optional` تنشئ هذه الدالة `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.

الطُرق

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` يتم تنشيط هذا الحدث عند النقر على العنصر `Marker3DInteractiveElement`.

واجهة Marker3DInteractiveElementOptions

google.maps.maps3d.Marker3DInteractiveElementOptions واجهة

عنصر Marker3DInteractiveElementOptions المستخدَم لتحديد السمات التي يمكن ضبطها على Marker3DInteractiveElement

تمتد هذه الواجهة Marker3DElementOptions.

الخصائص
مُكتسَبة: `altitudeMode`، `collisionBehavior`، `drawsWhenOccluded`، `extruded`، `label`، `position`، `sizePreserved`، `zIndex`

Model3DElement class

google.maps.maps3d.Model3DElement class

تصميم ثلاثي الأبعاد يسمح بعرض نماذج glTF يُرجى العِلم أنّه يجب ضبط position وsrc لعرض Model3DElement.

يجب أن تكون السمات الأساسية لنظام PBR في glTF متوافقة. لا تتوفّر حاليًا أي إضافات أو خصائص إضافات.

العنصر المخصّص:
<gmp-model-3d altitude-mode="absolute" src="src"></gmp-model-3d>

يمتدّ هذا الصف إلى HTMLElement.

تنفّذ هذه الفئة Model3DElementOptions.

يمكنك الوصول إليه من خلال الاتصال بالرقم const {Model3DElement} = await google.maps.importLibrary("maps3d"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.

الشركة المصنِّعة
`Model3DElement`	`Model3DElement([options])` المَعلمات: `options`: `Model3DElementOptions optional` تنشئ هذه الدالة `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`	النوع: `Orientation3D\|Orientation3DLiteral optional` يصف هذا الحقل عملية تدوير نظام إحداثيات التصميم الثلاثي الأبعاد لتحديد موضع التصميم على الخريطة الثلاثية الأبعاد. يتم تطبيق عمليات الدوران على النموذج بالترتيب التالي: الانحراف والتميل ثم الاتجاه.
`position`	النوع: `LatLngLiteral\|LatLngAltitude\|LatLngAltitudeLiteral optional` تُستخدَم لضبط موضع `Model3DElement`. يتم تجاهل الارتفاع في أوضاع معيّنة، وبالتالي فهو اختياري.
`scale`	النوع: `number\|Vector3D\|Vector3DLiteral optional` القيمة التلقائية: `1` تُحوِّل حجم النموذج على طول المحاور x وy وz في مساحة إحداثيات النموذج.
`src`	النوع: `string\|URL optional` تُحدِّد عنوان URL للتصميم الثلاثي الأبعاد. في الوقت الحالي، يمكن استخدام النماذج بتنسيق `.glb` فقط. سيتم تحليل أي عناوين URL نسبية تستخدم HTTP إلى عناوين URL مطلقة مقابلة لها. يُرجى العلم أنّه إذا كنت تستضيف ملفات نماذج `.glb` على موقع إلكتروني أو خادم مختلف عن موقع تطبيقك الرئيسي أو خادمه، احرص على إعداد رؤوس HTTP الصحيحة لبروتوكول CORS. يتيح ذلك لتطبيقك الوصول بأمان إلى ملفات النماذج من النطاق الآخر. سمة HTML: `<gmp-model-3d src="src"></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 واجهة

عنصر Model3DElementOptions المستخدَم لتحديد السمات التي يمكن ضبطها على Model3DElement

الخصائص
`altitudeMode optional`	النوع: `AltitudeMode optional` يمكنك الاطّلاع على `Model3DElement.altitudeMode`.
`orientation optional`	النوع: `Orientation3D\|Orientation3DLiteral optional` يمكنك الاطّلاع على `Model3DElement.orientation`.
`position optional`	النوع: `LatLngLiteral\|LatLngAltitude\|LatLngAltitudeLiteral optional` يمكنك الاطّلاع على `Model3DElement.position`.
`scale optional`	النوع: `number\|Vector3D\|Vector3DLiteral optional` يمكنك الاطّلاع على `Model3DElement.scale`.
`src optional`	النوع: `string\|URL optional` يمكنك الاطّلاع على `Model3DElement.src`.

فئة Polyline3DElement

google.maps.maps3d.Polyline3DElement class

الخط المتعدّد الأبعاد هو عبارة عن تراكب خطي لمقاطع خط متصلة على خريطة ثلاثية الأبعاد.

العنصر المخصّص:
<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"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.

الشركة المصنِّعة
`Polyline3DElement`	`Polyline3DElement([options])` المَعلمات: `options`: `Polyline3DElementOptions optional` تنشئ هذه الدالة `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`	النوع: `Iterable<LatLngAltitude\|LatLngAltitudeLiteral\|LatLngLiteral> optional` التسلسل المُرتَّب للإحداثيات للخط المتعدّد يتم تجاهل الارتفاع في أوضاع معيّنة، وبالتالي فهو اختياري.
`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>`

الطُرق

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 واجهة

عنصر Polyline3DElementOptions المستخدَم لتحديد السمات التي يمكن ضبطها على Polyline3DElement

الخصائص
`altitudeMode optional`	النوع: `AltitudeMode optional` يمكنك الاطّلاع على `Polyline3DElement.altitudeMode`.
`coordinates optional`	النوع: `Iterable<LatLngAltitude\|LatLngAltitudeLiteral\|LatLngLiteral> 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`.

فئة Polygon3DElement

google.maps.maps3d.Polygon3DElement class

يحدِّد المضلّع الثلاثي الأبعاد (مثل الخط المتعدّد الثلاثي الأبعاد) سلسلة من الإحداثيات المتّصلة في تسلسل منتظم. بالإضافة إلى ذلك، تشكل المضلّعات حلقة مغلقة وتحدّد منطقة مليئة.

العنصر المخصّص:
<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"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.

الشركة المصنِّعة
`Polygon3DElement`	`Polygon3DElement([options])` المَعلمات: `options`: `Polygon3DElementOptions optional` تنشئ هذه الدالة `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`	النوع: `Iterable<Iterable<LatLngAltitude\|LatLngAltitudeLiteral\|LatLngLiteral>> optional` التسلسل المُرتَّب للتنسيقات الجغرافية التي تحدِّد حلقة مغلقة على عكس الخطوط المتعددة، قد يتألّف المضلّع من مسار واحد أو أكثر، ما يؤدي إلى إنشاء عدة قطع داخل المضلّع.
`outerCoordinates`	النوع: `Iterable<LatLngAltitude\|LatLngAltitudeLiteral\|LatLngLiteral> optional` التسلسل المُرتَّب للتنسيقات الجغرافية التي تحدِّد حلقة مغلقة يتم تجاهل الارتفاع في أوضاع معيّنة، وبالتالي فهو اختياري.
`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>`

الطُرق

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.

واجهة 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`	النوع: `Iterable<Iterable<LatLngAltitude\|LatLngAltitudeLiteral>\|Iterable<LatLngLiteral>> optional` يمكنك الاطّلاع على `Polygon3DElement.innerCoordinates`.
`outerCoordinates optional`	النوع: `Iterable<LatLngAltitude\|LatLngAltitudeLiteral\|LatLngLiteral> 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 الثوابت

تُحدِّد كيفية تفسير مكوّنات الارتفاع في الإحداثيات.

يمكنك الوصول إليه من خلال الاتصال بالرقم const {AltitudeMode} = await google.maps.importLibrary("maps3d"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.

الثوابت
`ABSOLUTE`	يسمح بالتعبير عن الأجسام بالنسبة إلى متوسط مستوى سطح البحر. ويعني ذلك أيضًا أنّه في حال تغيّر مستوى تفاصيل التضاريس تحت الجسم، سيظلّ موقعه المطلق كما هو.
`CLAMP_TO_GROUND`	يسمح بعرض الأجسام الموضوعة على الأرض. وستبقى على مستوى سطح الأرض وتتّبع التضاريس بغض النظر عن الارتفاع المقدَّم. إذا كان الجسم فوق مساحة مائية كبيرة، سيتم وضعه على مستوى سطح البحر.
`RELATIVE_TO_GROUND`	يسمح بعرض الأجسام بالنسبة إلى سطح الأرض. إذا تغيّر مستوى تفاصيل التضاريس، سيظلّ موضع الجسم ثابتًا بالنسبة إلى الأرض. فوق المياه، سيتم تفسير الارتفاع كقيمة بالأمتار فوق مستوى سطح البحر.
`RELATIVE_TO_MESH`	يسمح بعرض الأجسام بالنسبة إلى أعلى سطح الأرض والمبنى والمياه. عندما تكون فوق الماء، سيكون ذلك سطح الماء، وعندما تكون فوق التضاريس، سيكون ذلك سطح المبنى (إن توفّر) أو سطح الأرض (في حال عدم توفّر مبانٍ).

3D Maps

Map3DElement class

الشركة المصنِّعة

الخصائص

الطُرق

الفعاليات

واجهة Map3DElementOptions

الخصائص

FlyAroundAnimationOptions

الخصائص

FlyToAnimationOptions

الخصائص

واجهة CameraOptions

الخصائص

فئة SteadyChangeEvent

الخصائص

LocationClickEvent class

الخصائص

فئة PlaceClickEvent

الخصائص

الطُرق

فئة Marker3DElement

الشركة المصنِّعة

الخصائص

الماكينات الشقبية

الطُرق

واجهة Marker3DElementOptions

الخصائص

فئة Marker3DInteractiveElement

الشركة المصنِّعة

الخصائص

الماكينات الشقبية

الطُرق

الفعاليات

واجهة Marker3DInteractiveElementOptions

الخصائص

Model3DElement class

الشركة المصنِّعة

الخصائص

الطُرق

واجهة Model3DElementOptions

الخصائص

فئة Polyline3DElement

الشركة المصنِّعة

الخصائص

الطُرق

واجهة Polyline3DElementOptions

الخصائص

فئة Polygon3DElement

الشركة المصنِّعة

الخصائص

الطُرق

واجهة Polygon3DElementOptions

الخصائص

AltitudeMode الثوابت

الثوابت