3D Maps

فئة Map3DElement

google.maps.maps3d.Map3DElement صف

‫Map3DElement هي واجهة HTML لعرض الخريطة الثلاثية الأبعاد. يُرجى العِلم أنّه يجب ضبط mode لكي تبدأ الخريطة الثلاثية الأبعاد في العرض.

العنصر المخصّص:
<gmp-map-3d center="lat,lng,altitude" default-ui-disabled heading="number" max-altitude="number" max-heading="number" max-tilt="number" min-altitude="number" min-heading="number" min-tilt="number" mode="hybrid" range="number" roll="number" tilt="number"></gmp-map-3d>

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

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

يمكنك الوصول إلى الدعم من خلال الاتصال بالرقم const {Map3DElement} = await google.maps.importLibrary("maps3d").
اطّلِع على المكتبات في Maps JavaScript API.

Map3DElement
Map3DElement([options])
المَعلمات: 
bounds
النوع:  LatLngBounds|LatLngBoundsLiteral optional
عند ضبط هذا الخيار، يتم حصر موضع الكاميرا ضمن حدود خطوط الطول والعرض المحدّدة. يُرجى العِلم أنّه سيتم عرض العناصر خارج الحدود. يمكن أن تقيّد الحدود كلاً من خط الطول وخط العرض، أو يمكن أن تقيّد أحدهما فقط. بالنسبة إلى الحدود التي تتضمّن خطوط العرض فقط، استخدِم خطَّي الطول الغربي والشرقي -180 و180 على التوالي. بالنسبة إلى الحدود التي تتضمّن خطوط الطول فقط، استخدِم خطَّي العرض الشمالي والجنوبي 90 و-90 على التوالي.
center
النوع:  LatLngAltitude|LatLngAltitudeLiteral optional
وسط الخريطة، ويتم عرضه على شكل LatLngAltitude، حيث يكون الارتفاع بالأمتار فوق مستوى سطح الأرض. يُرجى العِلم أنّ هذا الموقع الجغرافي ليس بالضرورة هو المكان الذي تقع فيه الكاميرا، لأنّ الحقل range يؤثّر في المسافة بين الكاميرا ومركز الخريطة. إذا لم يتم ضبطها، تكون القيمة التلقائية {lat: 0, lng: 0, altitude: 63170000}. ‫63170000 متر هو الحد الأقصى للارتفاع المسموح به (نصف قطر الأرض مضروبًا في 10).
سمة HTML:
  • <gmp-map-3d center="lat,lng,altitude"></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>
mode
النوع:  MapMode optional
تحدّد هذه السمة الوضع الذي يجب عرض الخريطة به. إذا لم يتم ضبطها، لن يتم عرض الخريطة.
سمة HTML:
  • <gmp-map-3d mode="hybrid"></gmp-map-3d>
  • <gmp-map-3d mode="satellite"></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>
BetaaddEventListener
addEventListener(type, listener[, options])
المَعلمات: 
  • typestring سلسلة حساسة لحالة الأحرف تمثّل نوع الحدث الذي سيتم الاستماع إليه.
  • listenerEventListener|EventListenerObject العنصر الذي يتلقّى إشعارًا. يجب أن يكون هذا الإدخال دالة أو عنصرًا يتضمّن طريقة handleEvent
  • optionsboolean|AddEventListenerOptions optional الاطّلاع على الخيارات لا تتيح الأحداث المخصّصة سوى capture وpassive.
قيمة العائد:  void
تُعدّ هذه السمة دالة سيتم استدعاؤها كلّما تمّ تسليم الحدث المحدّد إلى الهدف. اطّلِع على addEventListener.
flyCameraAround
flyCameraAround(options)
المَعلمات: 
القيمة المعروضة:  لا شيء
تدور هذه الطريقة بالكاميرا حول موقع جغرافي محدّد لمدة زمنية محدّدة، ما يؤدي إلى إجراء عدد محدّد من اللقطات في ذلك الوقت.

بشكلٍ تلقائي، تدور الكاميرا في اتجاه عقارب الساعة. إذا تم إدخال عدد سالب للجولات، ستدور الكاميرا في اتجاه عكس عقارب الساعة بدلاً من ذلك.

الطريقة غير متزامنة لأنّه لا يمكن بدء الرسوم المتحركة إلا بعد تحميل الحد الأدنى من الخريطة. تعرض الطريقة النتيجة بعد بدء الصورة المتحركة.

إذا كان عدد الجولات صفرًا، لن يتم إجراء أي دوران، وستكتمل الحركة فور بدئها.
flyCameraTo
flyCameraTo(options)
المَعلمات: 
القيمة المعروضة:  لا شيء
تنقل هذه الطريقة الكاميرا بشكلٍ مكافئ من الموقع الجغرافي الحالي إلى موقع جغرافي نهائي محدّد خلال مدة زمنية محدّدة.

الطريقة غير متزامنة لأنّه لا يمكن بدء الرسوم المتحركة إلا بعد تحميل الحد الأدنى من الخريطة. تعرض الطريقة النتيجة بعد بدء الصورة المتحركة.
BetaremoveEventListener
removeEventListener(type, listener[, options])
المَعلمات: 
  • typestring سلسلة تحدّد نوع الحدث الذي ستتم إزالة معالج الأحداث الخاص به.
  • listenerEventListener|EventListenerObject أداة معالجة الأحداث التي سيتم إزالتها من هدف الحدث.
  • optionsboolean|EventListenerOptions optional الاطّلاع على الخيارات
قيمة العائد:  void
تزيل هذه الطريقة أداة معالجة الأحداث التي تم تسجيلها سابقًا باستخدام addEventListener من العنصر المستهدف. راجِع removeEventListener.
stopCameraAnimation
stopCameraAnimation()
المَعلمات:  بدون
القيمة المعروضة:  لا شيء
توقف هذه الطريقة أي رسوم متحركة قد تكون قيد التشغيل. تبقى الكاميرا في مكانها في منتصف الصورة المتحركة، ولا تنتقل إلى نقطة النهاية.

