Draw on the map

MarkerElement class

google.maps.maps3d.MarkerElement class
extends HTMLElement
implements MarkerElementOptions
library "maps3d"

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

      
<gmp-marker
  altitude-mode="value-name"
  anchor-left="string"
  anchor-top="string"
  autofits-camera
  collision-behavior="value-name"
  collision-priority="number"
  position="lat,lng"
  title="string">
</gmp-marker>
const {MarkerElement} = await google.maps.importLibrary("maps3d");
MarkerElement
MarkerElement([options])
المَعلمات:
تنشئ هذه الدالة MarkerElement بالخيارات المحدّدة.
altitudeMode
attr: altitude-mode
نوع الإدخال: AltitudeMode optional
نوع الإخراج: AltitudeMode
القيمة التلقائية: AltitudeMode.CLAMP_TO_GROUND
تحدّد هذه السمة كيفية تفسير مكوّن الارتفاع في الموقع الجغرافي.
سمة HTML: altitude-mode="value-name"
anchorLeft
attr: anchor-left
نوع الإدخال: string optional
نوع الإخراج: string
القيمة التلقائية: ‎-50%
قيمة نسبة مئوية لطول CSS تُستخدَم لإزاحة نقطة الارتساء من أعلى يمين العلامة. ويكون ذلك مفيدًا عند استخدام عنصر مرئي يحتوي على نقطة ارتساء تختلف عن نقطة الوسط السفلية المعتادة للعلامة التلقائية.
سمة HTML: anchor-left="string"
anchorTop
attr: anchor-top
نوع الإدخال: string optional
نوع الإخراج: string
القيمة التلقائية: -100%
قيمة نسبة مئوية لطول CSS تُستخدَم لإزاحة نقطة الارتساء من أعلى يمين العلامة. ويكون ذلك مفيدًا عند استخدام عنصر مرئي يحتوي على نقطة ارتساء تختلف عن نقطة الوسط السفلية المعتادة للعلامة التلقائية.
سمة HTML: anchor-top="string"
AlphaautofitsCamera
attr: autofits-camera
النوع: boolean optional
القيمة التلقائية: false
في حال توفّر العلامة المحدّدة، ستظهر ضمن إطار عرض الخريطة، إلى جانب أي عناصر أخرى تم تفعيلها.
سمة HTML: autofits-camera
collisionBehavior
attr: collision-behavior
نوع الإدخال: CollisionBehavior optional
نوع الإخراج: CollisionBehavior
القيمة التلقائية: CollisionBehavior.REQUIRED
تعداد يحدّد سلوك MarkerElement عند تداخله مع MarkerElement أو Marker3DElement آخر أو مع تصنيفات خريطة الأساس.
سمة HTML: collision-behavior="value-name"
collisionPriority
attr: collision-priority
نوع الإدخال: number optional
نوع الإخراج: number optional
رقم يُستخدم للمساعدة في تحديد الأولوية النسبية بين علامات CollisionBehavior.OPTIONAL_AND_HIDES_LOWER_PRIORITY (بما في ذلك Marker3DElement). تشير قيمة collisionPriority الأعلى إلى أولوية أعلى.
سمة HTML: collision-priority="number"
position
attr: position
نوع الإدخال: LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optional
نوع الإخراج: LatLngAltitude optional
الموقع الجغرافي لطرف محدِّد الموقع الجغرافي يتم تجاهل الارتفاع في أوضاع معيّنة، وبالتالي يكون اختياريًا.
سمة HTML:
  • position="lat,lng"
  • position="lat,lng,altitude"
title
attr: title
النوع: string
نص التمرير في حال توفيره، ستتم إضافة نص تسهيل الاستخدام (على سبيل المثال، للاستخدام مع برامج قراءة الشاشة) إلى MarkerElement بالقيمة المقدَّمة.
سمة HTML: title="string"
default
سيتم وضع أي عناصر مخصّصة تمت إضافتها مباشرةً إلى MarkerElement في خانات.
z-index
تمثّل هذه السمة فهرس Z لهذه العلامة. لمزيد من التفاصيل، يمكنك الاطّلاع على مستندات z-index. تغطي العلامات المتداخلة ذات الفهرس z الأكبر تلك التي تحتوي على فهرس أصغر. يتم عرض العلامات تلقائيًا وفقًا لموضعها في نموذج DOM، حيث تظهر العلامات التي تمت إضافتها لاحقًا في نموذج DOM أمام العلامات التي تمت إضافتها إلى نموذج DOM في وقت سابق.
السمات المكتسَبة: addEventListener، removeEventListener

MarkerElementOptions interface

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

عنصر MarkerElementOptions يُستخدَم لتحديد السمات التي يمكن ضبطها في MarkerElement.

altitudeMode
اختياري
النوع: AltitudeMode optional
يمكنك الاطّلاع على MarkerElement.altitudeMode.
anchorLeft
اختياري
النوع: string optional
يمكنك الاطّلاع على MarkerElement.anchorLeft.
anchorTop
اختياري
النوع: string optional
يمكنك الاطّلاع على MarkerElement.anchorTop.
AlphaautofitsCamera
اختياري
النوع: boolean optional
يمكنك الاطّلاع على AlphaMarkerElement.autofitsCamera.
collisionBehavior
اختياري
النوع: CollisionBehavior optional
يمكنك الاطّلاع على MarkerElement.collisionBehavior.
collisionPriority
اختياري
النوع: number optional
يمكنك الاطّلاع على MarkerElement.collisionPriority.
position
اختياري
يمكنك الاطّلاع على MarkerElement.position.
title
اختياري
النوع: string optional
يمكنك الاطّلاع على MarkerElement.title.

