Directions

فئة DirectionsService

google.maps.DirectionsService صف

خدمة لحساب الاتجاهات بين مكانَين أو أكثر

يمكنك الوصول إلى الدعم من خلال الاتصال بالرقم const {DirectionsService} = await google.maps.importLibrary("routes").
اطّلِع على المكتبات في Maps JavaScript API.
DirectionsService
DirectionsService()
المَعلمات:  بدون
تُنشئ هذه السمة مثيلاً جديدًا من DirectionsService يُرسِل طلبات البحث عن الاتجاهات إلى خوادم Google.
route
route(request[, callback])
المَعلمات: 
قيمة العائد:  Promise<DirectionsResult>
إرسال طلب بحث عن الاتجاهات

واجهة DirectionsRequest

google.maps.DirectionsRequest interface

طلب البحث عن الاتجاهات الذي سيتم إرساله إلى DirectionsService
destination
النوع:  string|LatLng|Place|LatLngLiteral
تمثّل هذه السمة الموقع الجغرافي للوجهة. يمكن تحديد ذلك كسلسلة سيتم تحويلها إلى ترميز جغرافي، أو LatLng، أو Place. الحقل مطلوب.
origin
النوع:  string|LatLng|Place|LatLngLiteral
موقع المنشأ يمكن تحديد ذلك كسلسلة سيتم تحويلها إلى ترميز جغرافي، أو LatLng، أو Place. الحقل مطلوب.
travelMode
النوع:  TravelMode
نوع التوجيه المطلوب. الحقل مطلوب.
avoidFerries optional
النوع:  boolean optional
إذا كانت القيمة true، يطلب ذلك من خدمة "الاتجاهات" تجنُّب العبّارات حيثما أمكن ذلك. اختياريّ.
avoidHighways optional
النوع:  boolean optional
إذا كانت القيمة true، يطلب ذلك من خدمة "الاتجاهات" تجنُّب الطرق السريعة حيثما أمكن. اختياريّ.
avoidTolls optional
النوع:  boolean optional
إذا كانت القيمة true، يطلب ذلك من خدمة "الاتجاهات" تجنُّب الطرق التي تتطلّب دفع رسوم عبور حيثما أمكن ذلك. اختياريّ.
drivingOptions optional
النوع:  DrivingOptions optional
الإعدادات التي تنطبق فقط على الطلبات التي تكون فيها قيمة travelMode هي DRIVING لن يكون لهذا العنصر أي تأثير في وسائل النقل الأخرى.
language optional
النوع:  string optional
معرّف اللغة التي يجب عرض النتائج بها، إذا كان ذلك ممكنًا اطّلِع على قائمة اللغات المتاحة.
optimizeWaypoints optional
النوع:  boolean optional
إذا تم ضبطها على true، ستحاول DirectionsService إعادة ترتيب نقاط المرور الوسيطة المقدَّمة لتقليل التكلفة الإجمالية للمسار. في حال تم تحسين نقاط الطريق، افحص DirectionsRoute.waypoint_order في الرد لتحديد الترتيب الجديد.
provideRouteAlternatives optional
النوع:  boolean optional
تحديد ما إذا كان يجب توفير بدائل للمسار أم لا اختياريّ.
region optional
النوع:  string optional
رمز المنطقة المستخدَم كعامل تحيّز لطلبات الترميز الجغرافي. يقبل رمز المنطقة قيمة ccTLD ("نطاق المستوى الأعلى") مكوّنة من حرفَين. تتطابق معظم رموز نطاقات المستوى الأعلى لرمز البلد مع رموز ISO 3166-1، مع بعض الاستثناءات البارزة. على سبيل المثال، رمز ccTLD الخاص بالمملكة المتحدة هو "uk" (.co.uk)، بينما رمز ISO 3166-1 هو "gb" (وهو يشير من الناحية الفنية إلى "المملكة المتحدة لبريطانيا العظمى وأيرلندا الشمالية").
transitOptions optional
النوع:  TransitOptions optional
الإعدادات التي تنطبق فقط على الطلبات التي تكون فيها قيمة travelMode هي TRANSIT لن يكون لهذا العنصر أي تأثير في وسائل النقل الأخرى.
unitSystem optional
النوع:  UnitSystem optional
القيمة التلقائية: نظام الوحدات المستخدَم في بلد المنشأ
نظام الوحدات المفضّل استخدامه عند عرض المسافة
waypoints optional
النوع:  Array<DirectionsWaypoint> optional
مصفوفة نقاط المرور الوسيطة. يتم احتساب الاتجاهات من نقطة البداية إلى الوجهة مرورًا بكل نقطة طريق في هذه المصفوفة. يمكنك الاطّلاع على دليل المطوّر لمعرفة الحد الأقصى المسموح به لعدد نقاط الطريق. لا تتوفّر نقاط على المسار لاتجاهات النقل العام. اختياريّ.

