إشعار: ستتوفّر قريبًا ميزة جديدة لتصميم الخرائط الأساسية في "منصة خرائط 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 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>`
`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.
`removeEventListener`	ملاحظة: لا تتوفّر هذه الميزة إلا في قناة v=beta. `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-centerchange`	`function(centerChangeEvent)` الوسيطات: `centerChangeEvent`: `CenterChangeEvent` يتم تشغيل هذا الحدث عند تغيير خاصية center في Map3DElement.
`gmp-click`	`function(clickEvent)` الوسيطات: `clickEvent`: `ClickEvent` يتم تنشيط هذا الحدث عند النقر على العنصر `Map3DElement`.
`gmp-headingchange`	`function(headingChangeEvent)` الوسيطات: `headingChangeEvent`: `HeadingChangeEvent` يتم تشغيل هذا الحدث عند تغيير سمة heading في Map3DElement.
`gmp-rangechange`	`function(rangeChangeEvent)` الوسيطات: `rangeChangeEvent`: `RangeChangeEvent` يتم تشغيل هذا الحدث عند تغيير سمة النطاق في Map3DElement.
`gmp-rollchange`	`function(rollChangeEvent)` الوسيطات: `rollChangeEvent`: `RollChangeEvent` يتم تشغيل هذا الحدث عند تغيير خاصية Roll في Map3DElement.
`gmp-steadychange`	`function(steadyChangeEvent)` الوسيطات: `steadyChangeEvent`: `SteadyChangeEvent` يتم تشغيل هذا الحدث عند تغيُّر الحالة الثابتة لـ `Map3DElement`.
`gmp-tiltchange`	`function(tiltChangeEvent)` الوسيطات: `tiltChangeEvent`: `TiltChangeEvent` يتم تشغيل هذا الحدث عند تغيير سمة الميل في 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`.
`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`.

فئة SteadyChangeEvent

google.maps.maps3d.SteadyChangeEvent class

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

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

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

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

ClickEvent class

google.maps.maps3d.ClickEvent class

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

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

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

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

الخصائص

position

النوع: LatLngAltitude optional

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

CenterChangeEvent class

google.maps.maps3d.CenterChangeEvent class

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

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

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

HeadingChangeEvent class

google.maps.maps3d.HeadingChangeEvent class

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

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

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

RangeChangeEvent class

google.maps.maps3d.RangeChangeEvent class

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

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

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

فئة RollChangeEvent

google.maps.maps3d.RollChangeEvent class

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

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

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

فئة TiltChangeEvent

google.maps.maps3d.TiltChangeEvent class

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

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

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

فئة Polyline3DElement

google.maps.maps3d.Polyline3DElement class

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

العنصر المخصّص:
<gmp-polyline-3d altitude-mode="absolute" draws-occluded-segments extruded geodesic outer-color="string" outer-opacity="number" outer-width="number" stroke-color="string" stroke-opacity="number" 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`

الخصائص
`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>`
`outerOpacity`	النوع: `number optional` يجب أن تتراوح قيمة الشفافية الخارجية بين `0.0` و`1.0`. سمة HTML: `<gmp-polyline-3d outer-opacity="number"></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>`
`strokeOpacity`	النوع: `number optional` يجب أن تتراوح قيمة شفافية المخطط بين `0.0` و`1.0`. سمة HTML: `<gmp-polyline-3d stroke-opacity="number"></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`	ملاحظة: لا تتوفّر هذه الميزة إلا في قناة v=beta. `addEventListener(type, listener[, options])` المَعلمات: `type`: `string` سلسلة حسّاسة لحالة الأحرف تمثّل نوع الحدث الذي تريد الاستماع إليه. `listener`: `EventListener\|EventListenerObject` العنصر الذي يتلقّى إشعارًا. يجب أن يكون هذا العنصر دالة أو كائنًا يتضمّن طريقة handleEvent. `options`: `boolean\|AddEventListenerOptions optional` اطّلِع على الخيارات. لا تتيح الأحداث المخصّصة سوى `capture` و`passive`. القيمة المعروضة: `void` تُستخدَم لإعداد دالة سيتمّ استدعاؤها عند إرسال الحدث المحدّد إلى الهدف. راجِع addEventListener.
`removeEventListener`	ملاحظة: لا تتوفّر هذه الميزة إلا في قناة v=beta. `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.

واجهة Polyline3DElementOptions

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

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

الخصائص
`altitudeMode optional`	النوع: `AltitudeMode optional` القيمة التلقائية: `AltitudeMode.ABSOLUTE` يمكنك الاطّلاع على `Polyline3DElement.altitudeMode`.
`coordinates optional`	النوع: `Iterable<LatLngAltitude\|LatLngAltitudeLiteral\|LatLngLiteral> optional` يمكنك الاطّلاع على `Polyline3DElement.coordinates`.
`drawsOccludedSegments optional`	النوع: `boolean optional` القيمة التلقائية: `false` يمكنك الاطّلاع على `Polyline3DElement.drawsOccludedSegments`.
`extruded optional`	النوع: `boolean optional` القيمة التلقائية: `false` يمكنك الاطّلاع على `Polyline3DElement.extruded`.
`geodesic optional`	النوع: `boolean optional` القيمة التلقائية: `false` يمكنك الاطّلاع على `Polyline3DElement.geodesic`.
`outerColor optional`	النوع: `string optional` يمكنك الاطّلاع على `Polyline3DElement.outerColor`.
`outerOpacity optional`	النوع: `number optional` يمكنك الاطّلاع على `Polyline3DElement.outerOpacity`.
`outerWidth optional`	النوع: `number optional` يمكنك الاطّلاع على `Polyline3DElement.outerWidth`.
`strokeColor optional`	النوع: `string optional` يمكنك الاطّلاع على `Polyline3DElement.strokeColor`.
`strokeOpacity optional`	النوع: `number optional` يمكنك الاطّلاع على `Polyline3DElement.strokeOpacity`.
`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" fill-opacity="number" geodesic stroke-color="string" stroke-opacity="number" 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`

الخصائص
`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>`
`fillOpacity`	النوع: `number optional` تعتيم التعبئة بين 0.0 و1.0 سمة HTML: `<gmp-polygon-3d fill-opacity="number"></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>`
`strokeOpacity`	النوع: `number optional` يجب أن تتراوح قيمة شفافية المخطط بين `0.0` و`1.0`. سمة HTML: `<gmp-polygon-3d stroke-opacity="number"></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`	ملاحظة: لا تتوفّر هذه الميزة إلا في قناة v=beta. `addEventListener(type, listener[, options])` المَعلمات: `type`: `string` سلسلة حسّاسة لحالة الأحرف تمثّل نوع الحدث الذي تريد الاستماع إليه. `listener`: `EventListener\|EventListenerObject` العنصر الذي يتلقّى إشعارًا. يجب أن يكون هذا العنصر دالة أو كائنًا يتضمّن طريقة handleEvent. `options`: `boolean\|AddEventListenerOptions optional` اطّلِع على الخيارات. لا تتيح الأحداث المخصّصة سوى `capture` و`passive`. القيمة المعروضة: `void` تُستخدَم لإعداد دالة سيتمّ استدعاؤها عند إرسال الحدث المحدّد إلى الهدف. راجِع addEventListener.
`removeEventListener`	ملاحظة: لا تتوفّر هذه الميزة إلا في قناة v=beta. `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.

واجهة Polygon3DElementOptions

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

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

الخصائص
`altitudeMode optional`	النوع: `AltitudeMode optional` القيمة التلقائية: `AltitudeMode.ABSOLUTE` يمكنك الاطّلاع على `Polygon3DElement.altitudeMode`.
`drawsOccludedSegments optional`	النوع: `boolean optional` القيمة التلقائية: `false` يمكنك الاطّلاع على `Polygon3DElement.drawsOccludedSegments`.
`extruded optional`	النوع: `boolean optional` القيمة التلقائية: `false` يمكنك الاطّلاع على `Polygon3DElement.extruded`.
`fillColor optional`	النوع: `string optional` يمكنك الاطّلاع على `Polygon3DElement.fillColor`.
`fillOpacity optional`	النوع: `number optional` يمكنك الاطّلاع على `Polygon3DElement.fillOpacity`.
`geodesic optional`	النوع: `boolean optional` القيمة التلقائية: `false` يمكنك الاطّلاع على `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`.
`strokeOpacity optional`	النوع: `number optional` يمكنك الاطّلاع على `Polygon3DElement.strokeOpacity`.
`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

الخصائص

فئة SteadyChangeEvent

الخصائص

ClickEvent class

الخصائص

CenterChangeEvent class

HeadingChangeEvent class

RangeChangeEvent class

فئة RollChangeEvent

فئة TiltChangeEvent

فئة Polyline3DElement

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

الخصائص

الطُرق

واجهة Polyline3DElementOptions

الخصائص

فئة Polygon3DElement

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

الخصائص

الطُرق

واجهة Polygon3DElementOptions

الخصائص

AltitudeMode الثوابت

الثوابت