الطريقة غير متزامنة لأنّه لا يمكن بدء الصور المتحركة أو إيقافها إلا بعد أن تحمّل الخريطة حدًا أدنى من البيانات. لا تعرض الطريقة أي قيمة إلا بعد توقّف الحركة.
gmp-animationend
function(animationEndEvent)
الوسيطات: 
  • animationEndEventEvent
يتم إطلاق هذا الحدث عند انتهاء حركة التحليق. يتم تمرير هذا الحدث إلى أعلى شجرة نموذج العناصر في المستند.
gmp-centerchange
function(centerChangeEvent)
الوسيطات: 
  • centerChangeEventEvent
يتم تنشيط هذا الحدث عند تغيير خاصية مركز Map3DElement.
gmp-click
function(clickEvent)
الوسيطات: 
يتم تنشيط هذا الحدث عند النقر على العنصر Map3DElement.
gmp-headingchange
function(headingChangeEvent)
الوسيطات: 
  • headingChangeEventEvent
يتم تنشيط هذا الحدث عند تغيير سمة العنوان في Map3DElement.
gmp-rangechange
function(rangeChangeEvent)
الوسيطات: 
  • rangeChangeEventEvent
يتم تنشيط هذا الحدث عند تغيير سمة النطاق في Map3DElement.
gmp-rollchange
function(rollChangeEvent)
الوسيطات: 
  • rollChangeEventEvent
يتم تنشيط هذا الحدث عند تغيير السمة "لفة" في Map3DElement.
gmp-steadychange
function(steadyChangeEvent)
الوسيطات: 
يتم تنشيط هذا الحدث عند تغيُّر الحالة الثابتة لـ Map3DElement.
gmp-tiltchange
function(tiltChangeEvent)
الوسيطات: 
  • tiltChangeEventEvent
يتم تنشيط هذا الحدث عند تغيير سمة ميل Map3DElement.

واجهة Map3DElementOptions

google.maps.maps3d.Map3DElementOptions interface

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

bounds optional
النوع:  LatLngBounds|LatLngBoundsLiteral optional
يمكنك الاطّلاع على Map3DElement.bounds.
center optional
النوع:  LatLngAltitude|LatLngAltitudeLiteral optional
يمكنك الاطّلاع على Map3DElement.center.
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.
mode optional
النوع:  MapMode optional
يمكنك الاطّلاع على Map3DElement.mode.
range optional
النوع:  number optional
يمكنك الاطّلاع على Map3DElement.range.
roll optional
النوع:  number optional
يمكنك الاطّلاع على Map3DElement.roll.
tilt optional
النوع:  number optional
يمكنك الاطّلاع على Map3DElement.tilt.

ثوابت MapMode

google.maps.maps3d.MapMode الثوابت

تحدّد هذه السمة الوضع الذي يجب عرض الخريطة به.

يمكنك الوصول إلى الدعم من خلال الاتصال بالرقم const {MapMode} = await google.maps.importLibrary("maps3d").
اطّلِع على المكتبات في Maps JavaScript API.

HYBRID يعرض وضع الخريطة هذا طبقة شفافة من الشوارع الرئيسية على صور القمر الصناعي أو الصور الواقعية.
SATELLITE يعرض وضع الخريطة هذا صورًا من القمر الصناعي أو صورًا واقعية عند توفّرها.

واجهة FlyAroundAnimationOptions

google.maps.maps3d.FlyAroundAnimationOptions interface

خيارات تخصيص المؤثرات الحركية FlyCameraAround

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

FlyToAnimationOptions interface

google.maps.maps3d.FlyToAnimationOptions interface

خيارات التخصيص للرسوم المتحركة FlyCameraTo

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

واجهة CameraOptions

google.maps.maps3d.CameraOptions interface

عنصر 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 صف

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

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

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

isSteady
النوع:  boolean
تشير هذه السمة إلى ما إذا كان Map3DElement ثابتًا (أي اكتملت عملية العرض للمشهد الحالي) أم لا.

فئة LocationClickEvent

google.maps.maps3d.LocationClickEvent صف

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

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

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

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

فئة PlaceClickEvent

google.maps.maps3d.PlaceClickEvent صف

يتم إنشاء هذا الحدث من خلال النقر على رمز مكان على Map3DElement. لمنع ظهور النافذة المنبثقة التلقائية، استدعِ الطريقة preventDefault() في هذا الحدث لمنع معالجتها بواسطة Map3DElement.

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

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

placeId
النوع:  string
معرّف المكان الخاص بعنصر الخريطة.
موروثة: position
fetchPlace
fetchPlace()
المَعلمات:  بدون
قيمة العائد:  Promise<Place>
يجلب Place لمعرّف المكان هذا. في عنصر Place الناتج، ستتم تعبئة السمة id. يمكن طلب حقول إضافية لاحقًا من خلال Place.fetchFields()، وذلك وفقًا لعملية التفعيل والفوترة العادية في Places API. يتم رفض الوعد إذا حدث خطأ أثناء جلب Place.

فئة Marker3DElement

google.maps.maps3d.Marker3DElement صف

تعرض هذه السمة موضعًا على خريطة ثلاثية الأبعاد. يُرجى العِلم أنّه يجب ضبط position لكي يتم عرض Marker3DElement.

العنصر المخصّص:
<gmp-marker-3d altitude-mode="absolute" collision-behavior="required" draws-when-occluded extruded label="string" position="lat,lng" size-preserved z-index="number"></gmp-marker-3d>

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

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

يمكنك الوصول إلى الدعم من خلال الاتصال بالرقم const {Marker3DElement} = await google.maps.importLibrary("maps3d").
اطّلِع على المكتبات في Maps JavaScript API.