فئة MarkerInteractiveElement

google.maps.maps3d.MarkerInteractiveElement class
extends MarkerElement
implements MarkerInteractiveElementOptions
library "maps3d"

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

<gmp-marker-interactive
  gmp-popover-target-element="popover-id">
</gmp-marker-interactive>
const {MarkerInteractiveElement} = await google.maps.importLibrary("maps3d");
MarkerInteractiveElement
MarkerInteractiveElement([options])
المَعلمات:
تنشئ هذه الدالة MarkerInteractiveElement بالخيارات المحدّدة.
gmpPopoverTargetElement
attr: gmp-popover-target-element
نوع الإدخال: PopoverElement optional
نوع الإخراج: PopoverElement optional
عند ضبط هذا الخيار، سيتم فتح عنصر النافذة المنبثقة عند النقر على هذه العلامة.
سمة HTML: gmp-popover-target-element="popover-id"
السمات المكتسَبة: altitudeMode (السمة: altitude-mode)، anchorLeft (السمة: anchor-left)، anchorTop (السمة: anchor-top)، AlphaautofitsCamera (السمة: autofits-camera)، collisionBehavior (السمة: collision-behavior)، collisionPriority (السمة: collision-priority)، position (السمة: position)، title (السمة: title)
مكتسَبة: default
مكتسَبة: z-index
السمات المكتسَبة: addEventListener، removeEventListener
gmp-click
function(clickEvent)
الوسيطات:
يتم تنشيط هذا الحدث عند النقر على العنصر MarkerInteractiveElement.

واجهة MarkerInteractiveElementOptions

google.maps.maps3d.MarkerInteractiveElementOptions interface
extends MarkerElementOptions

عنصر MarkerInteractiveElementOptions يُستخدَم لتحديد السمات التي يمكن ضبطها على MarkerInteractiveElement.

gmpPopoverTargetElement
اختياري
النوع: PopoverElement optional
يمكنك الاطّلاع على MarkerInteractiveElement.gmpPopoverTargetElement.
القيم المكتسَبة: altitudeMode، anchorLeft، anchorTop، AlphaautofitsCamera، collisionBehavior، collisionPriority، position، title

Marker3DElement class

google.maps.maps3d.Marker3DElement class
extends HTMLElement
implements Marker3DElementOptions
library "maps3d"

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

     
<gmp-marker-3d
  altitude-mode="value-name"
  autofits-camera
  collision-behavior="value-name"
  collision-priority="number"
  draws-when-occluded
  extruded
  label="string"
  position="lat,lng"
  size-preserved
  z-index="number">
</gmp-marker-3d>
const {Marker3DElement} = await google.maps.importLibrary("maps3d");
Marker3DElement
Marker3DElement([options])
المَعلمات:
تنشئ هذه الدالة Marker3DElement بالخيارات المحدّدة.
altitudeMode
attr: altitude-mode
نوع الإدخال: AltitudeMode optional
نوع الإخراج: AltitudeMode
القيمة التلقائية: AltitudeMode.CLAMP_TO_GROUND
تحدّد هذه السمة كيفية تفسير مكوّن الارتفاع في الموقع الجغرافي.
سمة HTML: altitude-mode="value-name"
AlphaautofitsCamera
attr: autofits-camera
نوع الإدخال: boolean optional
نوع الإخراج: boolean
القيمة التلقائية: false
في حال توفّر العلامة المحدّدة، ستظهر ضمن إطار عرض الخريطة، إلى جانب أي عناصر أخرى تم تفعيلها.
سمة HTML: autofits-camera
collisionBehavior
attr: collision-behavior
نوع الإدخال: CollisionBehavior optional
نوع الإخراج: CollisionBehavior
القيمة التلقائية: CollisionBehavior.REQUIRED
تعداد يحدّد كيفية تصرّف Marker3DElement عند تصادمه مع Marker3DElement آخر أو مع تصنيفات خريطة الأساس.
سمة HTML: collision-behavior="value-name"
collisionPriority
attr: collision-priority
نوع الإدخال: number optional
نوع الإخراج: number optional
أولوية التصادم المستخدَمة لرصد التصادم.
سمة HTML: collision-priority="number"
drawsWhenOccluded
attr: draws-when-occluded
نوع الإدخال: boolean optional
نوع الإخراج: boolean
القيمة التلقائية: false
تحدّد هذه السمة ما إذا كان يجب رسم هذه العلامة أم لا عندما تكون محجوبة. يمكن حجب العلامة بواسطة هندسة الخريطة (مثل المباني).
سمة HTML: draws-when-occluded
extruded
attr: extruded
نوع الإدخال: boolean optional
نوع الإخراج: boolean
القيمة التلقائية: false
تحدّد ما إذا كان سيتم ربط العلامة بالأرض. لإبراز علامة، يجب أن يكون altitudeMode إما RELATIVE_TO_GROUND أو ABSOLUTE.
سمة HTML: extruded
label
attr: label
نوع الإدخال: string optional
نوع الإخراج: string optional
النص الذي ستعرضه هذه العلامة
سمة HTML: label="string"
position
attr: position
نوع الإدخال: LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optional
نوع الإخراج: LatLngAltitude optional
الموقع الجغرافي لطرف محدِّد الموقع الجغرافي يتم تجاهل الارتفاع في أوضاع معيّنة، وبالتالي يكون اختياريًا.
سمة HTML:
  • position="lat,lng"
  • position="lat,lng,altitude"
