فئة Map3DElement
google.maps.maps3d.Map3DElement
صف
Map3DElement هي واجهة HTML لعرض الخريطة الثلاثية الأبعاد. يُرجى العِلم أنّه يجب ضبط mode لكي تبدأ الخريطة الثلاثية الأبعاد في العرض.
العنصر المخصّص:
<gmp-map-3d center="lat,lng,altitude" default-ui-disabled heading="number" internal-usage-attribution-ids="id1 id2" 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:
|
defaultUIDisabled |
النوع:
boolean optionalالقيمة التلقائية:
falseعند ضبط القيمة على
true، يتم إيقاف جميع أزرار واجهة المستخدم التلقائية. لا يتم إيقاف لوحة المفاتيح وعناصر التحكّم بالإيماءات.سمة HTML:
|
heading |
النوع:
number optionalتمثّل هذه السمة اتّجاه الخريطة بالدرجات، حيث يشير الشمال الحقيقي إلى الصفر. عندما لا يكون هناك ميل، سيتم تفسير أي دوران على أنّه اتجاه.
سمة HTML:
|
internalUsageAttributionIds |
النوع:
Iterable<string> optionalتضيف هذه السمة معرّف تحديد مصدر الاستخدام إلى أداة التهيئة، ما يساعد Google في التعرّف على المكتبات والنماذج المفيدة للمطوّرين، مثل استخدام مكتبة تجميع العلامات. لإيقاف إرسال معرّف تحديد المصدر، يمكنك حذف هذه السمة بأمان. سيتم إرسال القيم الفريدة فقط. قد يتم تجاهل أي تغييرات تُجريها على هذه القيمة بعد إنشاء مثيل.
سمة HTML:
|
maxAltitude |
النوع:
number optionalالحد الأقصى للارتفاع فوق سطح الأرض الذي سيتم عرضه على الخريطة تتراوح القيمة الصالحة بين
0 و63170000 مترًا (نصف قطر الأرض مضروبًا في 10).سمة HTML:
|
maxHeading |
النوع:
number optionalالحد الأقصى لزاوية العنوان (التدوير) للخريطة تتراوح القيمة الصالحة بين
0 و360 درجة. يمثّل minHeading وmaxHeading فاصلًا زمنيًا يبلغ <= 360 درجة سيتم فيه السماح بإيماءات العنوان. ستسمح السمتان minHeading = 180 وmaxHeading = 90 بالاتجاه في [0, 90] والاتجاه في [180, 360]. ستسمح minHeading = 90 وmaxHeading = 180 بعرض العنوان باللغة [90, 180].سمة HTML:
|
maxTilt |
النوع:
number optionalالحد الأقصى لزاوية سقوط الخريطة. تتراوح القيمة الصالحة بين
0 و90 درجة.سمة HTML:
|
minAltitude |
النوع:
number optionalالحد الأدنى للارتفاع عن سطح الأرض الذي سيتم عرضه على الخريطة تتراوح القيمة الصالحة بين
0 و63170000 مترًا (نصف قطر الأرض مضروبًا في 10).سمة HTML:
|
minHeading |
النوع:
number optionalالحدّ الأدنى لزاوية العنوان (التدوير) للخريطة تتراوح القيمة الصالحة بين
0 و360 درجة. يمثّل minHeading وmaxHeading فاصلًا زمنيًا يبلغ <= 360 درجة سيتم فيه السماح بإيماءات العنوان. ستسمح السمتان minHeading = 180 وmaxHeading = 90 بالاتجاه في [0, 90] والاتجاه في [180, 360]. ستسمح minHeading = 90 وmaxHeading = 180 بعرض العنوان باللغة [90, 180].سمة HTML:
|
minTilt |
النوع:
number optionalالحدّ الأدنى لزاوية السقوط للخريطة تتراوح القيمة الصالحة بين
0 و90 درجة.سمة HTML:
|
mode |
النوع:
MapMode optionalتحدّد هذه السمة الوضع الذي يجب عرض الخريطة به. إذا لم يتم ضبطها، لن يتم عرض الخريطة.
سمة HTML:
|
range |
النوع:
number optionalالمسافة من الكاميرا إلى وسط الخريطة، بالأمتار
سمة HTML:
|
roll |
النوع:
number optionalتمثّل هذه السمة ميل الكاميرا حول متجه العرض بالدرجات. لحلّ حالات الغموض، عندما لا يكون هناك ميل، سيتم تفسير أي دوران على أنّه اتجاه.
سمة HTML:
|
tilt |
النوع:
number optionalتشير هذه السمة إلى ميل متّجه زاوية رؤية الكاميرا بالدرجات. سيكون لمتجه العرض الذي ينظر إلى الأرض مباشرةً زاوية ميل تبلغ صفر درجة. سيكون لمتجه العرض الذي يشير إلى الخارج من الكرة الأرضية ميلان بمقدار
180 درجة.سمة HTML:
|
الطُرق | |
|---|---|
addEventListener |
addEventListener(type, listener[, options])المَعلمات:
قيمة العائد:
voidتُعدّ هذه السمة دالة سيتم استدعاؤها كلّما تمّ تسليم الحدث المحدّد إلى الهدف. اطّلِع على addEventListener. |
flyCameraAround |
flyCameraAround(options)المَعلمات:
القيمة المعروضة: لا شيء
تدور هذه الطريقة بالكاميرا حول موقع جغرافي محدّد لمدة زمنية محدّدة، ما يؤدي إلى إجراء عدد محدّد من اللقطات في ذلك الوقت. بشكلٍ تلقائي، تدور الكاميرا في اتجاه عقارب الساعة. إذا تم إدخال عدد سالب للجولات، ستدور الكاميرا في اتجاه عكس عقارب الساعة بدلاً من ذلك. الطريقة غير متزامنة لأنّه لا يمكن بدء الرسوم المتحركة إلا بعد تحميل الحد الأدنى من الخريطة. تعرض الطريقة النتيجة بعد بدء الصورة المتحركة. إذا كان عدد الجولات صفرًا، لن يتم إجراء أي دوران، وستكتمل الحركة فور بدئها. |
flyCameraTo |
flyCameraTo(options)المَعلمات:
القيمة المعروضة: لا شيء
تنقل هذه الطريقة الكاميرا بشكلٍ مكافئ من الموقع الجغرافي الحالي إلى موقع جغرافي نهائي محدّد خلال مدة زمنية محدّدة. الطريقة غير متزامنة لأنّه لا يمكن بدء الرسوم المتحركة إلا بعد تحميل الحد الأدنى من الخريطة. تعرض الطريقة النتيجة بعد بدء الصورة المتحركة. |
removeEventListener |
removeEventListener(type, listener[, options])المَعلمات:
قيمة العائد:
voidتزيل هذه الطريقة أداة معالجة الأحداث التي تم تسجيلها سابقًا باستخدام addEventListener من العنصر المستهدف. راجِع removeEventListener. |
stopCameraAnimation |
stopCameraAnimation()المَعلمات: بدون
القيمة المعروضة: لا شيء
توقف هذه الطريقة أي رسوم متحركة قد تكون قيد التشغيل. تبقى الكاميرا في مكانها في منتصف الصورة المتحركة، ولا تنتقل إلى نقطة النهاية. الطريقة غير متزامنة لأنّه لا يمكن بدء الصور المتحركة أو إيقافها إلا بعد أن تحمّل الخريطة حدًا أدنى من البيانات. لا تعرض الطريقة أي قيمة إلا بعد توقّف الحركة. |
الفعاليات | |
|---|---|
gmp-animationend |
function(animationEndEvent)الوسيطات:
يتم إطلاق هذا الحدث عند انتهاء حركة التحليق. يتم تمرير هذا الحدث إلى أعلى شجرة نموذج العناصر في المستند. |
gmp-centerchange |
function(centerChangeEvent)الوسيطات:
يتم تنشيط هذا الحدث عند تغيير خاصية مركز Map3DElement. |
gmp-click |
function(clickEvent)الوسيطات:
يتم تنشيط هذا الحدث عند النقر على العنصر Map3DElement. |
gmp-error |
function(mapInitializationErrorEvent)الوسيطات:
يتم تنشيط هذا الحدث عندما يتعذّر إعداد الخريطة. |
gmp-headingchange |
function(headingChangeEvent)الوسيطات:
يتم تنشيط هذا الحدث عند تغيير سمة العنوان في Map3DElement. |
gmp-rangechange |
function(rangeChangeEvent)الوسيطات:
يتم تنشيط هذا الحدث عند تغيير سمة النطاق في Map3DElement. |
gmp-rollchange |
function(rollChangeEvent)الوسيطات:
يتم تنشيط هذا الحدث عند تغيير السمة "لفة" في Map3DElement. |
gmp-steadychange |
function(steadyChangeEvent)الوسيطات:
يتم تنشيط هذا الحدث عند تغيُّر الحالة الثابتة لـ Map3DElement. |
gmp-tiltchange |
function(tiltChangeEvent)الوسيطات:
يتم تنشيط هذا الحدث عند تغيير سمة ميل 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. |
internalUsageAttributionIds optional |
النوع:
Iterable<string> optionalيمكنك الاطّلاع على Map3DElement.internalUsageAttributionIds. |
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()المَعلمات: بدون
يجلب 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:
|
collisionBehavior |
النوع:
CollisionBehavior optionalالقيمة التلقائية:
CollisionBehavior.REQUIREDتعداد يحدّد طريقة عمل Marker3DElement عند تصادمه مع Marker3DElement آخر أو مع تصنيفات الخريطة الأساسية.
سمة HTML:
|
drawsWhenOccluded |
النوع:
boolean optionalالقيمة التلقائية:
falseتحدّد هذه السمة ما إذا كان يجب رسم هذه العلامة أم لا عندما تكون محجوبة. يمكن أن تحجب هندسة الخريطة (مثل المباني) العلامة.
سمة HTML:
|
extruded |
النوع:
boolean optionalالقيمة التلقائية:
falseتحدّد ما إذا كان سيتم ربط العلامة بالأرض. لإضافة بروز إلى علامة، يجب أن تكون قيمة
altitudeMode إما RELATIVE_TO_GROUND أو ABSOLUTE.سمة HTML:
|
label |
النوع:
string optionalالنص الذي سيتم عرضه بواسطة هذه العلامة
سمة HTML:
|
position |
النوع:
LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optionalتمثّل هذه السمة موقع طرف العلامة. يتم تجاهل الارتفاع في أوضاع معيّنة، وبالتالي يكون اختياريًا.
سمة HTML:
|
sizePreserved |
النوع:
boolean optionalالقيمة التلقائية:
falseتحدّد هذه السمة ما إذا كان يجب الحفاظ على حجم هذا العلامة أو لا بغض النظر عن المسافة من الكاميرا. يتم تلقائيًا تغيير حجم العلامة استنادًا إلى المسافة من الكاميرا أو الميل.
سمة HTML:
|
zIndex |
النوع:
number optionalتمثّل هذه السمة ترتيب العرض مقارنةً بالعلامات الأخرى.
سمة HTML:
|
الماكينات الشقبية | |
|---|---|
default |
سيتم إدراج أي عناصر مخصّصة تتم إضافتها مباشرةً إلى Marker3DElement، ولكن سيتم استخدام العناصر من الأنواع HTMLImageElement وSVGElement وPinElement فقط لرسم العلامات، وسيتم تجاهل العناصر الأخرى. يجب تضمين و HTMLImageElement وSVGElement في العنصر <template> قبل تعيينها إلى الموضع التلقائي Marker3DElement. يتم حاليًا تحويل الصور وملفات SVG إلى تنسيق نقطي قبل عرضها في المشهد الثلاثي الأبعاد، لذا لن يتم تطبيق رموز HTML المخصّصة المضمّنة في ملفات SVG أو فئات CSS المُضافة إلى الصور، وقد لا تظهر عند عرض العلامات على الشاشة. |
الطُرق | |
|---|---|
addEventListener |
addEventListener(type, listener[, options])المَعلمات:
قيمة العائد:
voidتُعدّ هذه السمة دالة سيتم استدعاؤها كلّما تمّ تسليم الحدث المحدّد إلى الهدف. اطّلِع على addEventListener. |
removeEventListener |
removeEventListener(type, listener[, options])المَعلمات:
قيمة العائد:
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 |
النوع:
LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral 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:
|
title |
النوع:
stringنص التمرير في حال توفّره، سيتمّ إضافة نص تسهيل الاستخدام (مثلاً، لاستخدامه مع برامج قراءة الشاشة) إلى
Marker3DInteractiveElement مع القيمة المقدَّمة.سمة HTML:
|
موروثة:
altitudeMode,
collisionBehavior,
drawsWhenOccluded,
extruded,
label,
position,
sizePreserved,
zIndex
| |
الماكينات الشقبية | |
|---|---|
default |
سيتم إدراج أي عناصر مخصّصة تتم إضافتها مباشرةً إلى Marker3DInteractiveElement، ولكن سيتم استخدام العناصر من نوع PinElement فقط لرسم العلامات، وسيتم تجاهل العناصر الأخرى. |
الطُرق | |
|---|---|
addEventListener |
addEventListener(type, listener[, options])المَعلمات:
قيمة العائد:
voidتُعدّ هذه السمة دالة سيتم استدعاؤها كلّما تمّ تسليم الحدث المحدّد إلى الهدف. اطّلِع على addEventListener. |
removeEventListener |
removeEventListener(type, listener[, options])المَعلمات:
قيمة العائد:
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:
|
orientation |
النوع:
Orientation3D|Orientation3DLiteral optionalتصف هذه السمة دوران نظام إحداثيات نموذج ثلاثي الأبعاد لتحديد موضع النموذج على "الخريطة الثلاثية الأبعاد".
يتم تطبيق عمليات التدوير على النموذج بالترتيب التالي: التدوير حول المحور الأفقي، ثم الإمالة، ثم الاتجاه. سمة HTML:
|
position |
النوع:
LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optionalتُستخدَم لضبط موضع
Model3DElement. يتم تجاهل الارتفاع في أوضاع معيّنة، وبالتالي يكون اختياريًا.سمة HTML:
|
scale |
النوع:
number|Vector3D|Vector3DLiteral optionalالقيمة التلقائية:
1تغيير حجم النموذج على طول المحاور x وy وz في مساحة إحداثيات النموذج
سمة HTML:
|
src |
النوع:
string|URL optionalتحدّد هذه السمة عنوان URL للتصميم الثلاثي الأبعاد. في الوقت الحالي، يمكن استخدام التصاميم التي تكون بتنسيق
.glb فقط. سيتم تحويل أي عناوين URL نسبية تستخدم HTTP إلى عناوين URL كاملة مقابلة. يُرجى العِلم أنّه إذا كنت تستضيف ملفات نموذج .glb على موقع إلكتروني أو خادم مختلف عن تطبيقك الرئيسي، احرص على إعداد عناوين CORS HTTP الصحيحة. يتيح ذلك لتطبيقك الوصول بأمان إلى ملفات النموذج من النطاق الآخر.سمة HTML:
|
الطُرق | |
|---|---|
addEventListener |
addEventListener(type, listener[, options])المَعلمات:
قيمة العائد:
voidتُعدّ هذه السمة دالة سيتم استدعاؤها كلّما تمّ تسليم الحدث المحدّد إلى الهدف. اطّلِع على addEventListener. |
removeEventListener |
removeEventListener(type, listener[, options])المَعلمات:
قيمة العائد:
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 |
النوع:
LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral 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])المَعلمات:
قيمة العائد:
voidتُعدّ هذه السمة دالة سيتم استدعاؤها كلّما تمّ تسليم الحدث المحدّد إلى الهدف. اطّلِع على addEventListener. |
removeEventListener |
removeEventListener(type, listener[, options])المَعلمات:
قيمة العائد:
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" path="lat1,lng1,altitude1 lat2,lng2,altitude2 lat3,lng3,altitude3 ..." 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:
|
drawsOccludedSegments |
النوع:
boolean optionalالقيمة التلقائية:
falseتحدّد هذه السمة ما إذا كان سيتم رسم أجزاء الخط المتعدد التي يمكن حجبها أم لا. يمكن أن تحجب الأشكال المتعددة الخطوط أشكال الخريطة الهندسية (مثل المباني).
سمة HTML:
|
extruded |
النوع:
boolean optionalالقيمة التلقائية:
falseتحدّد هذه السمة ما إذا كان سيتم ربط الخط المتعدد الأضلاع بالأرض. لإخراج خط متعدد، يجب أن يكون
altitudeMode إما RELATIVE_TO_GROUND أو ABSOLUTE.سمة HTML:
|
geodesic |
النوع:
boolean optionalالقيمة التلقائية:
falseعندما تكون القيمة
true، يتم تفسير حواف الخط المتعدد على أنّها خطوط جيوديسية وستتبع انحناء الأرض. عندما تكون القيمة false، يتم عرض حواف الخط المتعدد على شكل خطوط مستقيمة في مساحة الشاشة.سمة HTML:
|
outerColor |
النوع:
string optionalاللون الخارجي تتوافق جميع ألوان CSS3.
سمة HTML:
|
outerWidth |
النوع:
number optionalيتراوح العرض الخارجي بين
0.0 و1.0. هذه نسبة مئوية من strokeWidth.سمة HTML:
|
path |
النوع:
Iterable<LatLngAltitude|LatLngAltitudeLiteral|LatLngLiteral> optionalتمثّل هذه السمة التسلسل المرتب للإحداثيات الخاصة بالخط المتعدد. يتم تجاهل الارتفاع في أوضاع معيّنة، وبالتالي يكون اختياريًا.
سمة HTML:
|
strokeColor |
النوع:
string optionalلون الخط تتوافق جميع ألوان CSS3.
سمة HTML:
|
strokeWidth |
النوع:
number optionalتمثّل هذه السمة عرض الخط بالبكسل.
سمة HTML:
|
zIndex |
النوع:
number optionalتمثّل هذه السمة قيمة zIndex مقارنةً بالمضلّعات الأخرى.
سمة HTML:
|
|
النوع:
Iterable<LatLngAltitude|LatLngAltitudeLiteral|LatLngLiteral> optionalتمثّل هذه السمة التسلسل المرتب للإحداثيات الخاصة بالخط المتعدد. يتم تجاهل الارتفاع في أوضاع معيّنة، وبالتالي يكون اختياريًا. |
الطُرق | |
|---|---|
addEventListener |
addEventListener(type, listener[, options])المَعلمات:
قيمة العائد:
voidتُعدّ هذه السمة دالة سيتم استدعاؤها كلّما تمّ تسليم الحدث المحدّد إلى الهدف. اطّلِع على addEventListener. |
removeEventListener |
removeEventListener(type, listener[, options])المَعلمات:
قيمة العائد:
voidتزيل هذه الطريقة أداة معالجة الأحداث التي تم تسجيلها سابقًا باستخدام addEventListener من العنصر المستهدف. راجِع removeEventListener. |
واجهة Polyline3DElementOptions
google.maps.maps3d.Polyline3DElementOptions
interface
عنصر Polyline3DElementOptions المستخدَم لتحديد الخصائص التي يمكن ضبطها على Polyline3DElement.
الخصائص | |
|---|---|
altitudeMode optional |
النوع:
AltitudeMode optionalيمكنك الاطّلاع على Polyline3DElement.altitudeMode. |
coordinates optional |
النوع:
Iterable<LatLngAltitude|LatLngAltitudeLiteral|LatLngLiteral> optionalيمكنك الاطّلاع على . |
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,
drawsOccludedSegments,
extruded,
geodesic,
outerColor,
outerWidth,
path,
strokeColor,
strokeWidth,
zIndex,
|
الطُرق | |
|---|---|
addEventListener |
addEventListener(type, listener[, options])المَعلمات:
قيمة العائد:
voidتُعدّ هذه السمة دالة سيتم استدعاؤها كلّما تمّ تسليم الحدث المحدّد إلى الهدف. اطّلِع على addEventListener. |
removeEventListener |
removeEventListener(type, listener[, options])المَعلمات:
قيمة العائد:
voidتزيل هذه الطريقة أداة معالجة الأحداث التي تم تسجيلها سابقًا باستخدام addEventListener من العنصر المستهدف. راجِع removeEventListener. |
الفعاليات | |
|---|---|
gmp-click |
function(clickEvent)الوسيطات:
يتم تنشيط هذا الحدث عند النقر على العنصر 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 path="lat1,lng1,altitude1 lat2,lng2,altitude2 lat3,lng3,altitude3 ..." 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:
|
drawsOccludedSegments |
النوع:
boolean optionalالقيمة التلقائية:
falseتحدّد هذه السمة ما إذا كان سيتم رسم أجزاء المضلّع التي يمكن أن يتم حجبها أم لا. يمكن أن تحجب مضلّعات المساحات الأرضية هندسة الخريطة (مثل المباني).
سمة HTML:
|
extruded |
النوع:
boolean optionalالقيمة التلقائية:
falseتحدّد ما إذا كان سيتم ربط المضلّع بالأرض. لإضافة بروز إلى مضلّع، يجب أن تكون قيمة
altitudeMode إما RELATIVE_TO_GROUND أو ABSOLUTE.سمة HTML:
|
fillColor |
النوع:
string optionalلون التعبئة تتوافق جميع ألوان CSS3.
سمة HTML:
|
geodesic |
النوع:
boolean optionalالقيمة التلقائية:
falseعندما تكون القيمة
true، يتم تفسير حواف المضلّع على أنّها جيوديسية وستتبع انحناء الكرة الأرضية. عندما تكون القيمة false، يتم عرض حواف المضلّع كخطوط مستقيمة في مساحة الشاشة.سمة HTML:
|
innerPaths |
النوع:
Iterable<Iterable<LatLngAltitude|LatLngAltitudeLiteral|LatLngLiteral>> optionalالتسلسل المرتب للإحداثيات الذي يحدّد حلقة مغلقة على عكس الخطوط المتعددة، قد يتألف المضلّع من مسار واحد أو أكثر، ما يؤدي إلى إنشاء عدة أجزاء مقطوعة داخل المضلّع. |
path |
النوع:
Iterable<LatLngAltitude|LatLngAltitudeLiteral|LatLngLiteral> optionalالتسلسل المرتب للإحداثيات الذي يحدّد حلقة مغلقة يتم تجاهل الارتفاع في أوضاع معيّنة، وبالتالي يكون اختياريًا.
سمة HTML:
|
strokeColor |
النوع:
string optionalلون الخط تتوافق جميع ألوان CSS3.
سمة HTML:
|
strokeWidth |
النوع:
number optionalتمثّل هذه السمة عرض الخط بالبكسل.
سمة HTML:
|
zIndex |
النوع:
number optionalتمثّل هذه السمة قيمة zIndex مقارنةً بالمضلّعات الأخرى.
سمة HTML:
|
|
النوع:
Iterable<LatLngAltitude|LatLngAltitudeLiteral|LatLngLiteral> optionalالتسلسل المرتب للإحداثيات الذي يحدّد حلقة مغلقة يتم تجاهل الارتفاع في أوضاع معيّنة، وبالتالي يكون اختياريًا. |
|
النوع:
Iterable<Iterable<LatLngAltitude|LatLngAltitudeLiteral|LatLngLiteral>> optionalالتسلسل المرتب للإحداثيات الذي يحدّد حلقة مغلقة على عكس الخطوط المتعددة، قد يتألف المضلّع من مسار واحد أو أكثر، ما يؤدي إلى إنشاء عدة أجزاء مقطوعة داخل المضلّع. |
الطُرق | |
|---|---|
addEventListener |
addEventListener(type, listener[, options])المَعلمات:
قيمة العائد:
voidتُعدّ هذه السمة دالة سيتم استدعاؤها كلّما تمّ تسليم الحدث المحدّد إلى الهدف. اطّلِع على addEventListener. |
removeEventListener |
removeEventListener(type, listener[, options])المَعلمات:
قيمة العائد:
voidتزيل هذه الطريقة أداة معالجة الأحداث التي تم تسجيلها سابقًا باستخدام addEventListener من العنصر المستهدف. راجِع removeEventListener. |
واجهة Polygon3DElementOptions
google.maps.maps3d.Polygon3DElementOptions
interface
يتم استخدام عنصر Polygon3DElementOptions لتحديد السمات التي يمكن ضبطها في Polygon3DElement.
فئة 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,
innerPaths,
path,
strokeColor,
strokeWidth,
zIndex,
,
|
الطُرق | |
|---|---|
addEventListener |
addEventListener(type, listener[, options])المَعلمات:
قيمة العائد:
voidتُعدّ هذه السمة دالة سيتم استدعاؤها كلّما تمّ تسليم الحدث المحدّد إلى الهدف. اطّلِع على addEventListener. |
removeEventListener |
removeEventListener(type, listener[, options])المَعلمات:
قيمة العائد:
voidتزيل هذه الطريقة أداة معالجة الأحداث التي تم تسجيلها سابقًا باستخدام addEventListener من العنصر المستهدف. راجِع removeEventListener. |
الفعاليات | |
|---|---|
gmp-click |
function(clickEvent)الوسيطات:
يتم تنشيط هذا الحدث عند النقر على العنصر 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:
|
lightDismissDisabled |
النوع:
boolean optionalالقيمة التلقائية:
falseتحدّد هذه السمة ما إذا كان يجب إغلاق النافذة المنبثقة بشكل سريع أم لا. يشبه سلوك "الإغلاق الخفيف" ضبط السمة
popover="auto" التي تشكّل جزءًا من Popover API في المتصفّح.سمة HTML:
|
open |
النوع:
boolean optionalالقيمة التلقائية:
falseتحدّد هذه السمة ما إذا كان يجب فتح هذه النافذة المنبثقة أم لا.
سمة HTML:
|
positionAnchor |
النوع:
LatLngLiteral|LatLngAltitudeLiteral|Marker3DInteractiveElement|string optionalموضع عرض النافذة المنبثقة. إذا كان العنصر المنبثق مثبّتًا بعلامة تفاعلية، سيتم استخدام موضع العلامة بدلاً من ذلك.
سمة HTML:
|
الماكينات الشقبية | |
|---|---|
default |
تضع هذه السمة المحتوى الذي تمّت إضافة فتحة له في القسم الرئيسي من النافذة المنبثقة. |
header |
تضع هذه السمة المحتوى الذي تمّت تعبئته في قسم العنوان الخاص بالنافذة المنبثقة. |
خصائص CSS | |
|---|---|
--gmp-popover-max-width |
الحد الأقصى لعرض النافذة المنبثقة، بغض النظر عن عرض المحتوى |
--gmp-popover-min-width |
الحد الأدنى لعرض النافذة المنبثقة، بغض النظر عن عرض المحتوى عند استخدام هذه السمة، ننصح بشدة بضبطها على قيمة أقل من عرض الخريطة (بالبكسل). |
--gmp-popover-pixel-offset-x |
إزاحة طرف النافذة المنبثقة على المحور x بالبكسل من النقطة على الخريطة التي يتم تثبيت النافذة المنبثقة عند إحداثياتها الجغرافية |
--gmp-popover-pixel-offset-y |
إزاحة طرف النافذة المنبثقة على المحور y، بوحدات البكسل، من النقطة على الخريطة التي يتم تثبيت النافذة المنبثقة عند إحداثياتها الجغرافية |
color-scheme |
تشير إلى نظام الألوان الذي يمكن عرض النافذة المنبثقة به. لمزيد من التفاصيل، يمكنك الاطّلاع على color-scheme المستندات. إذا لم يتم تحديدها، سيتم استخدام إعدادات نظام الألوان المفضّلة للمستخدم تلقائيًا. |
الطُرق | |
|---|---|
addEventListener |
addEventListener(type, listener[, options])المَعلمات:
قيمة العائد:
voidتُعدّ هذه السمة دالة سيتم استدعاؤها كلّما تمّ تسليم الحدث المحدّد إلى الهدف. اطّلِع على addEventListener. |
removeEventListener |
removeEventListener(type, listener[, options])المَعلمات:
قيمة العائد:
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 |
النوع:
LatLngLiteral|LatLngAltitudeLiteral|string|Marker3DInteractiveElement 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 |
تتيح هذه السمة التعبير عن الكائنات بالنسبة إلى أعلى مستوى من الأرض والمباني والمسطحات المائية. عندما تكون فوق المياه، سيكون هذا هو سطح المياه، وعندما تكون فوق التضاريس، سيكون هذا هو سطح المبنى (إذا كان متوفرًا) أو سطح الأرض (إذا لم تكن هناك مبانٍ). |