Marker3DElement
Marker3DElement([options])
المَعلمات: 
تنشئ هذه الدالة Marker3DElement مع الخيارات المحدّدة.
altitudeMode
النوع:  AltitudeMode optional
القيمة التلقائية: 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
تمثّل هذه السمة موقع طرف العلامة. يتم تجاهل الارتفاع في أوضاع معيّنة، وبالتالي يكون اختياريًا.
سمة HTML:
  • <gmp-marker-3d position="lat,lng"></gmp-marker-3d>
  • <gmp-marker-3d position="lat,lng,altitude"></gmp-marker-3d>
sizePreserved
النوع:  boolean optional
القيمة التلقائية: false
تحدّد هذه السمة ما إذا كان يجب الحفاظ على حجم هذا العلامة أو لا بغض النظر عن المسافة من الكاميرا. يتم تلقائيًا تغيير حجم العلامة استنادًا إلى المسافة من الكاميرا أو الميل.
سمة HTML:
  • <gmp-marker-3d size-preserved></gmp-marker-3d>
zIndex
النوع:  number optional
تمثّل هذه السمة ترتيب العرض مقارنةً بالعلامات الأخرى.
سمة HTML:
  • <gmp-marker-3d z-index="number"></gmp-marker-3d>
default
سيتم إدراج أي عناصر مخصّصة تتم إضافتها مباشرةً إلى Marker3DElement، ولكن سيتم استخدام العناصر من الأنواع HTMLImageElement وSVGElement وPinElement فقط لرسم العلامات، وسيتم تجاهل العناصر الأخرى. يجب تضمين
وHTMLImageElement وSVGElement في العنصر <template> قبل تعيينها إلى الموضع التلقائي Marker3DElement.

يتم حاليًا تحويل الصور وملفات SVG إلى تنسيق نقطي قبل عرضها في المشهد الثلاثي الأبعاد، لذا لن يتم تطبيق رموز HTML المخصّصة المضمّنة في ملفات SVG أو فئات CSS المُضافة إلى الصور، وقد لا تظهر عند عرض العلامات على الشاشة.
BetaaddEventListener
addEventListener(type, listener[, options])
المَعلمات: 
  • typestring سلسلة حساسة لحالة الأحرف تمثّل نوع الحدث الذي سيتم الاستماع إليه.
  • listenerEventListener|EventListenerObject العنصر الذي يتلقّى إشعارًا. يجب أن يكون هذا الإدخال دالة أو عنصرًا يتضمّن طريقة handleEvent
  • optionsboolean|AddEventListenerOptions optional الاطّلاع على الخيارات لا تتيح الأحداث المخصّصة سوى capture وpassive.
قيمة العائد:  void
تُعدّ هذه السمة دالة سيتم استدعاؤها كلّما تمّ تسليم الحدث المحدّد إلى الهدف. اطّلِع على addEventListener.
BetaremoveEventListener
removeEventListener(type, listener[, options])
المَعلمات: 
  • typestring سلسلة تحدّد نوع الحدث الذي ستتم إزالة معالج الأحداث الخاص به.
  • listenerEventListener|EventListenerObject أداة معالجة الأحداث التي سيتم إزالتها من هدف الحدث.
  • optionsboolean|EventListenerOptions optional الاطّلاع على الخيارات
قيمة العائد:  void
تزيل هذه الطريقة أداة معالجة الأحداث التي تم تسجيلها سابقًا باستخدام addEventListener من العنصر المستهدف. راجِع removeEventListener.

واجهة Marker3DElementOptions

google.maps.maps3d.Marker3DElementOptions interface

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

فئة Marker3DInteractiveElement

google.maps.maps3d.Marker3DInteractiveElement صف

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

العنصر المخصّص:
<gmp-marker-3d-interactive gmp-popover-target="popover-id" title="string"></gmp-marker-3d-interactive>

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

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

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

Marker3DInteractiveElement
Marker3DInteractiveElement([options])
المَعلمات: 
تنشئ هذه الدالة Marker3DInteractiveElement مع الخيارات المحدّدة.
gmpPopoverTargetElement
النوع:  PopoverElement optional
عند ضبط هذه السمة، سيتم فتح عنصر النافذة المنبثقة عند النقر على هذا العلامة.
سمة HTML:
  • <gmp-marker-3d-interactive gmp-popover-target="popover-id"></gmp-marker-3d-interactive>
title
النوع:  string
نص التمرير في حال توفّره، سيتمّ إضافة نص تسهيل الاستخدام (مثلاً، لاستخدامه مع برامج قراءة الشاشة) إلى Marker3DInteractiveElement مع القيمة المقدَّمة.
سمة HTML:
  • <gmp-marker-3d-interactive title="string"></gmp-marker-3d-interactive>
موروثة: altitudeMode, collisionBehavior, drawsWhenOccluded, extruded, label, position, sizePreserved, zIndex
default
سيتم إدراج أي عناصر مخصّصة تتم إضافتها مباشرةً إلى Marker3DInteractiveElement، ولكن سيتم استخدام العناصر من نوع PinElement فقط لرسم العلامات، وسيتم تجاهل العناصر الأخرى.
addEventListener
addEventListener(type, listener[, options])
المَعلمات: 
  • typestring سلسلة حساسة لحالة الأحرف تمثّل نوع الحدث الذي سيتم الاستماع إليه.
  • listenerEventListener|EventListenerObject العنصر الذي يتلقّى إشعارًا. يجب أن يكون هذا الإدخال دالة أو عنصرًا يتضمّن طريقة handleEvent
  • optionsboolean|AddEventListenerOptions optional الاطّلاع على الخيارات لا تتيح الأحداث المخصّصة سوى capture وpassive.
قيمة العائد:  void
تُعدّ هذه السمة دالة سيتم استدعاؤها كلّما تمّ تسليم الحدث المحدّد إلى الهدف. راجِع addEventListener
removeEventListener
removeEventListener(type, listener[, options])
المَعلمات: 
  • typestring سلسلة تحدّد نوع الحدث الذي ستتم إزالة معالج الأحداث الخاص به.
  • listenerEventListener|EventListenerObject أداة معالجة الأحداث التي سيتم إزالتها من هدف الحدث.
  • optionsboolean|EventListenerOptions optional عرض الخيارات
قيمة العائد:  void
تزيل هذه الطريقة أداة معالجة الأحداث التي تم تسجيلها سابقًا باستخدام addEventListener من العنصر المستهدف. راجِع removeEventListener
gmp-click
function(clickEvent)
الوسيطات: 
يتم تنشيط هذا الحدث عند النقر على العنصر Marker3DInteractiveElement.

واجهة Marker3DInteractiveElementOptions

google.maps.maps3d.Marker3DInteractiveElementOptions interface

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

توسّع هذه الواجهة Marker3DElementOptions.

gmpPopoverTargetElement optional
النوع:  PopoverElement optional
يمكنك الاطّلاع على Marker3DInteractiveElement.gmpPopoverTargetElement.
title optional
النوع:  string optional
يمكنك الاطّلاع على Marker3DInteractiveElement.title.
موروثة: altitudeMode, collisionBehavior, drawsWhenOccluded, extruded, label, position, sizePreserved, zIndex

فئة Model3DElement

google.maps.maps3d.Model3DElement صف

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

gLTF PBR متوافقة. لا تتوفّر حاليًا أي إضافات أو خصائص إضافات.

العنصر المخصّص:
<gmp-model-3d altitude-mode="absolute" orientation="heading,tilt,roll" position="lat,lng" scale="number" src="url"></gmp-model-3d>

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

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

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

Model3DElement
Model3DElement([options])
المَعلمات: 
تنشئ هذه الدالة 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
تصف هذه السمة دوران نظام إحداثيات نموذج ثلاثي الأبعاد لتحديد موضع النموذج على "الخريطة الثلاثية الأبعاد".

يتم تطبيق عمليات التدوير على النموذج بالترتيب التالي: التدوير حول المحور الأفقي، ثم الإمالة، ثم الاتجاه.
سمة HTML:
  • <gmp-model-3d orientation="heading,tilt,roll"></gmp-model-3d>
position
تُستخدَم لضبط موضع Model3DElement. يتم تجاهل الارتفاع في أوضاع معيّنة، وبالتالي يكون اختياريًا.
سمة HTML:
  • <gmp-model-3d position="lat,lng"></gmp-model-3d>
  • <gmp-model-3d position="lat,lng,altitude"></gmp-model-3d>
scale
النوع:  number|Vector3D|Vector3DLiteral optional
القيمة التلقائية: 1
تغيير حجم النموذج على طول المحاور x وy وz في مساحة إحداثيات النموذج
سمة HTML:
  • <gmp-model-3d scale="number"></gmp-model-3d>
  • <gmp-model-3d scale="x,y,z"></gmp-model-3d>
src
النوع:  string|URL optional
تحدّد هذه السمة عنوان URL للتصميم الثلاثي الأبعاد. في الوقت الحالي، يمكن استخدام التصاميم التي تكون بتنسيق .glb فقط.

سيتم تحويل أي عناوين URL نسبية تستخدم HTTP إلى عناوين URL كاملة مقابلة.

يُرجى العِلم أنّه إذا كنت تستضيف ملفات نموذج .glb على موقع إلكتروني أو خادم مختلف عن تطبيقك الرئيسي، احرص على إعداد عناوين CORS HTTP الصحيحة. يتيح ذلك لتطبيقك الوصول بأمان إلى ملفات النموذج من النطاق الآخر.
سمة HTML:
  • <gmp-model-3d src="url"></gmp-model-3d>
BetaaddEventListener
addEventListener(type, listener[, options])
المَعلمات: 
  • typestring سلسلة حساسة لحالة الأحرف تمثّل نوع الحدث الذي سيتم الاستماع إليه.
  • listenerEventListener|EventListenerObject العنصر الذي يتلقّى إشعارًا. يجب أن يكون هذا الإدخال دالة أو عنصرًا يتضمّن طريقة handleEvent
  • optionsboolean|AddEventListenerOptions optional الاطّلاع على الخيارات لا تتيح الأحداث المخصّصة سوى capture وpassive.
قيمة العائد:  void
تُعدّ هذه السمة دالة سيتم استدعاؤها كلّما تمّ تسليم الحدث المحدّد إلى الهدف. اطّلِع على addEventListener.
BetaremoveEventListener
removeEventListener(type, listener[, options])
المَعلمات: 
  • typestring سلسلة تحدّد نوع الحدث الذي ستتم إزالة معالج الأحداث الخاص به.
  • listenerEventListener|EventListenerObject أداة معالجة الأحداث التي سيتم إزالتها من هدف الحدث.
  • optionsboolean|EventListenerOptions optional الاطّلاع على الخيارات
قيمة العائد:  void
تزيل هذه الطريقة أداة معالجة الأحداث التي تم تسجيلها سابقًا باستخدام addEventListener من العنصر المستهدف. راجِع removeEventListener.

Model3DElementOptions interface

google.maps.maps3d.Model3DElementOptions interface

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

altitudeMode optional
النوع:  AltitudeMode optional
يمكنك الاطّلاع على Model3DElement.altitudeMode.
orientation optional
النوع:  Orientation3D|Orientation3DLiteral optional
يمكنك الاطّلاع على Model3DElement.orientation.
position optional
يمكنك الاطّلاع على Model3DElement.position.
scale optional
النوع:  number|Vector3D|Vector3DLiteral optional
يمكنك الاطّلاع على Model3DElement.scale.
src optional
النوع:  string|URL optional
يمكنك الاطّلاع على Model3DElement.src.

فئة Model3DInteractiveElement

google.maps.maps3d.Model3DInteractiveElement صف

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

gLTF PBR متوافقة. لا تتوفّر حاليًا أي إضافات أو خصائص إضافات.

على عكس Model3DElement، يتلقّى Model3DInteractiveElement حدث gmp-click.

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

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

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

