Routes Widget

فئة Route3DElement

class google.maps.routes.Route3DElement extends HTMLElement implements Route3DElementOptions
library "routes"

مكوّن ويب لعرض المسارات الثلاثية الأبعاد تتيح حاليًا مَعلمات نقطة الانطلاق والوجهة لعرض خطوط متعدّدة في مساحة ثلاثية الأبعاد في خريطة ثلاثية الأبعاد.

<gmp-route-3d
  autofits-camera
  departure-time="####-##-##T##:##Z"
  destination="lat,lng"
  internal-usage-attribution-ids="space separated strings"
  origin="lat,lng"
  routing-preference="value-name"
  traffic-polylines-disabled
  travel-mode="value-name">
</gmp-route-3d>
const {Route3DElement} = await google.maps.importLibrary("routes");
Route3DElement
Route3DElement([options])
المَعلمات:
تنشئ هذه الدالة Route3DElement بالخيارات المحدّدة.
autofitsCamera
attr: autofits-camera
نوع الإدخال: boolean optional
نوع الإخراج: boolean
القيمة التلقائية: false
في حال توفيره، سيظهر المسار المحدّد ضمن إطار عرض الخريطة، إلى جانب أي عناصر أخرى تم تفعيلها.
سمة HTML: autofits-camera
departureTime
attr: departure-time
نوع الإدخال: Date optional
نوع الإخراج: Date optional
في حال توفيره، سيتم احتساب المسار باستخدام وقت المغادرة المحدّد. عند تحديد التاريخ عبر سمة HTML، استخدِم تنسيق ISO 8601 للحصول على نتائج موثوقة على جميع المتصفّحات. للحصول على معلومات حول متطلبات الاستخدام، يُرجى الاطّلاع على ComputeRoutesRequest.departureTime.
سمة HTML: departure-time="####-##-##T##:##Z"
destination
attr: destination
نوع الإدخال: string|LatLng|LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral|Place optional
نوع الإخراج: string|LatLng|LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral|Place optional
وجهة المسار
سمة HTML:
  • destination="lat,lng"
  • destination="places/###"
  • destination="address"
fallbackInfo
readonly
النوع: FallbackInfo optional
معلومات احتياطية للمسارات المحسوبة
geocodingResults
readonly
النوع: GeocodingResults optional
نتائج الترميز الجغرافي لنقطة الانطلاق والوجهة
internalUsageAttributionIds
attr: internal-usage-attribution-ids
نوع الإدخال: Iterable<string> optional
نوع الإخراج: Array<string> optional
المعرّفات المستخدَمة لتحديد مصدر الطلبات من حِزم معيّنة أو مكتبات برامج مفتوحة المصدر
سمة HTML: internal-usage-attribution-ids="space separated strings"
origin
attr: origin
نوع الإدخال: string|LatLng|LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral|Place optional
نوع الإخراج: string|LatLng|LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral|Place optional
نقطة انطلاق المسار
سمة HTML:
  • origin="lat,lng"
  • origin="places/###"
  • origin="address"
routes
readonly
النوع: Array<Route> optional
المسار الأساسي مع المسارات البديلة الاختيارية، والتي يتم احتسابها من Routes API
routingPreference
attr: routing-preference
نوع الإدخال: RoutingPreference optional
نوع الإخراج: RoutingPreference optional
في حال توفّر هذه المعلومات، سيتم احتساب المسار باستخدام معلومات حركة المرور على طول المسار استنادًا إلى RoutingPreference المحدّد، واستخدام ألوان خاصة بحركة المرور.
سمة HTML: routing-preference="value-name"
trafficPolylinesDisabled
attr: traffic-polylines-disabled
نوع الإدخال: boolean optional
نوع الإخراج: boolean
القيمة التلقائية: false
ما إذا كان سيتم إيقاف الخطوط المتعدّدة التي تراعي حركة المرور لا تتوفّر الخطوط المتعدّدة التي تراعي حركة المرور إلا عند ضبط routingPreference على TRAFFIC_AWARE أو TRAFFIC_AWARE_OPTIMAL.
سمة HTML: traffic-polylines-disabled
travelMode
attr: travel-mode
نوع الإدخال: TravelMode optional
نوع الإخراج: TravelMode optional
وفي حال توفيره، يستند الشكل المتعدّد الخطوط إلى وسيلة النقل المحدّدة.
سمة HTML: travel-mode="value-name"
السمات المكتسَبة: addEventListener، removeEventListener
Alphagmp-error
function(routeInitializationErrorEvent)
الوسيطات:
  • routeInitializationErrorEvent: Event optional
يتم تنشيط هذا الحدث عند تعذُّر تحميل المسار.
Alphagmp-load
function(routeInitializationSuccessEvent)
الوسيطات:
  • routeInitializationSuccessEvent: Event optional
يتم تنشيط هذا الحدث عند تحميل المسار بنجاح.

واجهة Route3DElementOptions

interface google.maps.routes.Route3DElementOptions
implemented by Route3DElement

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

autofitsCamera
اختياري
النوع: boolean optional
ما إذا كنت تريد تفعيل ميزة ضبط الكاميرا تلقائيًا على المسار أم لا
departureTime
اختياري
النوع: Date optional
يمكنك الاطّلاع على Route3DElement.departureTime.
destination
اختياري
يمكنك الاطّلاع على Route3DElement.destination.
internalUsageAttributionIds
اختياري
النوع: Iterable<string> optional
المعرّفات المستخدَمة لتحديد مصدر الطلبات من حِزم معيّنة أو مكتبات برامج مفتوحة المصدر
origin
اختياري
يمكنك الاطّلاع على Route3DElement.origin.
routingPreference
اختياري
النوع: RoutingPreference optional
يمكنك الاطّلاع على Route3DElement.routingPreference.
trafficPolylinesDisabled
اختياري
النوع: boolean optional
ما إذا كان سيتم إيقاف الخطوط المتعدّدة التي تراعي حركة المرور لا تتوفّر الخطوط المتعدّدة التي تراعي حركة المرور إلا عند ضبط routingPreference على TRAFFIC_AWARE أو TRAFFIC_AWARE_OPTIMAL.
travelMode
اختياري
النوع: TravelMode optional
يمكنك الاطّلاع على Route3DElement.travelMode.