sizePreserved
attr: size-preserved
نوع الإدخال: boolean optional
نوع الإخراج: boolean
القيمة التلقائية: false
يحدّد ما إذا كان يجب أن تحافظ هذه العلامة على حجمها أم لا بغض النظر عن المسافة من الكاميرا. يتم تلقائيًا تغيير حجم العلامة استنادًا إلى المسافة من الكاميرا أو الإمالة.
سمة HTML: size-preserved
zIndex
attr: z-index
نوع الإدخال: number optional
نوع الإخراج: number optional
‫zIndex مقارنةً بالعلامات الأخرى
سمة HTML: z-index="number"
default
سيتم وضع أي عناصر مخصّصة تتم إضافتها مباشرةً إلى Marker3DElement، ولكن سيتم استخدام عناصر من الأنواع HTMLImageElement وSVGElement وPinElement فقط لرسم العلامات، وسيتم تجاهل العناصر الأخرى.
يجب تضمين HTMLImageElement وSVGElement في عنصر <template> قبل تعيينهما إلى الخانة التلقائية لـ Marker3DElement.

يتم حاليًا تنقيط الصور وملفات SVG قبل عرضها في المشهد الثلاثي الأبعاد، لذا لن يتم تطبيق ترميز HTML المخصّص المضمّن في ملفات SVG أو فئات CSS المضافة إلى الصور، وقد لا تظهر عند عرض العلامات على الشاشة.
السمات المكتسَبة: addEventListener، removeEventListener

Marker3DElementOptions interface

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

عنصر Marker3DElementOptions يُستخدَم لتحديد السمات التي يمكن ضبطها على Marker3DElement.

altitudeMode
اختياري
النوع: AltitudeMode optional
يمكنك الاطّلاع على Marker3DElement.altitudeMode.
AlphaautofitsCamera
اختياري
النوع: boolean optional
يمكنك الاطّلاع على AlphaMarker3DElement.autofitsCamera.
collisionBehavior
اختياري
النوع: CollisionBehavior optional
يمكنك الاطّلاع على Marker3DElement.collisionBehavior.
collisionPriority
اختياري
النوع: number optional
يمكنك الاطّلاع على Marker3DElement.collisionPriority.
drawsWhenOccluded
اختياري
النوع: boolean optional
يمكنك الاطّلاع على Marker3DElement.drawsWhenOccluded.
extruded
اختياري
النوع: boolean optional
يمكنك الاطّلاع على Marker3DElement.extruded.
label
اختياري
النوع: string optional
يمكنك الاطّلاع على Marker3DElement.label.
position
اختياري
يمكنك الاطّلاع على Marker3DElement.position.
sizePreserved
اختياري
النوع: boolean optional
يمكنك الاطّلاع على Marker3DElement.sizePreserved.
zIndex
اختياري
النوع: number optional
يمكنك الاطّلاع على Marker3DElement.zIndex.

فئة Marker3DInteractiveElement

google.maps.maps3d.Marker3DInteractiveElement class
extends Marker3DElement
implements Marker3DInteractiveElementOptions
library "maps3d"

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

 
<gmp-marker-3d-interactive
  gmp-popover-target-element="popover-id"
  title="string">
</gmp-marker-3d-interactive>
const {Marker3DInteractiveElement} = await google.maps.importLibrary("maps3d");
Marker3DInteractiveElement
Marker3DInteractiveElement([options])
المَعلمات:
تنشئ هذه الدالة Marker3DInteractiveElement بالخيارات المحدّدة.
gmpPopoverTargetElement
attr: gmp-popover-target-element
نوع الإدخال: PopoverElement optional
نوع الإخراج: PopoverElement optional
عند ضبط هذا الخيار، سيتم فتح عنصر النافذة المنبثقة عند النقر على هذه العلامة.
سمة HTML: gmp-popover-target-element="popover-id"
title
attr: title
النوع: string
نص التمرير في حال توفيره، ستتم إضافة نص تسهيل الاستخدام (على سبيل المثال، للاستخدام مع برامج قراءة الشاشة) إلى Marker3DInteractiveElement بالقيمة المقدَّمة.
سمة HTML: title="string"
السمات المكتسَبة: altitudeMode (السمة: altitude-mode)، AlphaautofitsCamera (السمة: autofits-camera)، collisionBehavior (السمة: collision-behavior)، collisionPriority (السمة: collision-priority)، drawsWhenOccluded (السمة: draws-when-occluded)، extruded (السمة: extruded)، label (السمة: label)، position (السمة: position)، sizePreserved (السمة: size-preserved)، zIndex (السمة: z-index)
default
سيتم وضع أي عناصر مخصّصة تمت إضافتها مباشرةً إلى Marker3DInteractiveElement، ولكن سيتم استخدام عناصر من نوع PinElement فقط لرسم العلامات، وسيتم تجاهل العناصر الأخرى.
السمات المكتسَبة: addEventListener، removeEventListener
gmp-click
function(clickEvent)
الوسيطات:
يتم تنشيط هذا الحدث عند النقر على العنصر Marker3DInteractiveElement.

Marker3DInteractiveElementOptions interface

google.maps.maps3d.Marker3DInteractiveElementOptions interface
extends Marker3DElementOptions

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

gmpPopoverTargetElement
اختياري
النوع: PopoverElement optional
يمكنك الاطّلاع على Marker3DInteractiveElement.gmpPopoverTargetElement.
title
اختياري
النوع: string optional
يمكنك الاطّلاع على Marker3DInteractiveElement.title.
القيم المكتسَبة: altitudeMode، AlphaautofitsCamera، collisionBehavior، collisionPriority، drawsWhenOccluded، extruded، label، position، sizePreserved، zIndex

Model3DElement class

google.maps.maps3d.Model3DElement class
extends HTMLElement
implements Model3DElementOptions
library "maps3d"

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

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

    
<gmp-model-3d
  altitude-mode="value-name"
  orientation="heading,tilt,roll"
  position="lat,lng"
  scale="number"
  src="url">
</gmp-model-3d>
const {Model3DElement} = await google.maps.importLibrary("maps3d");
Model3DElement
Model3DElement([options])
المَعلمات:
تنشئ هذه الدالة Model3DElement بالخيارات المحدّدة.
altitudeMode
attr: altitude-mode
نوع الإدخال: AltitudeMode optional
نوع الإخراج: AltitudeMode
القيمة التلقائية: AltitudeMode.CLAMP_TO_GROUND
تحدّد هذه السمة كيفية تفسير الارتفاع في الموضع.
سمة HTML: altitude-mode="value-name"
orientation
attr: orientation
نوع الإدخال: Orientation3D|Orientation3DLiteral optional
نوع الإخراج: Orientation3D optional
يصف دوران نظام إحداثيات نموذج ثلاثي الأبعاد لتحديد موضع النموذج على الخريطة الثلاثية الأبعاد.

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

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

يُرجى العِلم أنّه في حال استضافة ملفات نموذج ".glb" على موقع إلكتروني أو خادم مختلفَين عن تطبيقك الرئيسي، يجب إعداد عناوين HTTP الصحيحة لسياسة مشاركة الموارد المتعددة المصادر (CORS). يتيح ذلك لتطبيقك الوصول بأمان إلى ملفات النماذج من النطاق الآخر.
سمة HTML: src="url"
السمات المكتسَبة: addEventListener، removeEventListener

Model3DElementOptions interface

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

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

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

Model3DInteractiveElement class

google.maps.maps3d.Model3DInteractiveElement class
extends Model3DElement
implements Model3DInteractiveElementOptions
library "maps3d"

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

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

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

<gmp-model-3d-interactive></gmp-model-3d-interactive>
const {Model3DInteractiveElement} = await google.maps.importLibrary("maps3d");
Model3DInteractiveElement
Model3DInteractiveElement([options])
المَعلمات:
تنشئ هذه الدالة Model3DInteractiveElement بالخيارات المحدّدة.
السمات المكتسَبة: altitudeMode (السمة: altitude-mode)، orientation (السمة: orientation)، position (السمة: position)، scale (السمة: scale)، src (السمة: src)
السمات المكتسَبة: addEventListener، removeEventListener
gmp-click
function(clickEvent)
الوسيطات:
يتم تنشيط هذا الحدث عند النقر على العنصر Model3DInteractiveElement.

Model3DInteractiveElementOptions interface

google.maps.maps3d.Model3DInteractiveElementOptions interface
extends Model3DElementOptions

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

السمات المكتسَبة: altitudeMode، orientation، position، scale، src

فئة Polyline3DElement

google.maps.maps3d.Polyline3DElement class
extends HTMLElement
implements Polyline3DElementOptions
library "maps3d"

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

      
<gmp-polyline-3d
  altitude-mode="value-name"
  autofits-camera
  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>
const {Polyline3DElement} = await google.maps.importLibrary("maps3d");
Polyline3DElement
Polyline3DElement([options])
المَعلمات:
تنشئ هذه الدالة Polyline3DElement بالخيارات المحدّدة.
altitudeMode
attr: altitude-mode
نوع الإدخال: AltitudeMode optional
نوع الإخراج: AltitudeMode
القيمة التلقائية: AltitudeMode.CLAMP_TO_GROUND
تحدّد هذه السمة كيفية تفسير مكوّنات الارتفاع في الإحداثيات.
سمة HTML: altitude-mode="value-name"
AlphaautofitsCamera
attr: autofits-camera
نوع الإدخال: boolean optional
نوع الإخراج: boolean
القيمة التلقائية: false
في حال توفيره، سيظهر الشكل المتعدّد الخطوط المحدّد ضمن إطار العرض في الخريطة، إلى جانب أي عناصر أخرى تمت الموافقة عليها.
سمة HTML: autofits-camera
drawsOccludedSegments
attr: draws-occluded-segments
نوع الإدخال: boolean optional
نوع الإخراج: boolean
القيمة التلقائية: false
تحدّد هذه السمة ما إذا كان سيتم رسم أجزاء من الخطوط المتعدّدة التي يمكن حجبها أم لا. يمكن حجب الخطوط المتعدّدة بواسطة هندسة الخريطة (مثل المباني).
سمة HTML: draws-occluded-segments
extruded
attr: extruded
نوع الإدخال: boolean optional
نوع الإخراج: boolean
القيمة التلقائية: false
تحدّد ما إذا كان سيتم ربط الخطوط المتعدّدة بالأرض. لإبراز خط متعدّد، يجب أن يكون altitudeMode إما RELATIVE_TO_GROUND أو ABSOLUTE.
سمة HTML: extruded
geodesic
attr: geodesic
نوع الإدخال: boolean optional
نوع الإخراج: boolean
القيمة التلقائية: false
عندما تكون القيمة true، يتم تفسير حواف الخطوط المتعدّدة على أنّها خطوط جيوديسية وستتبع انحناء الأرض. عندما تكون القيمة false، يتم عرض حواف الخطوط المتعدّدة كخطوط مستقيمة في مساحة الشاشة.
سمة HTML: geodesic
outerColor
attr: outer-color
نوع الإدخال: string optional
نوع الإخراج: string optional
اللون الخارجي جميع ألوان CSS3 متوافقة.
سمة HTML: outer-color="string"
outerWidth
attr: outer-width
نوع الإدخال: number optional
نوع الإخراج: number optional
يتراوح العرض الخارجي بين 0.0 و1.0. هذه نسبة مئوية من strokeWidth.
سمة HTML: outer-width="number"
path
attr: path
نوع الإدخال: Iterable<LatLngAltitude|LatLngAltitudeLiteral|LatLngLiteral> optional
نوع الإخراج: Array<LatLngAltitude> optional
التسلسل المرتَّب لإحداثيات الخطوط المتعدّدة يتم تجاهل الارتفاع في أوضاع معيّنة، وبالتالي يكون اختياريًا.
سمة HTML: path="lat1,lng1,altitude1 lat2,lng2,altitude2 lat3,lng3,altitude3 ..."
strokeColor
attr: stroke-color
نوع الإدخال: string optional
نوع الإخراج: string optional
لون الخط جميع ألوان CSS3 متوافقة.
سمة HTML: stroke-color="string"
strokeWidth
attr: stroke-width
نوع الإدخال: number optional
نوع الإخراج: number optional
عرض الخط بالبكسل
سمة HTML: stroke-width="number"
zIndex
attr: z-index
نوع الإدخال: number optional
نوع الإخراج: number optional
‫zIndex مقارنةً بالمضلّعات الأخرى
سمة HTML: z-index="number"
coordinates
التسلسل المرتَّب لإحداثيات الخطوط المتعدّدة يتم تجاهل الارتفاع في أوضاع معيّنة، وبالتالي يكون اختياريًا.
السمات المكتسَبة: addEventListener، removeEventListener