يمكنك الوصول إلى الدعم من خلال الاتصال بالرقم const {Model3DInteractiveElement} = await google.maps.importLibrary("maps3d").
اطّلِع على المكتبات في Maps JavaScript API.

Model3DInteractiveElement
Model3DInteractiveElement([options])
المَعلمات: 
تنشئ هذه الدالة Model3DInteractiveElement مع الخيارات المحدّدة.
موروثة: altitudeMode, orientation, position, scale, src
addEventListener
addEventListener(type, listener[, options])
المَعلمات: 
  • typestring سلسلة حساسة لحالة الأحرف تمثّل نوع الحدث الذي سيتم الاستماع إليه.
  • listenerEventListener|EventListenerObject العنصر الذي يتلقّى إشعارًا. يجب أن يكون هذا الإدخال دالة أو عنصرًا يتضمّن طريقة handleEvent
  • optionsboolean|AddEventListenerOptions optional الاطّلاع على الخيارات لا تتيح الأحداث المخصّصة سوى capture وpassive.
قيمة العائد:  void
تُعدّ هذه السمة دالة سيتم استدعاؤها كلّما تمّ تسليم الحدث المحدّد إلى الهدف. راجِع addEventListener
removeEventListener
removeEventListener(type, listener[, options])
المَعلمات: 
  • typestring سلسلة تحدّد نوع الحدث الذي ستتم إزالة معالج الأحداث الخاص به.
  • listenerEventListener|EventListenerObject أداة معالجة الأحداث التي سيتم إزالتها من هدف الحدث.
  • optionsboolean|EventListenerOptions optional عرض الخيارات
قيمة العائد:  void
تزيل هذه الطريقة أداة معالجة الأحداث التي تم تسجيلها سابقًا باستخدام addEventListener من العنصر المستهدف. راجِع removeEventListener
gmp-click
function(clickEvent)
الوسيطات: 
يتم تنشيط هذا الحدث عند النقر على العنصر Model3DInteractiveElement.

Model3DInteractiveElementOptions interface

google.maps.maps3d.Model3DInteractiveElementOptions interface

يتم استخدام عنصر Model3DInteractiveElementOptions لتحديد الخصائص التي يمكن ضبطها على Model3DInteractiveElement.

توسّع هذه الواجهة Model3DElementOptions.

موروثة: altitudeMode, orientation, position, scale, src

فئة Polyline3DElement

google.maps.maps3d.Polyline3DElement صف

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

العنصر المخصّص:
<gmp-polyline-3d altitude-mode="absolute" draws-occluded-segments extruded geodesic outer-color="string" outer-width="number" stroke-color="string" stroke-width="number" z-index="number"></gmp-polyline-3d>

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

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

يمكنك الوصول إلى الدعم من خلال الاتصال بالرقم const {Polyline3DElement} = await google.maps.importLibrary("maps3d").
اطّلِع على المكتبات في Maps JavaScript API.

Polyline3DElement
Polyline3DElement([options])
المَعلمات: 
تنشئ هذه الدالة Polyline3DElement مع الخيارات المحدّدة.
altitudeMode
النوع:  AltitudeMode optional
القيمة التلقائية: AltitudeMode.CLAMP_TO_GROUND
تحدّد هذه السمة كيفية تفسير مكوّنات الارتفاع في الإحداثيات.
سمة 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
تمثّل هذه السمة التسلسل المرتب للإحداثيات الخاصة بالخط المتعدد. يتم تجاهل الارتفاع في أوضاع معيّنة، وبالتالي يكون اختياريًا.
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>
BetaaddEventListener
addEventListener(type, listener[, options])
المَعلمات: 
  • typestring سلسلة حساسة لحالة الأحرف تمثّل نوع الحدث الذي سيتم الاستماع إليه.
  • listenerEventListener|EventListenerObject العنصر الذي يتلقّى إشعارًا. يجب أن يكون هذا الإدخال دالة أو عنصرًا يتضمّن طريقة handleEvent
  • optionsboolean|AddEventListenerOptions optional الاطّلاع على الخيارات لا تتيح الأحداث المخصّصة سوى capture وpassive.
قيمة العائد:  void
تُعدّ هذه السمة دالة سيتم استدعاؤها كلّما تمّ تسليم الحدث المحدّد إلى الهدف. اطّلِع على addEventListener.
BetaremoveEventListener
removeEventListener(type, listener[, options])
المَعلمات: 
  • typestring سلسلة تحدّد نوع الحدث الذي ستتم إزالة معالج الأحداث الخاص به.
  • listenerEventListener|EventListenerObject أداة معالجة الأحداث التي سيتم إزالتها من هدف الحدث.
  • optionsboolean|EventListenerOptions optional الاطّلاع على الخيارات
قيمة العائد:  void
تزيل هذه الطريقة أداة معالجة الأحداث التي تم تسجيلها سابقًا باستخدام addEventListener من العنصر المستهدف. راجِع removeEventListener.

واجهة Polyline3DElementOptions

google.maps.maps3d.Polyline3DElementOptions interface

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

altitudeMode optional
النوع:  AltitudeMode optional
يمكنك الاطّلاع على Polyline3DElement.altitudeMode.
coordinates 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.

فئة Polyline3DInteractiveElement

google.maps.maps3d.Polyline3DInteractiveElement صف

الخط المتعدد الأبعاد الثلاثي هو طبقة خطية من مقاطع خطوط متصلة على خريطة ثلاثية الأبعاد. على عكس Polyline3DElement، يتلقّى Polyline3DInteractiveElement حدث gmp-click.

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

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

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

يمكنك الوصول إلى الدعم من خلال الاتصال بالرقم const {Polyline3DInteractiveElement} = await google.maps.importLibrary("maps3d").
اطّلِع على المكتبات في Maps JavaScript API.