ثوابت DirectionsStatus

google.maps.DirectionsStatus الثوابت

الحالة التي يعرضها DirectionsService عند اكتمال مكالمة إلى route() يمكنك تحديدها حسب القيمة أو باستخدام اسم الثابت. على سبيل المثال، 'OK' أو google.maps.DirectionsStatus.OK.

يمكنك الوصول إلى الدعم من خلال الاتصال بالرقم const {DirectionsStatus} = await google.maps.importLibrary("routes").
اطّلِع على المكتبات في Maps JavaScript API.
INVALID_REQUEST كانت قيمة DirectionsRequest المقدَّمة غير صالحة.
MAX_WAYPOINTS_EXCEEDED تم تقديم عدد كبير جدًا من DirectionsWaypoint في DirectionsRequest. يمكنك الاطّلاع على دليل المطوّر لمعرفة الحد الأقصى المسموح به لعدد نقاط الطريق.
NOT_FOUND تعذّر ترميز موقع جغرافي واحد على الأقل من المواقع الأصلية أو الوجهات أو نقاط المرور.
OK يحتوي الردّ على DirectionsResult صالح.
OVER_QUERY_LIMIT تجاوزت صفحة الويب الحدّ الأقصى لعدد الطلبات في فترة زمنية قصيرة جدًا.
REQUEST_DENIED لا يُسمح لصفحة الويب باستخدام خدمة الاتجاهات.
UNKNOWN_ERROR تعذّر معالجة طلب الاتجاهات بسبب حدوث خطأ في الخادم. قد ينجح الطلب إذا أعدت المحاولة.
ZERO_RESULTS لم يتم العثور على أي مسار بين نقطة الانطلاق والوجهة.

واجهة DirectionsResult

google.maps.DirectionsResult interface

استجابة الاتجاهات التي تم استردادها من خادم الاتجاهات يمكنك عرض هذه العناصر باستخدام DirectionsRenderer أو تحليل هذا العنصر وعرضه بنفسك. يجب عرض التحذيرات وحقوق الطبع والنشر كما هو موضّح في بنود خدمة "منصة خرائط Google". يُرجى العِلم أنّه على الرغم من أنّ هذه النتيجة "تشبه JSON"، إلا أنّها ليست JSON تمامًا، لأنّها تتضمّن بشكل غير مباشر عناصر LatLng.
request
النوع:  DirectionsRequest
تمثّل هذه السمة طلب DirectionsRequest الذي أدّى إلى ظهور هذه النتيجة.
routes
النوع:  Array<DirectionsRoute>
مصفوفة من DirectionsRoute، يحتوي كل منها على معلومات حول الأجزاء والخطوات التي يتكوّن منها. لن يكون هناك سوى مسار واحد ما لم يتم إنشاء DirectionsRequest مع ضبط provideRouteAlternatives على true.
available_travel_modes optional
النوع:  Array<TravelMode> optional
يحتوي على مصفوفة من وسائل النقل المتاحة. يتم عرض هذا الحقل عندما يحدّد طلب وسيلة نقل ولا يحصل على أي نتائج. تحتوي المصفوفة على وسائل النقل المتاحة في بلدان مجموعة نقاط الطريق المحدّدة. لا يتم عرض هذا الحقل إذا كانت إحدى نقاط الطريق أو أكثر هي "نقاط طريق عبر".
geocoded_waypoints optional
النوع:  Array<DirectionsGeocodedWaypoint> optional
مصفوفة من DirectionsGeocodedWaypoint، يحتوي كل منها على معلومات حول الترميز الجغرافي للمصدر والوجهة ونقاط المرور.

