Elevation Widget (alpha)

فئة ElevationElement

google.maps.elevation.ElevationElement صف

عنصر HTML يعرض بيانات الارتفاع بشكل مرئي. اضبط السمة path للعنصر لعرض رسم بياني للارتفاع على طول المسار. لاستخدام "عنصر الارتفاع"، فعِّل Places UI Kit API لمشروعك في Google Cloud Console.

العنصر المخصّص:
<gmp-elevation unit-system="imperial"></gmp-elevation>

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

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

يمكنك الوصول إلى الدعم من خلال الاتصال بالرقم const {ElevationElement} = await google.maps.importLibrary("elevation").
اطّلِع على المكتبات في Maps JavaScript API.
ElevationElement
ElevationElement([options])
المَعلمات: 
path
النوع:  Array<LatLng|LatLngLiteral|LatLngAltitude> optional
المسار الذي سيتم عرض بيانات الارتفاع عليه سيتم استيفاء القطع المستقيمة بين نقاط المصفوفة، وحتى عدد صغير من النقاط سيؤدي إلى إنشاء رسم بياني تفصيلي للارتفاع.
إذا تم توفير نقطة واحدة فقط، سيعرض التطبيق المصغّر رقم الارتفاع لتلك النقطة.
unitSystem
النوع:  UnitSystem optional
تحدّد ما إذا كان سيتم عرض الارتفاع بالأقدام/الأميال أو الأمتار/الكيلومترات. وفي حال عدم تحديدها، سيستخدم التطبيق المصغّر تلقائيًا نظام الوحدات المفضّل للمنطقة المحدّدة في أداة تحميل واجهة برمجة التطبيقات.
سمة HTML:
  • <gmp-elevation unit-system="imperial"></gmp-elevation>
  • <gmp-elevation unit-system="metric"></gmp-elevation>
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-load
function(event)
الوسيطات: 
يتم تنشيط هذا الحدث عندما يتم تحميل العنصر وعرض محتواه. لا يظهر هذا الحدث.
gmp-requesterror
function(event)
الوسيطات: 
يتم إطلاق هذا الحدث عندما يتم رفض طلب إلى الخلفية (مثل مفتاح واجهة برمجة تطبيقات غير صحيح). لا يظهر هذا الحدث.

واجهة ElevationElementOptions

google.maps.elevation.ElevationElementOptions interface

خيارات ElevationElement
path optional
النوع:  Array<LatLng|LatLngLiteral> optional
عرض ElevationElement.path
unitSystem optional
النوع:  UnitSystem optional
عرض ElevationElement.unitSystem