Polyline3DInteractiveElement
Polyline3DInteractiveElement([options])
المَعلمات: 
تنشئ هذه الدالة Polyline3DInteractiveElement مع الخيارات المحدّدة.
موروثة: altitudeMode, coordinates, drawsOccludedSegments, extruded, geodesic, outerColor, outerWidth, strokeColor, strokeWidth, zIndex
addEventListener
addEventListener(type, listener[, options])
المَعلمات: 
  • typestring سلسلة حساسة لحالة الأحرف تمثّل نوع الحدث الذي سيتم الاستماع إليه.
  • listenerEventListener|EventListenerObject العنصر الذي يتلقّى إشعارًا. يجب أن يكون هذا الإدخال دالة أو عنصرًا يتضمّن طريقة handleEvent
  • optionsboolean|AddEventListenerOptions optional الاطّلاع على الخيارات لا تتيح الأحداث المخصّصة سوى capture وpassive.
قيمة العائد:  void
تُعدّ هذه السمة دالة سيتم استدعاؤها كلّما تمّ تسليم الحدث المحدّد إلى الهدف. راجِع addEventListener
removeEventListener
removeEventListener(type, listener[, options])
المَعلمات: 
  • typestring سلسلة تحدّد نوع الحدث الذي ستتم إزالة معالج الأحداث الخاص به.
  • listenerEventListener|EventListenerObject أداة معالجة الأحداث التي سيتم إزالتها من هدف الحدث.
  • optionsboolean|EventListenerOptions optional عرض الخيارات
قيمة العائد:  void
تزيل هذه الطريقة أداة معالجة الأحداث التي تم تسجيلها سابقًا باستخدام addEventListener من العنصر المستهدف. راجِع removeEventListener
gmp-click
function(clickEvent)
الوسيطات: 
  • clickEventLocationClickEvent سيحتوي عنصر الحدث على الموقع الجغرافي للنقرة (خطوط الطول والعرض والارتفاع).
يتم تنشيط هذا الحدث عند النقر على العنصر Polyline3DInteractiveElement.

Polyline3DInteractiveElementOptions interface

google.maps.maps3d.Polyline3DInteractiveElementOptions interface

عنصر Polyline3DInteractiveElementOptions المستخدَم لتحديد الخصائص التي يمكن ضبطها على Polyline3DInteractiveElement.

توسّع هذه الواجهة Polyline3DElementOptions.

موروثة: altitudeMode, coordinates, drawsOccludedSegments, extruded, geodesic, outerColor, outerWidth, strokeColor, strokeWidth, zIndex

فئة Polygon3DElement

google.maps.maps3d.Polygon3DElement صف

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

العنصر المخصّص:
<gmp-polygon-3d altitude-mode="absolute" draws-occluded-segments extruded fill-color="string" geodesic stroke-color="string" stroke-width="number" z-index="number"></gmp-polygon-3d>

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

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

يمكنك الوصول إلى الدعم من خلال الاتصال بالرقم const {Polygon3DElement} = await google.maps.importLibrary("maps3d").
اطّلِع على المكتبات في Maps JavaScript API.

Polygon3DElement
Polygon3DElement([options])
المَعلمات: 
تنشئ هذه الدالة Polygon3DElement مع الخيارات المحدّدة.
altitudeMode
النوع:  AltitudeMode optional
القيمة التلقائية: AltitudeMode.CLAMP_TO_GROUND
تحدّد هذه السمة كيفية تفسير مكوّنات الارتفاع في الإحداثيات.
سمة HTML:
  • <gmp-polygon-3d altitude-mode="absolute"></gmp-polygon-3d>
  • <gmp-polygon-3d altitude-mode="clamp-to-ground"></gmp-polygon-3d>
  • <gmp-polygon-3d altitude-mode="relative-to-ground"></gmp-polygon-3d>
  • <gmp-polygon-3d altitude-mode="relative-to-mesh"></gmp-polygon-3d>
drawsOccludedSegments
النوع:  boolean optional
القيمة التلقائية: false
تحدّد هذه السمة ما إذا كان سيتم رسم أجزاء المضلّع التي يمكن أن يتم حجبها أم لا. يمكن أن تحجب مضلّعات المساحات الأرضية هندسة الخريطة (مثل المباني).
سمة HTML:
  • <gmp-polygon-3d draws-occluded-segments></gmp-polygon-3d>
extruded
النوع:  boolean optional
القيمة التلقائية: false
تحدّد ما إذا كان سيتم ربط المضلّع بالأرض. لإضافة بروز إلى مضلّع، يجب أن تكون قيمة altitudeMode إما RELATIVE_TO_GROUND أو ABSOLUTE.
سمة HTML:
  • <gmp-polygon-3d extruded></gmp-polygon-3d>
fillColor
النوع:  string optional
لون التعبئة تتوافق جميع ألوان CSS3.
سمة HTML:
  • <gmp-polygon-3d fill-color="string"></gmp-polygon-3d>
geodesic
النوع:  boolean optional
القيمة التلقائية: false
عندما تكون القيمة true، يتم تفسير حواف المضلّع على أنّها جيوديسية وستتبع انحناء الكرة الأرضية. عندما تكون القيمة false، يتم عرض حواف المضلّع كخطوط مستقيمة في مساحة الشاشة.
سمة HTML:
  • <gmp-polygon-3d geodesic></gmp-polygon-3d>
innerCoordinates
التسلسل المرتب للإحداثيات الذي يحدّد حلقة مغلقة على عكس الخطوط المتعددة، قد يتألف المضلّع من مسار واحد أو أكثر، ما يؤدي إلى إنشاء عدة أجزاء مقطوعة داخل المضلّع.
outerCoordinates
التسلسل المرتب للإحداثيات الذي يحدّد حلقة مغلقة يتم تجاهل الارتفاع في أوضاع معيّنة، وبالتالي يكون اختياريًا.
strokeColor
النوع:  string optional
لون الخط تتوافق جميع ألوان CSS3.
سمة HTML:
  • <gmp-polygon-3d stroke-color="string"></gmp-polygon-3d>