فئة DirectionsRenderer

google.maps.DirectionsRenderer صف

تعرض هذه السمة الاتجاهات التي تم الحصول عليها من DirectionsService.

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

يمكنك الوصول إلى الدعم من خلال الاتصال بالرقم const {DirectionsRenderer} = await google.maps.importLibrary("routes").
اطّلِع على المكتبات في Maps JavaScript API.
DirectionsRenderer
DirectionsRenderer([opts])
المَعلمات: 
تنشئ هذه الدالة أداة العرض بالخيارات المحدّدة. يمكن عرض الاتجاهات على خريطة (كتراكبات مرئية) أو بالإضافة إلى ذلك على لوحة <div> (كتعليمات نصية).
getDirections
getDirections()
المَعلمات:  بدون
قيمة العائد:  DirectionsResult
تعرض هذه السمة مجموعة الاتجاهات الحالية الخاصة بأداة العرض.
getMap
getMap()
المَعلمات:  بدون
قيمة العائد:  Map
تعرض هذه السمة الخريطة التي يتم عرض DirectionsResult عليها.
getPanel
getPanel()
المَعلمات:  بدون
قيمة العائد:  HTMLElement|null
تعرض هذه السمة اللوحة <div> التي يتم عرض DirectionsResult فيها.
getRouteIndex
getRouteIndex()
المَعلمات:  بدون
قيمة العائد:  number
تعرض هذه الطريقة فهرس المسار الحالي (بدءًا من الصفر) الذي يستخدمه الكائن DirectionsRenderer.
setDirections
setDirections(directions)
المَعلمات: 
القيمة المعروضة:  لا شيء
اضبط أداة العرض لاستخدام النتيجة من DirectionsService. سيؤدي ضبط مجموعة صالحة من الاتجاهات بهذه الطريقة إلى عرض الاتجاهات على الخريطة واللوحة المخصّصتَين في أداة العرض.
setMap
setMap(map)
المَعلمات: 
القيمة المعروضة:  لا شيء
تحدّد هذه الطريقة الخريطة التي سيتم عرض الاتجاهات عليها. انقر على null لإزالة الاتجاهات من الخريطة.
setOptions
setOptions(options)
المَعلمات: 
القيمة المعروضة:  لا شيء
تغيير إعدادات خيارات حساب DirectionsRenderer هذا بعد عملية الإعداد
setPanel
setPanel(panel)
المَعلمات: 
القيمة المعروضة:  لا شيء
تعرض هذه الطريقة الاتجاهات في <div>. مرِّر null لإزالة المحتوى من اللوحة.
setRouteIndex
setRouteIndex(routeIndex)
المَعلمات: 
  • routeIndex:  number
القيمة المعروضة:  لا شيء
اضبط فهرس المسار (الذي يبدأ من الصفر) في الكائن DirectionsResult المطلوب عرضه. سيتم تلقائيًا عرض المسار الأول في المصفوفة.
موروثة: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
directions_changed
function()
الوسيطات:  لا شيء
يتم تنشيط هذا الحدث عند تغيير الاتجاهات المعروضة، إما عند ضبط DirectionsResult جديد أو عندما ينتهي المستخدم من سحب تغيير إلى مسار الاتجاهات.

واجهة DirectionsRendererOptions

google.maps.DirectionsRendererOptions interface

يحدّد هذا العنصر السمات التي يمكن ضبطها على عنصر DirectionsRenderer.
directions optional
النوع: