3D Maps

Map3DElement class

google.maps.maps3d.Map3DElement class

Map3DElement هي واجهة HTML لعرض الخريطة الثلاثية الأبعاد.

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

تمتد هذه الفئة من HTMLElement.

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

يمكنك الوصول إليه من خلال الاتصال بالرقم const {Map3DElement} = await google.maps.importLibrary("maps3d"). اطّلع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.
Map3DElement
Map3DElement([options])
المَعلمات: 
bounds
النوع:  LatLngBounds|LatLngBoundsLiteral optional
عند ضبطها، تحدّ من موضع الكاميرا ضمن حدود خط الطول/العرض المحدّدة. يُرجى العلم أنّه لا يزال يتم عرض الأجسام خارج الحدود. يمكن أن تحدّ الحدود من خط الطول وخط العرض، أو يمكن أن تحدّ من خط الطول أو خط العرض فقط. بالنسبة إلى الحدود المتعلّقة بخطوط العرض فقط، استخدِم خطوط الطول في الغرب والشرق -180 و180 على التوالي. بالنسبة إلى الحدود التي تستند إلى خطوط الطول فقط، استخدِم خطوط العرض الشمالية والجنوبية 90 و-90 على التوالي.
center
النوع:  LatLngAltitude|LatLngAltitudeLiteral optional
وسط الخريطة المقدَّم كعنصر LatLngAltitude، حيث يتم قياس الارتفاع بالمتر فوق مستوى سطح الأرض يُرجى العِلم أنّ هذا الموضع ليس بالضرورة موضع الكاميرا، لأنّ الحقل range يؤثر في مسافة الكاميرا عن مركز الخريطة. إذا لم يتم ضبطها، يتم ضبطها تلقائيًا على {lat: 0, lng: 0, altitude: 63170000}. 63170000 متر هو الحد الأقصى المسموح به للارتفاع (نصف قطر الأرض مضروبًا في 10).
سمة HTML:
  • <gmp-map-3d center="lat,lng,altitude"></gmp-map-3d>
defaultLabelsDisabled
النوع:  boolean optional
تلقائي: false
عندما يكون true، لا يتم عرض تصنيفات الخريطة التلقائية.
سمة HTML:
  • <gmp-map-3d default-labels-disabled></gmp-map-3d>
defaultUIDisabled
النوع:  boolean optional
القيمة التلقائية: false
عند ضبط القيمة true، يتم إيقاف جميع أزرار واجهة المستخدم التلقائية. لا يؤدي ذلك إلى إيقاف عناصر التحكّم في لوحة المفاتيح والإيماءات.
سمة HTML:
  • <gmp-map-3d default-ui-disabled></gmp-map-3d>
heading
النوع:  number optional
اتجاه البوصلة للخريطة، بالدرجات، حيث يكون اتجاه الشمال تمامًا هو صفر في حال عدم حدوث إمالة، سيتم تفسير أي دوران على أنّه عنوان.
سمة HTML:
  • <gmp-map-3d heading="number"></gmp-map-3d>
maxAltitude
النوع:  number optional
الحد الأقصى للارتفاع فوق سطح الأرض الذي سيتم عرضه على الخريطة تتراوح القيمة الصالحة بين 0 و63170000 متر (نصف قطر الأرض مضروبًا في 10).
سمة HTML:
  • <gmp-map-3d max-altitude="number"></gmp-map-3d>
maxHeading
النوع:  number optional
الحد الأقصى لزاوية العنوان (التدوير) للخريطة. تتراوح القيمة الصالحة بين 0 و360 درجة. يمثّل minHeading وmaxHeading فاصلاً زمنيًا أصغر من أو يساوي 360 درجة سيتم خلاله السماح بإشارات التوجيه. سيسمح minHeading = 180 وmaxHeading = 90 بالعنوان في [0, 90] والعنوان في [180, 360]. سيسمح minHeading = 90 وmaxHeading = 180 بالعنوان في [90, 180].
سمة HTML:
  • <gmp-map-3d max-heading="number"></gmp-map-3d>