strokeWidth
النوع:  number optional
تمثّل هذه السمة عرض الخط بالبكسل.
سمة HTML:
  • <gmp-polygon-3d stroke-width="number"></gmp-polygon-3d>
zIndex
النوع:  number optional
تمثّل هذه السمة قيمة zIndex مقارنةً بالمضلّعات الأخرى.
سمة HTML:
  • <gmp-polygon-3d z-index="number"></gmp-polygon-3d>
BetaaddEventListener
addEventListener(type, listener[, options])
المَعلمات: 
  • typestring سلسلة حساسة لحالة الأحرف تمثّل نوع الحدث الذي سيتم الاستماع إليه.
  • listenerEventListener|EventListenerObject العنصر الذي يتلقّى إشعارًا. يجب أن يكون هذا الإدخال دالة أو عنصرًا يتضمّن طريقة handleEvent
  • optionsboolean|AddEventListenerOptions optional الاطّلاع على الخيارات لا تتيح الأحداث المخصّصة سوى capture وpassive.
قيمة العائد:  void
تُعدّ هذه السمة دالة سيتم استدعاؤها كلّما تمّ تسليم الحدث المحدّد إلى الهدف. اطّلِع على addEventListener.
BetaremoveEventListener
removeEventListener(type, listener[, options])
المَعلمات: 
  • typestring سلسلة تحدّد نوع الحدث الذي ستتم إزالة معالج الأحداث الخاص به.
  • listenerEventListener|EventListenerObject أداة معالجة الأحداث التي سيتم إزالتها من هدف الحدث.
  • optionsboolean|EventListenerOptions optional الاطّلاع على الخيارات
قيمة العائد:  void
تزيل هذه الطريقة أداة معالجة الأحداث التي تم تسجيلها سابقًا باستخدام addEventListener من العنصر المستهدف. راجِع removeEventListener.

واجهة Polygon3DElementOptions

google.maps.maps3d.Polygon3DElementOptions interface

يتم استخدام عنصر 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
يمكنك الاطّلاع على Polygon3DElement.innerCoordinates.
outerCoordinates optional
يمكنك الاطّلاع على Polygon3DElement.outerCoordinates.
strokeColor optional
النوع:  string optional
يمكنك الاطّلاع على Polygon3DElement.strokeColor.
strokeWidth optional
النوع:  number optional
يمكنك الاطّلاع على Polygon3DElement.strokeWidth.
zIndex optional
النوع:  number optional
يمكنك الاطّلاع على Polygon3DElement.zIndex.

فئة Polygon3DInteractiveElement

google.maps.maps3d.Polygon3DInteractiveElement صف

يحدّد المضلّع الثلاثي الأبعاد (مثل الخط المتعدد الأبعاد الثلاثي الأبعاد) سلسلة من الإحداثيات المرتبطة في تسلسل مرتّب. بالإضافة إلى ذلك، تشكّل المضلّعات حلقة مغلقة وتحدّد منطقة مملوءة. على عكس Polygon3DElement، يتلقّى Polygon3DInteractiveElement حدث gmp-click.

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

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

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

يمكنك الوصول إلى الدعم من خلال الاتصال بالرقم const {Polygon3DInteractiveElement} = await google.maps.importLibrary("maps3d").
اطّلِع على المكتبات في Maps JavaScript API.

Polygon3DInteractiveElement
Polygon3DInteractiveElement([options])
المَعلمات: 
تنشئ هذه الدالة Polygon3DInteractiveElement مع الخيارات المحدّدة.
موروثة: altitudeMode, drawsOccludedSegments, extruded, fillColor, geodesic, innerCoordinates, outerCoordinates, strokeColor, strokeWidth, zIndex
addEventListener
addEventListener(type, listener[, options])
المَعلمات: 
  • typestring سلسلة حساسة لحالة الأحرف تمثّل نوع الحدث الذي سيتم الاستماع إليه.
  • listenerEventListener|EventListenerObject العنصر الذي يتلقّى إشعارًا. يجب أن يكون هذا الإدخال دالة أو عنصرًا يتضمّن طريقة handleEvent
  • optionsboolean|AddEventListenerOptions optional الاطّلاع على الخيارات لا تتيح الأحداث المخصّصة سوى capture وpassive.
قيمة العائد:  void
تُعدّ هذه السمة دالة سيتم استدعاؤها كلّما تمّ تسليم الحدث المحدّد إلى الهدف. راجِع addEventListener
removeEventListener
removeEventListener(type, listener[, options])
المَعلمات: 
  • typestring سلسلة تحدّد نوع الحدث الذي ستتم إزالة معالج الأحداث الخاص به.
  • listenerEventListener|EventListenerObject أداة معالجة الأحداث التي سيتم إزالتها من هدف الحدث.
  • optionsboolean|EventListenerOptions optional عرض الخيارات
قيمة العائد:  void
تزيل هذه الطريقة أداة معالجة الأحداث التي تم تسجيلها سابقًا باستخدام addEventListener من العنصر المستهدف. راجِع removeEventListener
gmp-click
function(clickEvent)
الوسيطات: 
  • clickEventLocationClickEvent سيحتوي عنصر الحدث على الموقع الجغرافي للنقرة (خطوط الطول والعرض والارتفاع).
يتم تنشيط هذا الحدث عند النقر على العنصر Polygon3DInteractiveElement.

Polygon3DInteractiveElementOptions interface

google.maps.maps3d.Polygon3DInteractiveElementOptions interface

كائن Polygon3DInteractiveElementOptions يُستخدَم لتحديد السمات التي يمكن ضبطها في Polygon3DInteractiveElement.

توسّع هذه الواجهة Polygon3DElementOptions.

موروثة: altitudeMode, drawsOccludedSegments, extruded, fillColor, geodesic, innerCoordinates, outerCoordinates, strokeColor, strokeWidth, zIndex

فئة PopoverElement

google.maps.maps3d.PopoverElement صف