واجهة Polyline3DElementOptions

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

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

altitudeMode
اختياري
النوع: AltitudeMode optional
يمكنك الاطّلاع على Polyline3DElement.altitudeMode.
AlphaautofitsCamera
اختياري
النوع: boolean optional
يمكنك الاطّلاع على AlphaPolyline3DElement.autofitsCamera.
coordinates
اختياري
يمكنك الاطّلاع على Polyline3DElement.coordinates.
drawsOccludedSegments
اختياري
النوع: boolean optional
يمكنك الاطّلاع على Polyline3DElement.drawsOccludedSegments.
extruded
اختياري
النوع: boolean optional
يمكنك الاطّلاع على Polyline3DElement.extruded.
geodesic
اختياري
النوع: boolean optional
يمكنك الاطّلاع على Polyline3DElement.geodesic.
outerColor
اختياري
النوع: string optional
يمكنك الاطّلاع على Polyline3DElement.outerColor.
outerWidth
اختياري
النوع: number optional
يمكنك الاطّلاع على Polyline3DElement.outerWidth.
path
اختياري
يمكنك الاطّلاع على Polyline3DElement.path.
strokeColor
اختياري
النوع: string optional
يمكنك الاطّلاع على Polyline3DElement.strokeColor.
strokeWidth
اختياري
النوع: number optional
يمكنك الاطّلاع على Polyline3DElement.strokeWidth.
zIndex
اختياري
النوع: number optional
يمكنك الاطّلاع على Polyline3DElement.zIndex.

فئة Polyline3DInteractiveElement

google.maps.maps3d.Polyline3DInteractiveElement class
extends Polyline3DElement
implements Polyline3DInteractiveElementOptions
library "maps3d"

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

<gmp-polyline-3d-interactive></gmp-polyline-3d-interactive>
const {Polyline3DInteractiveElement} = await google.maps.importLibrary("maps3d");
Polyline3DInteractiveElement
Polyline3DInteractiveElement([options])
المَعلمات:
تنشئ هذه الدالة Polyline3DInteractiveElement بالخيارات المحدّدة.
السمات المكتسَبة: altitudeMode (السمة: altitude-mode)، AlphaautofitsCamera (السمة: autofits-camera)، drawsOccludedSegments (السمة: draws-occluded-segments)، extruded (السمة: extruded)، geodesic (السمة: geodesic)، outerColor (السمة: outer-color)، outerWidth (السمة: outer-width)، path (السمة: path)، strokeColor (السمة: stroke-color)، strokeWidth (السمة: stroke-width)، zIndex (السمة: z-index)، coordinates
السمات المكتسَبة: addEventListener، removeEventListener
gmp-click
function(clickEvent)
الوسيطات:
  • ‫clickEvent: LocationClickEvent optional سيحتوي عنصر الحدث على الموقع الجغرافي للنقرة من حيث خط العرض وخط الطول والارتفاع.
يتم تنشيط هذا الحدث عند النقر على العنصر Polyline3DInteractiveElement.

واجهة Polyline3DInteractiveElementOptions

google.maps.maps3d.Polyline3DInteractiveElementOptions interface
extends Polyline3DElementOptions

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

السمات المكتسَبة: altitudeMode، AlphaautofitsCamera، coordinates، drawsOccludedSegments، extruded، geodesic، outerColor، outerWidth، path، strokeColor، strokeWidth، zIndex

فئة Polygon3DElement

google.maps.maps3d.Polygon3DElement class
extends HTMLElement
implements Polygon3DElementOptions
library "maps3d"

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

    
<gmp-polygon-3d
  autofits-camera
  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>
const {Polygon3DElement} = await google.maps.importLibrary("maps3d");
Polygon3DElement
Polygon3DElement([options])
المَعلمات:
تنشئ هذه الدالة Polygon3DElement بالخيارات المحدّدة.
altitudeMode
نوع الإدخال: AltitudeMode optional
نوع الإخراج: AltitudeMode
القيمة التلقائية: AltitudeMode.CLAMP_TO_GROUND
تحدّد هذه السمة كيفية تفسير مكوّنات الارتفاع في الإحداثيات.
AlphaautofitsCamera
attr: autofits-camera
نوع الإدخال: boolean optional
نوع الإخراج: boolean
القيمة التلقائية: false
في حال توفيره، سيظهر المضلّع المحدّد ضمن إطار عرض الخريطة، إلى جانب أي عناصر أخرى تم تفعيلها.
سمة HTML: autofits-camera
drawsOccludedSegments
attr: draws-occluded-segments
نوع الإدخال: boolean optional
نوع الإخراج: boolean
القيمة التلقائية: false
يحدّد هذا الخيار ما إذا كان سيتم رسم أجزاء المضلّع التي يمكن حجبها أم لا. يمكن أن تحجب المضلّعات هندسة الخريطة (مثل المباني).
سمة HTML: draws-occluded-segments
extruded
attr: extruded
نوع الإدخال: boolean optional
نوع الإخراج: boolean
القيمة التلقائية: false
تحدّد ما إذا كان سيتم ربط المضلّع بالأرض. لإبراز مضلّع، يجب أن يكون altitudeMode إمّا RELATIVE_TO_GROUND أو ABSOLUTE.
سمة HTML: extruded
fillColor
attr: fill-color
نوع الإدخال: string optional
نوع الإخراج: string optional
لون التعبئة جميع ألوان CSS3 متوافقة.
سمة HTML: fill-color="string"
geodesic
attr: geodesic
نوع الإدخال: boolean optional
نوع الإخراج: boolean
القيمة التلقائية: false
عندما تكون القيمة true، يتم تفسير حواف المضلّع على أنّها خطوط جيوديسية وستتبع انحناء الأرض. عندما تكون القيمة false، يتم عرض حواف المضلّع كخطوط مستقيمة في مساحة الشاشة.
سمة HTML: geodesic
innerPaths
نوع الإدخال: Iterable<Iterable<LatLngAltitude|LatLngAltitudeLiteral|LatLngLiteral>> optional
نوع الإخراج: Array<Array<LatLngAltitude>> optional
التسلسل المرتّب للإحداثيات التي تحدّد حلقة مغلقة على عكس الخطوط المتعدّدة، قد يتكوّن المضلّع من مسار واحد أو أكثر، ما يؤدي إلى إنشاء أشكال مقتطعة متعدّدة داخل المضلّع.
path
attr: path
نوع الإدخال: Iterable<LatLngAltitude|LatLngAltitudeLiteral|LatLngLiteral> optional
نوع الإخراج: Array<LatLngAltitude> optional
التسلسل المرتّب للإحداثيات التي تحدّد حلقة مغلقة يتم تجاهل الارتفاع في أوضاع معيّنة، وبالتالي يكون اختياريًا.
سمة HTML: path="lat1,lng1,altitude1 lat2,lng2,altitude2 lat3,lng3,altitude3 ..."
strokeColor
attr: stroke-color
نوع الإدخال: string optional
نوع الإخراج: string optional
لون الخط جميع ألوان CSS3 متوافقة.
سمة HTML: stroke-color="string"
strokeWidth
attr: stroke-width
نوع الإدخال: number optional
نوع الإخراج: number optional
عرض الخط بالبكسل
سمة HTML: stroke-width="number"
zIndex
attr: z-index
نوع الإدخال: number optional
نوع الإخراج: number optional
‫zIndex مقارنةً بالمضلّعات الأخرى
سمة HTML: z-index="number"
outerCoordinates
التسلسل المرتّب للإحداثيات التي تحدّد حلقة مغلقة يتم تجاهل الارتفاع في أوضاع معيّنة، وبالتالي يكون اختياريًا.
innerCoordinates
التسلسل المرتّب للإحداثيات التي تحدّد حلقة مغلقة على عكس الخطوط المتعدّدة، قد يتكوّن المضلّع من مسار واحد أو أكثر، ما يؤدي إلى إنشاء أشكال مقتطعة متعدّدة داخل المضلّع.
السمات المكتسَبة: addEventListener، removeEventListener

Polygon3DElementOptions interface

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

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

altitudeMode
اختياري
النوع: AltitudeMode optional
يمكنك الاطّلاع على Polygon3DElement.altitudeMode.
AlphaautofitsCamera
اختياري
النوع: boolean optional
يمكنك الاطّلاع على AlphaPolygon3DElement.autofitsCamera.
drawsOccludedSegments
اختياري
النوع: boolean optional
يمكنك الاطّلاع على Polygon3DElement.drawsOccludedSegments.
extruded
اختياري
النوع: boolean optional
يمكنك الاطّلاع على Polygon3DElement.extruded.
fillColor
اختياري
النوع: string optional
يمكنك الاطّلاع على Polygon3DElement.fillColor.
geodesic
اختياري
النوع: boolean optional
يمكنك الاطّلاع على Polygon3DElement.geodesic.
innerCoordinates
اختياري
يمكنك الاطّلاع على Polygon3DElement.innerCoordinates.
innerPaths
اختياري
يمكنك الاطّلاع على Polygon3DElement.innerPaths.
outerCoordinates
اختياري
يمكنك الاطّلاع على Polygon3DElement.outerCoordinates.
path
اختياري
يمكنك الاطّلاع على Polygon3DElement.path.
strokeColor
اختياري
النوع: string optional
يمكنك الاطّلاع على Polygon3DElement.strokeColor.
strokeWidth
اختياري
النوع: number optional
يمكنك الاطّلاع على Polygon3DElement.strokeWidth.
zIndex
اختياري
النوع: number optional
يمكنك الاطّلاع على Polygon3DElement.zIndex.

فئة Polygon3DInteractiveElement

google.maps.maps3d.Polygon3DInteractiveElement class
extends Polygon3DElement
implements Polygon3DInteractiveElementOptions
library "maps3d"

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

<gmp-polygon-3d-interactive></gmp-polygon-3d-interactive>
const {Polygon3DInteractiveElement} = await google.maps.importLibrary("maps3d");
Polygon3DInteractiveElement
Polygon3DInteractiveElement([options])
المَعلمات:
تنشئ هذه الدالة Polygon3DInteractiveElement بالخيارات المحدّدة.
السمات المكتسَبة: altitudeMode، AlphaautofitsCamera (السمة: autofits-camera)، drawsOccludedSegments (السمة: draws-occluded-segments)، extruded (السمة: extruded)، fillColor (السمة: fill-color)، geodesic (السمة: geodesic)، innerPaths، path (السمة: path)، strokeColor (السمة: stroke-color)، strokeWidth (السمة: stroke-width)، zIndex (السمة: z-index)، outerCoordinates، innerCoordinates
السمات المكتسَبة: addEventListener، removeEventListener
gmp-click
function(clickEvent)
الوسيطات:
  • ‫clickEvent: LocationClickEvent optional سيحتوي عنصر الحدث على الموقع الجغرافي للنقرة من حيث خط العرض وخط الطول والارتفاع.
يتم تنشيط هذا الحدث عند النقر على العنصر Polygon3DInteractiveElement.

Polygon3DInteractiveElementOptions interface

google.maps.maps3d.Polygon3DInteractiveElementOptions interface
extends Polygon3DElementOptions

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

السمات المكتسَبة: altitudeMode، AlphaautofitsCamera، drawsOccludedSegments، extruded، fillColor، geodesic، innerCoordinates، innerPaths، outerCoordinates، path، strokeColor، strokeWidth، zIndex

فئة FlattenerElement

google.maps.maps3d.FlattenerElement class
extends HTMLElement
implements FlattenerElementOptions
library "maps3d"

يُستخدَم عنصر التسوية لتسوية منطقة محدّدة على الخريطة.

<gmp-flattener
  path="lat1,lng1,altitude1 lat2,lng2,altitude2 lat3,lng3,altitude3 ...">
</gmp-flattener>
const {FlattenerElement} = await google.maps.importLibrary("maps3d");
FlattenerElement
FlattenerElement([options])
المَعلمات:
innerPaths
نوع الإدخال: Iterable<Iterable<LatLngAltitude|LatLngAltitudeLiteral|LatLngLiteral>> optional
نوع الإخراج: Array<Array<LatLngAltitude>> optional
التسلسل المرتّب للإحداثيات التي تحدّد حلقة مغلقة تحدّد هذه المسارات "ثقوب الاستبعاد" ضمن المسار الرئيسي للمضلّع، وهو "منطقة التسوية". يتم استثناء المناطق داخل innerPath من التسوية.
path
attr: path
نوع الإدخال: Iterable<LatLngAltitude|LatLngAltitudeLiteral|LatLngLiteral> optional
نوع الإخراج: Array<LatLngAltitude> optional
التسلسل المرتّب للإحداثيات التي تحدّد حلقة مغلقة تحدّد هذه الحلقة "منطقة التسوية".
سمة HTML: path="lat1,lng1,altitude1 lat2,lng2,altitude2 lat3,lng3,altitude3 ..."
السمات المكتسَبة: addEventListener، removeEventListener

FlattenerElementOptions interface

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

عنصر FlattenerElementOptions يُستخدَم لتحديد السمات التي يمكن ضبطها في FlattenerElement.

innerPaths
اختياري
يمكنك الاطّلاع على FlattenerElement.innerPaths.
path
اختياري
يمكنك الاطّلاع على FlattenerElement.path.

فئة PopoverElement

google.maps.maps3d.PopoverElement class
extends HTMLElement
implements PopoverElementOptions
library "maps3d"

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

<gmp-popover
  auto-pan-disabled
  light-dismiss-disabled
  open
  position-anchor="lat,lng">
</gmp-popover>
const {PopoverElement} = await google.maps.importLibrary("maps3d");
PopoverElement
PopoverElement([options])
المَعلمات:
altitudeMode
نوع الإدخال: AltitudeMode optional
نوع الإخراج: AltitudeMode
القيمة التلقائية: AltitudeMode.CLAMP_TO_GROUND
تحدّد هذه السمة كيفية تفسير مكوّن الارتفاع في الموقع الجغرافي.
autoPanDisabled
attr: auto-pan-disabled
نوع الإدخال: boolean optional
نوع الإخراج: boolean
القيمة التلقائية: false
في حال ضبطها على "صحيح"، يتم إيقاف تحريك الخريطة لإظهار النافذة المنبثقة بالكامل عند فتحها.
سمة HTML: auto-pan-disabled
lightDismissDisabled
attr: light-dismiss-disabled
نوع الإدخال: boolean optional
نوع الإخراج: boolean
القيمة التلقائية: false
تحدّد هذه السمة ما إذا كان يجب إغلاق النافذة المنبثقة عند النقر خارجها أم لا. يشبه سلوك "الإغلاق السريع" ضبط السمة popover="auto" التي تشكّل جزءًا من Popover API في المتصفّح.
سمة HTML: light-dismiss-disabled
open
attr: open
نوع الإدخال: boolean optional
نوع الإخراج: boolean
القيمة التلقائية: false
تحدّد ما إذا كان يجب فتح هذه النافذة المنبثقة أم لا.
سمة HTML: open
positionAnchor
attr: position-anchor
تمثّل هذه السمة الموضع الذي سيتم فيه عرض هذه النافذة المنبثقة. إذا كانت النافذة المنبثقة مثبّتة بعلامة تفاعلية، سيتم استخدام موضع العلامة بدلاً من ذلك.
سمة HTML:
  • position-anchor="lat,lng"
  • position-anchor="lat,lng,altitude"
  • position-anchor="marker-id"