maxTilt
النوع:  number optional
الحد الأقصى لزاوية حدوث الخريطة تتراوح القيمة الصالحة بين 0 و90 درجة.
سمة HTML:
  • <gmp-map-3d max-tilt="number"></gmp-map-3d>
minAltitude
النوع:  number optional
الحد الأدنى للارتفاع فوق سطح الأرض الذي سيتم عرضه على الخريطة تتراوح القيمة الصالحة بين 0 و63170000 متر (نصف قطر الأرض مضروبًا في 10).
سمة HTML:
  • <gmp-map-3d min-altitude="number"></gmp-map-3d>
minHeading
النوع:  number optional
الحد الأدنى لزاوية العنوان (تدوير) الخريطة. تتراوح القيمة الصالحة بين 0 و360 درجة. يمثّل minHeading وmaxHeading فاصلاً زمنيًا أصغر من أو يساوي 360 درجة سيتم خلاله السماح بإشارات التوجيه. سيسمح minHeading = 180 وmaxHeading = 90 بالعنوان في [0, 90] والعنوان في [180, 360]. سيسمح minHeading = 90 وmaxHeading = 180 بالعنوان في [90, 180].
سمة HTML:
  • <gmp-map-3d min-heading="number"></gmp-map-3d>
minTilt
النوع:  number optional
الحد الأدنى لزاوية التواجد في الخريطة. تتراوح القيمة الصالحة بين 0 و90 درجة.
سمة HTML:
  • <gmp-map-3d min-tilt="number"></gmp-map-3d>
range
النوع:  number optional
المسافة من الكاميرا إلى مركز الخريطة، بالمتر
سمة HTML:
  • <gmp-map-3d range="number"></gmp-map-3d>
roll
النوع:  number optional
لفة الكاميرا حول متجه العرض بالدرجات. لحلّ الغموض، عندما لا يكون هناك إمالة، سيتم تفسير أي دوران على أنّه اتجاه.
سمة HTML:
  • <gmp-map-3d roll="number"></gmp-map-3d>
tilt
النوع:  number optional
إمالة متجه عرض الكاميرا بالدرجات سيكون ميل متجه العرض الذي ينظر مباشرةً إلى الأرض صفر درجة. ويجب إمالة خط العرض المتجه بعيدًا عن الأرض بمقدار 180 درجة.
سمة HTML:
  • <gmp-map-3d tilt="number"></gmp-map-3d>
BetaaddEventListener
addEventListener(type, listener[, options])
المَعلمات: 
  • type:  string سلسلة حسّاسة لحالة الأحرف تمثّل نوع الحدث الذي تريد الاستماع إليه.
  • listener:  EventListener|EventListenerObject العنصر الذي يتلقّى إشعارًا. يجب أن يكون هذا العنصر دالة أو كائنًا يتضمّن طريقة handleEvent.
  • options:  boolean|AddEventListenerOptions optional اطّلِع على الخيارات. لا تتيح الأحداث المخصّصة سوى capture وpassive.
القيمة المعروضة:  void
تُستخدَم لإعداد دالة سيتمّ استدعاؤها عند إرسال الحدث المحدّد إلى الهدف. يُرجى الاطّلاع على addEventListener.
flyCameraAround
flyCameraAround(options)
المَعلمات: 
القيمة المعروضة: ما مِن قيمة
تدور هذه الطريقة بالكاميرا حول موقع جغرافي محدّد لمدة محدّدة، ما يؤدي إلى إجراء عدد محدّد من الجولات خلال ذلك الوقت.

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

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

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

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

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

واجهة Map3DElementOptions

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