عنصر HTML مخصّص يعرض نافذة منبثقة. يظهر على شكل فقاعة ويكون مرتبطًا غالبًا بعلامة.

العنصر المخصّص:
<gmp-popover altitude-mode="absolute" light-dismiss-disabled open position-anchor="lat,lng"></gmp-popover>

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

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

يمكنك الوصول إلى الدعم من خلال الاتصال بالرقم const {PopoverElement} = await google.maps.importLibrary("maps3d").
اطّلِع على المكتبات في Maps JavaScript API.

PopoverElement
PopoverElement([options])
المَعلمات: 
altitudeMode
النوع:  AltitudeMode optional
القيمة التلقائية: AltitudeMode.CLAMP_TO_GROUND
تحدّد هذه السمة طريقة تفسير مكوّن الارتفاع في الموضع.
سمة HTML:
  • <gmp-popover altitude-mode="absolute"></gmp-popover>
  • <gmp-popover altitude-mode="clamp-to-ground"></gmp-popover>
  • <gmp-popover altitude-mode="relative-to-ground"></gmp-popover>
  • <gmp-popover altitude-mode="relative-to-mesh"></gmp-popover>
lightDismissDisabled
النوع:  boolean optional
القيمة التلقائية: false
تحدّد هذه السمة ما إذا كان يجب إغلاق النافذة المنبثقة بشكل سريع أم لا. يشبه سلوك "الإغلاق الخفيف" ضبط السمة popover="auto" التي تشكّل جزءًا من Popover API في المتصفّح.
سمة HTML:
  • <gmp-popover light-dismiss-disabled></gmp-popover>
open
النوع:  boolean optional
القيمة التلقائية: false
تحدّد هذه السمة ما إذا كان يجب فتح هذه النافذة المنبثقة أم لا.
سمة HTML:
  • <gmp-popover open></gmp-popover>
positionAnchor
موضع عرض النافذة المنبثقة. إذا كان العنصر المنبثق مثبّتًا بعلامة تفاعلية، سيتم استخدام موضع العلامة بدلاً من ذلك.
سمة HTML:
  • <gmp-popover position-anchor="lat,lng"></gmp-popover>
  • <gmp-popover position-anchor="lat,lng,altitude"></gmp-popover>
  • <gmp-popover position-anchor="marker-id"></gmp-popover>
default
تضع هذه السمة المحتوى الذي تمّت إضافة فتحة له في القسم الرئيسي من النافذة المنبثقة.
header
تضع هذه السمة المحتوى الذي تمّت تعبئته في قسم العنوان الخاص بالنافذة المنبثقة.
--gmp-popover-max-width
الحد الأقصى لعرض النافذة المنبثقة، بغض النظر عن عرض المحتوى
--gmp-popover-min-width
الحد الأدنى لعرض النافذة المنبثقة، بغض النظر عن عرض المحتوى عند استخدام هذه السمة، ننصح بشدة بضبطها على قيمة أقل من عرض الخريطة (بالبكسل).
--gmp-popover-pixel-offset-x
إزاحة طرف النافذة المنبثقة على المحور x بالبكسل من النقطة على الخريطة التي يتم تثبيت النافذة المنبثقة عند إحداثياتها الجغرافية
--gmp-popover-pixel-offset-y
إزاحة طرف النافذة المنبثقة على المحور y، بوحدات البكسل، من النقطة على الخريطة التي يتم تثبيت النافذة المنبثقة عند إحداثياتها الجغرافية
color-scheme
تشير إلى نظام الألوان الذي يمكن عرض النافذة المنبثقة به. لمزيد من التفاصيل، يمكنك الاطّلاع على color-scheme المستندات. إذا لم يتم تحديدها، سيتم استخدام إعدادات نظام الألوان المفضّلة للمستخدم تلقائيًا.
BetaaddEventListener
addEventListener(type, listener[, options])
المَعلمات: 
  • typestring سلسلة حساسة لحالة الأحرف تمثّل نوع الحدث الذي سيتم الاستماع إليه.
  • listenerEventListener|EventListenerObject العنصر الذي يتلقّى إشعارًا. يجب أن يكون هذا الإدخال دالة أو عنصرًا يتضمّن طريقة handleEvent
  • optionsboolean|AddEventListenerOptions optional الاطّلاع على الخيارات لا تتيح الأحداث المخصّصة سوى capture وpassive.
قيمة العائد:  void
تُعدّ هذه السمة دالة سيتم استدعاؤها كلّما تمّ تسليم الحدث المحدّد إلى الهدف. اطّلِع على addEventListener.
BetaremoveEventListener
removeEventListener(type, listener[, options])
المَعلمات: 
  • typestring سلسلة تحدّد نوع الحدث الذي ستتم إزالة معالج الأحداث الخاص به.
  • listenerEventListener|EventListenerObject أداة معالجة الأحداث التي سيتم إزالتها من هدف الحدث.
  • optionsboolean|EventListenerOptions optional الاطّلاع على الخيارات
قيمة العائد:  void
تزيل هذه الطريقة أداة معالجة الأحداث التي تم تسجيلها سابقًا باستخدام addEventListener من العنصر المستهدف. راجِع removeEventListener.

واجهة PopoverElementOptions

google.maps.maps3d.PopoverElementOptions interface

يتم استخدام عنصر PopoverElementOptions لتحديد السمات التي يمكن ضبطها في PopoverElement.

altitudeMode optional
النوع:  AltitudeMode optional
يمكنك الاطّلاع على PopoverElement.altitudeMode.
lightDismissDisabled optional
النوع:  boolean optional
يمكنك الاطّلاع على PopoverElement.lightDismissDisabled.
open optional
النوع:  boolean optional
يمكنك الاطّلاع على PopoverElement.open.
positionAnchor optional
يمكنك الاطّلاع على PopoverElement.positionAnchor.

ثوابت AltitudeMode

google.maps.maps3d.AltitudeMode الثوابت

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

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

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