default
يضع المحتوى المخصّص في القسم الرئيسي من النافذة المنبثقة.
header
يضع المحتوى المخصّص في قسم العنوان في النافذة المنبثقة.
--gmp-popover-max-width
الحد الأقصى لعرض النافذة المنبثقة، بغض النظر عن عرض المحتوى
--gmp-popover-min-width
الحد الأدنى لعرض النافذة المنبثقة، بغض النظر عن عرض المحتوى عند استخدام هذه السمة، ننصح بشدة بضبطها على قيمة أقل من عرض الخريطة (بالبكسل).
--gmp-popover-pixel-offset-x
تمثّل هذه السمة الإزاحة على المحور x، بالبكسل، لطرف النافذة المنبثقة من النقطة على الخريطة التي تم تثبيت النافذة المنبثقة عندها وفقًا لإحداثياتها الجغرافية.
--gmp-popover-pixel-offset-y
تمثّل هذه السمة الإزاحة على المحور Y، بالبكسل، لطرف النافذة المنبثقة من النقطة على الخريطة التي تم تثبيت النافذة المنبثقة عندها وفقًا لإحداثياتها الجغرافية.
background-color
لون خلفية النافذة المنبثقة لمزيد من التفاصيل، يمكنك الاطّلاع على مستندات background-color. يُرجى العِلم أنّ هذه السمة تؤثر أيضًا في النافذة المنبثقة التلقائية للمكان. استخدِم فئات CSS مستهدَفة أو أنماطًا مضمّنة في النوافذ المنبثقة المخصّصة لتجنُّب تطبيق الأنماط على النافذة المنبثقة التلقائية للمكان.
border-radius
تمثّل هذه السمة نصف قطر حدود النافذة المنبثقة. لمزيد من التفاصيل، يمكنك الاطّلاع على مستندات border-radius. يُرجى العِلم أنّ هذه السمة تؤثر أيضًا في النافذة المنبثقة التلقائية للمكان. استخدِم فئات CSS مستهدَفة أو أنماطًا مضمّنة في النوافذ المنبثقة المخصّصة لتجنُّب تطبيق الأنماط على النافذة المنبثقة التلقائية للمكان.
box-shadow
تمثّل هذه السمة ظل المربّع للنافذة المنبثقة. لمزيد من التفاصيل، يمكنك الاطّلاع على مستندات box-shadow. يُرجى العِلم أنّ هذه السمة تؤثر أيضًا في النافذة المنبثقة التلقائية للمكان. استخدِم فئات CSS مستهدَفة أو أنماطًا مضمّنة في النوافذ المنبثقة المخصّصة لتجنُّب تطبيق الأنماط على النافذة المنبثقة التلقائية للمكان.
color-scheme
يشير هذا الحقل إلى نظام الألوان الذي يمكن عرض هذه النافذة المنبثقة به. لمزيد من التفاصيل، يمكنك الاطّلاع على مستندات color-scheme. وفي حال عدم تحديدها، يتم ضبطها تلقائيًا على الإعدادات المفضّلة للمستخدم في ما يتعلّق بنظام الألوان.
padding
المساحة المتروكة للنافذة المنبثقة لمزيد من التفاصيل، يمكنك الاطّلاع على مستندات padding. يُرجى العِلم أنّ هذه السمة تؤثر أيضًا في النافذة المنبثقة التلقائية للمكان. استخدِم فئات CSS مستهدَفة أو أنماطًا مضمّنة في النوافذ المنبثقة المخصّصة لتجنُّب تطبيق الأنماط على النافذة المنبثقة التلقائية للمكان.
السمات المكتسَبة: addEventListener، removeEventListener

واجهة PopoverElementOptions

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

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

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

ثوابت AltitudeMode

google.maps.maps3d.AltitudeMode ثوابت
مكتبة "maps3d"

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

ويمكن أيضًا استخدام هذه الثوابت كسلاسل. في TypeScript، يتم تحديد سلاسل القيم الثابتة حسب النوع AltitudeModeString.

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

فئة CirclePathElement

google.maps.maps3d.CirclePathElement class
extends HTMLElement
implements CirclePathElementOptions
library "maps3d"

طبقة دائرية ثلاثية الأبعاد على خريطة ثلاثية الأبعاد

 
<gmp-circle-path
  center="lat,lng,altitude"
  radius="number">
</gmp-circle-path>
const {CirclePathElement} = await google.maps.importLibrary("maps3d");
CirclePathElement
CirclePathElement([options])
المَعلمات:
تنشئ هذه الدالة CirclePathElement بالخيارات المحدّدة.
center
attr: center
نوع الإدخال: LatLngAltitude|LatLngAltitudeLiteral|LatLngLiteral optional
نوع الإخراج: LatLngAltitude optional
مركز الدائرة
سمة HTML: center="lat,lng,altitude"
radius
attr: radius
نوع الإدخال: number optional
نوع الإخراج: number optional
نصف قطر الدائرة بالمتر
سمة HTML: radius="number"
السمات المكتسَبة: addEventListener، removeEventListener

CirclePathElementOptions interface

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

عنصر CirclePathElementOptions يُستخدَم لتحديد السمات التي يمكن ضبطها على CirclePathElement.

center
اختياري
يمكنك الاطّلاع على CirclePathElement.center.
radius
اختياري
النوع: number optional
يمكنك الاطّلاع على CirclePathElement.radius.