يتم استخدام كائن Map3DElementOptions لتحديد الخصائص التي يمكن تعيينها على Map3DElement.
bounds optional
النوع:  LatLngBounds|LatLngBoundsLiteral optional
يمكنك الاطّلاع على Map3DElement.bounds.
center optional
النوع:  LatLngAltitude|LatLngAltitudeLiteral optional
يمكنك الاطّلاع على Map3DElement.center.
defaultLabelsDisabled optional
النوع:  boolean optional
يمكنك الاطّلاع على Map3DElement.defaultLabelsDisabled.
defaultUIDisabled optional
النوع:  boolean optional
يمكنك الاطّلاع على Map3DElement.defaultUIDisabled.
heading optional
النوع:  number optional
يمكنك الاطّلاع على Map3DElement.heading.
maxAltitude optional
النوع:  number optional
يمكنك الاطّلاع على Map3DElement.maxAltitude.
maxHeading optional
النوع:  number optional
يمكنك الاطّلاع على Map3DElement.maxHeading.
maxTilt optional
النوع:  number optional
يمكنك الاطّلاع على Map3DElement.maxTilt.
minAltitude optional
النوع:  number optional
يمكنك الاطّلاع على Map3DElement.minAltitude.
minHeading optional
النوع:  number optional
يمكنك الاطّلاع على Map3DElement.minHeading.
minTilt optional
النوع:  number optional
يمكنك الاطّلاع على Map3DElement.minTilt.
range optional
النوع:  number optional
يمكنك الاطّلاع على Map3DElement.range.
roll optional
النوع:  number optional
يمكنك الاطّلاع على Map3DElement.roll.
tilt optional
النوع:  number optional
يمكنك الاطّلاع على Map3DElement.tilt.

واجهة FlyAroundAnimationOptions

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

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

FlyToAnimationOptions

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

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

واجهة CameraOptions

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

عنصر CameraOptions المستخدَم لتحديد السمات التي يمكن ضبطها على عنصر كاميرا يمكن أن يكون عنصر الكاميرا أيّ شيء يتضمّن موضع الكاميرا، مثل حالة الخريطة الحالية أو حالة متحركة مطلوبة في المستقبل.
center optional
النوع:  LatLngAltitude|LatLngAltitudeLiteral optional
يمكنك الاطّلاع على Map3DElement.center.
heading optional
النوع:  number optional
يمكنك الاطّلاع على Map3DElement.heading.
range optional
النوع:  number optional
يمكنك الاطّلاع على Map3DElement.range.
roll optional
النوع:  number optional
يمكنك الاطّلاع على Map3DElement.roll.
tilt optional
النوع:  number optional
يمكنك الاطّلاع على Map3DElement.tilt.

فئة SteadyChangeEvent

google.maps.maps3d.SteadyChangeEvent class

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

تمتد هذه الفئة من Event.

يمكنك الوصول إليه من خلال الاتصال بالرقم const {SteadyChangeEvent} = await google.maps.importLibrary("maps3d"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.
isSteady
النوع:  boolean
يشير إلى ما إذا كان Map3DElement ثابتًا (أي اكتمل عرض كل المشهد الحالي) أم لا.

LocationClickEvent class

صف واحد (google.maps.maps3d.LocationClickEvent)

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

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

يمكنك الوصول إليه من خلال الاتصال بالرقم const {LocationClickEvent} = await google.maps.importLibrary("maps3d"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.
position
النوع:  LatLngAltitude optional
خط العرض/خط الطول/الارتفاع الذي كان أسفل المؤشر عند وقوع الحدث يُرجى ملاحظة أنّه في المستويات الأضيق، سيتم عرض بيانات أقل دقة. وقد يتم أيضًا عرض ارتفاع قاع البحر لقيمة الارتفاع عند النقر على سطح الماء من مواضع أعلى للكاميرا. يتم تصعيد هذا الحدث من خلال شجرة نموذج DOM.

فئة PlaceClickEvent

صف واحد (google.maps.maps3d.PlaceClickEvent)

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

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

يمكنك الوصول إليه من خلال الاتصال بالرقم const {PlaceClickEvent} = await google.maps.importLibrary("maps3d"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.
placeId
النوع:  string
معرّف المكان لميزة الخريطة
مكتسَبة: position
fetchPlace
fetchPlace()
المَعلمات:  بدون
القيمة المعروضة:  Promise<Place>
تُستخدَم لطلب Place بمعرّف المكان هذا. في كائن Place الناتج، ستتم تعبئة سمة المعرّف. يمكن طلب حقول إضافية لاحقًا من خلال Place.fetchFields() وفقًا لعملية تفعيل Places API العادية والفوترة. يتم رفض الوعد في حال حدوث خطأ أثناء جلب Place.

فئة Marker3DElement

google.maps.maps3d.Marker3DElement class

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

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

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

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

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

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

واجهة Marker3DElementOptions

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

عنصر Marker3DElementOptions المستخدَم لتحديد السمات التي يمكن ضبطها على Marker3DElement
altitudeMode optional
النوع:  AltitudeMode optional
يمكنك الاطّلاع على Marker3DElement.altitudeMode.
collisionBehavior optional
النوع:  CollisionBehavior optional
يمكنك الاطّلاع على Marker3DElement.collisionBehavior.
drawsWhenOccluded optional
النوع:  boolean optional
يمكنك الاطّلاع على Marker3DElement.drawsWhenOccluded.
extruded optional
النوع:  boolean optional
يمكنك الاطّلاع على Marker3DElement.extruded.
label optional
النوع:  string optional
يمكنك الاطّلاع على Marker3DElement.label.
position optional
يمكنك الاطّلاع على Marker3DElement.position.
sizePreserved optional
النوع:  boolean optional
يمكنك الاطّلاع على Marker3DElement.sizePreserved.
zIndex optional
النوع:  number optional
يمكنك الاطّلاع على Marker3DElement.zIndex.

فئة Marker3DInteractiveElement

google.maps.maps3d.Marker3DInteractiveElement class

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

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

تمتد هذه الفئة من Marker3DElement.

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

يمكنك الوصول إليه من خلال الاتصال بالرقم const {Marker3DInteractiveElement} = await google.maps.importLibrary("maps3d"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.
Marker3DInteractiveElement
Marker3DInteractiveElement([options])
المَعلمات: 
تنشئ هذه الدالة Marker3DInteractiveElement بالاستناد إلى الخيارات المحدّدة.
مُكتسَبة: altitudeMode، collisionBehavior، drawsWhenOccluded، extruded، label، position، sizePreserved، zIndex
default
سيتم وضع أي عناصر مخصّصة تمت إضافتها مباشرةً إلى Marker3DInteractiveElement، ولكن سيتم استخدام عناصر من النوع PinElement فقط لرسم العلامات، وسيتم تجاهل العناصر الأخرى.
addEventListener
addEventListener(type, listener[, options])
المَعلمات: 
  • type:  string سلسلة حسّاسة لحالة الأحرف تمثّل نوع الحدث الذي تريد الاستماع إليه.
  • listener:  EventListener|EventListenerObject العنصر الذي يتلقّى إشعارًا. يجب أن تكون هذه دالة أو كائنًا باستخدام الطريقة handleEvent
  • options:  boolean|AddEventListenerOptions optional اطّلِع على الخيارات. لا تتيح الأحداث المخصّصة سوى capture وpassive.
القيمة المعروضة:  void
تُستخدَم لإعداد دالة سيتمّ استدعاؤها عند إرسال الحدث المحدّد إلى الهدف. راجِع addEventListener.
removeEventListener
removeEventListener(type, listener[, options])
المَعلمات: 
  • type:  string سلسلة تحدد نوع الحدث المطلوب إزالة أداة معالجة الحدث له.
  • listener:  EventListener|EventListenerObject أداة معالجة الحدث المطلوب إزالتها من هدف الحدث
  • options:  boolean|EventListenerOptions optional الاطّلاع على الخيارات
القيمة المعروضة:  void
تزيل هذه الوظيفة أداة معالجة حدث مسجَّلة سابقًا باستخدام addEventListener من الهدف. الاطّلاع على removeEventListener
gmp-click
function(clickEvent)
الوسيطات: 
يتم تنشيط هذا الحدث عند النقر على العنصر Marker3DInteractiveElement.

واجهة Marker3DInteractiveElementOptions

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

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

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

الإعدادات المكتسبة: altitudeMode، collisionBehavior، drawsWhenOccluded، extruded، label، position، sizePreserved، zIndex

Model3DElement class

google.maps.maps3d.Model3DElement class

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

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

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

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

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

يمكنك الوصول إليه من خلال الاتصال بالرقم const {Model3DElement} = await google.maps.importLibrary("maps3d"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.
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
تصف دوران نظام إحداثيات نموذج ثلاثي الأبعاد لوضع النموذج على الخريطة الثلاثية الأبعاد.

يتم تطبيق عمليات الدوران على النموذج بالترتيب التالي: الانحراف والتميل ثم الاتجاه.
position
تُستخدَم لضبط موضع Model3DElement. يتم تجاهل الارتفاع في أوضاع معيّنة، وبالتالي فهو اختياري.
scale
النوع:  number|Vector3D|Vector3DLiteral optional
القيمة التلقائية: 1
تُحوِّل حجم النموذج على طول المحاور x وy وz في مساحة إحداثيات النموذج.
src
النوع:  string|URL optional
تُحدِّد عنوان URL للتصميم الثلاثي الأبعاد. في الوقت الحالي، يمكن استخدام النماذج بتنسيق .glb فقط.

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

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

واجهة Model3DElementOptions

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

عنصر Model3DElementOptions المستخدَم لتحديد السمات التي يمكن ضبطها على Model3DElement
altitudeMode optional
النوع:  AltitudeMode optional
يمكنك الاطّلاع على Model3DElement.altitudeMode.
orientation optional
النوع:  Orientation3D|Orientation3DLiteral optional
يمكنك الاطّلاع على Model3DElement.orientation.
position optional
يمكنك الاطّلاع على Model3DElement.position.
scale optional
النوع:  number|Vector3D|Vector3DLiteral optional
يمكنك الاطّلاع على Model3DElement.scale.
src optional
النوع:  string|URL optional
يمكنك الاطّلاع على Model3DElement.src.

فئة Polyline3DElement

google.maps.maps3d.Polyline3DElement class

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

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

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

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

بإمكانك الوصول إلى الخدمة من خلال الاتصال بالرقم const {Polyline3DElement} = await google.maps.importLibrary("maps3d"). اطّلع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.
Polyline3DElement
Polyline3DElement([options])
المَعلمات: 
تنشئ هذه الدالة Polyline3DElement بالاستناد إلى الخيارات المحدّدة.
altitudeMode
النوع:  AltitudeMode optional
القيمة التلقائية: AltitudeMode.ABSOLUTE
لتحديد كيفية تفسير مكونات الارتفاع في الإحداثيات.
سمة HTML:
  • <gmp-polyline-3d altitude-mode="absolute"></gmp-polyline-3d>
  • <gmp-polyline-3d altitude-mode="clamp-to-ground"></gmp-polyline-3d>
  • <gmp-polyline-3d altitude-mode="relative-to-ground"></gmp-polyline-3d>
  • <gmp-polyline-3d altitude-mode="relative-to-mesh"></gmp-polyline-3d>
coordinates
التسلسل المُرتَّب للإحداثيات للخط المتعدّد يتم تجاهل الارتفاع في أوضاع معيّنة وبالتالي يكون اختياريًا.
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])
المَعلمات: 
  • type:  string سلسلة حسّاسة لحالة الأحرف تمثّل نوع الحدث الذي تريد الاستماع إليه.
  • listener:  EventListener|EventListenerObject العنصر الذي يتلقّى إشعارًا. يجب أن يكون هذا العنصر دالة أو كائنًا يتضمّن طريقة handleEvent.
  • options:  boolean|AddEventListenerOptions optional اطّلِع على الخيارات. لا تتيح الأحداث المخصّصة سوى capture وpassive.
القيمة المعروضة:  void
تُستخدَم لإعداد دالة سيتمّ استدعاؤها عند إرسال الحدث المحدّد إلى الهدف. راجِع addEventListener.
BetaremoveEventListener
removeEventListener(type, listener[, options])
المَعلمات: 
القيمة المعروضة:  void
تزيل هذه الوظيفة أداة معالجة حدث مسجَّلة سابقًا باستخدام addEventListener من الهدف. راجِع removeEventListener.

واجهة Polyline3DElementOptions

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

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

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

واجهة Polygon3DElementOptions

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

يُستخدم كائن Polygon3DElementOptions لتحديد الخصائص التي يمكن ضبطها على Polygon3DElement.
altitudeMode optional
النوع:  AltitudeMode optional
يمكنك الاطّلاع على Polygon3DElement.altitudeMode.
drawsOccludedSegments optional
النوع:  boolean optional
يمكنك الاطّلاع على Polygon3DElement.drawsOccludedSegments.
extruded optional
النوع:  boolean optional
يمكنك الاطّلاع على Polygon3DElement.extruded.
fillColor optional
النوع:  string optional
يمكنك الاطّلاع على Polygon3DElement.fillColor.
geodesic optional
النوع:  boolean optional
يمكنك الاطّلاع على Polygon3DElement.geodesic.
innerCoordinates optional
يمكنك الاطّلاع على Polygon3DElement.innerCoordinates.
outerCoordinates optional
يمكنك الاطّلاع على Polygon3DElement.outerCoordinates.
strokeColor optional
النوع:  string optional
يمكنك الاطّلاع على Polygon3DElement.strokeColor.
strokeWidth optional
النوع:  number optional
يمكنك الاطّلاع على Polygon3DElement.strokeWidth.
zIndex optional
النوع:  number optional
يمكنك الاطّلاع على Polygon3DElement.zIndex.

AltitudeMode الثوابت

google.maps.maps3d.AltitudeMode ثابت

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

يمكنك الوصول إليه من خلال الاتصال بالرقم const {AltitudeMode} = await google.maps.importLibrary("maps3d"). اطّلع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.
ABSOLUTE يسمح بالتعبير عن الأجسام بالنسبة إلى متوسط مستوى سطح البحر. وهذا يعني أيضًا أنه إذا تغير مستوى التضاريس تحت الكائن، سيظل موضعه المطلق كما هو.
CLAMP_TO_GROUND يسمح بعرض الأجسام الموضوعة على الأرض. وتظل على مستوى الأرض بعد التضاريس بغض النظر عن الارتفاع المحدد. إذا كان الجسم فوق مساحة مائية كبيرة، سيتم وضعه على مستوى سطح البحر.
RELATIVE_TO_GROUND يسمح بعرض الأجسام بالنسبة إلى سطح الأرض. إذا تغيّر مستوى التفاصيل في التضاريس، سيظلّ موضع الجسم ثابتًا بالنسبة إلى الأرض. فوق المياه، سيتم تفسير الارتفاع كقيمة بالأمتار فوق مستوى سطح البحر.
RELATIVE_TO_MESH يسمح بعرض الأجسام بالنسبة إلى أعلى سطح الأرض والمبنى والماء. عندما تكون فوق الماء، سيكون ذلك سطح الماء، وعندما تكون فوق التضاريس، سيكون ذلك سطح المبنى (إن توفّر) أو سطح الأرض (في حال عدم توفّر مبانٍ).