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
النوع:  DirectionsResult optional
الاتجاهات التي سيتم عرضها على الخريطة و/أو في لوحة <div>، ويتم استردادها كعنصر DirectionsResult من DirectionsService
draggable optional
النوع:  boolean optional
إذا كانت القيمة true، يسمح ذلك للمستخدم بسحب مسارات الطرق التي يعرضها هذا العنصر DirectionsRenderer وتعديلها.
hideRouteList optional
النوع:  boolean optional
القيمة التلقائية: false
تشير هذه السمة إلى ما إذا كان يجب أن يوفّر العارض قائمة بالمسارات التي يمكن للمستخدم اختيارها وتظهر في لوحة الاتجاهات.
infoWindow optional
النوع:  InfoWindow optional
InfoWindow الذي سيتم فيه عرض معلومات نصية عند النقر على علامة. سيتم استبدال محتوى نافذة المعلومات الحالية ونقل موضعها. في حال عدم تحديد نافذة معلومات، ستنشئ DirectionsRenderer نافذة معلومات خاصة بها وتستخدمها. سيتم تجاهل هذه السمة إذا تم ضبط suppressInfoWindows على true.
map optional
النوع:  Map optional
الخريطة التي سيتم عرض الاتجاهات عليها
markerOptions optional
النوع:  MarkerOptions optional
خيارات العلامات ستستخدم جميع العلامات التي يعرضها DirectionsRenderer هذه الخيارات.
panel optional
النوع:  HTMLElement optional
<div> التي سيتم فيها عرض خطوات الاتجاهات
polylineOptions optional
النوع:  PolylineOptions optional
خيارات الخطوط المتعددة ستستخدم جميع الخطوط المتعددة الأضلاع التي يعرضها DirectionsRenderer هذه الخيارات.
preserveViewport optional
النوع:  boolean optional
القيمة التلقائية: false
إذا تم ضبط هذا الخيار على true أو لم يتم ضبط مركز الخريطة ومستوى تكبيرها مطلقًا، سيتم توسيط خريطة الإدخال وتكبيرها إلى المربّع المحيط بمجموعة الاتجاهات هذه.
routeIndex optional
النوع:  number optional
فهرس المسار ضمن العنصر DirectionsResult القيمة التلقائية هي 0.
suppressBicyclingLayer optional
النوع:  boolean optional
إيقاف عرض BicyclingLayer عند طلب اتّجاهات ركوب الدرّاجات
suppressInfoWindows optional
النوع:  boolean optional
إيقاف عرض نوافذ المعلومات
suppressMarkers optional
النوع:  boolean optional
إيقاف عرض العلامات
suppressPolylines optional
النوع:  boolean optional
إيقاف عرض الخطوط المتعددة

واجهة DirectionsWaypoint

google.maps.DirectionsWaypoint interface

تمثّل DirectionsWaypoint موقعًا جغرافيًا بين نقطة الانطلاق والوجهة يجب أن يمرّ به المسار.
location optional
النوع:  string|LatLng|LatLngLiteral|Place optional
موقع نقطة الطريق يمكن أن تكون سلسلة عناوين أو LatLng أو Place. اختياريّ.
stopover optional
النوع:  boolean optional
القيمة التلقائية: true
إذا كانت true، يشير ذلك إلى أنّ نقطة الطريق هذه هي محطة توقّف بين نقطة الانطلاق والوجهة. ويؤدي ذلك إلى تقسيم المسار إلى مرحلتين. إذا كانت القيمة false، يشير ذلك إلى أنّه يجب أن يكون المسار متحيزًا للمرور عبر نقطة الطريق هذه، ولكن لا يتم تقسيمه إلى مرحلتين. يكون ذلك مفيدًا إذا كنت تريد إنشاء مسار استجابةً لسحب المستخدم نقاطًا على الخريطة.

واجهة DirectionsGeocodedWaypoint

google.maps.DirectionsGeocodedWaypoint interface

نقطة طريق واحدة ذات ترميز جغرافي
partial_match optional
النوع:  boolean optional
ما إذا كان برنامج الترميز الجغرافي لم يعرض تطابقًا تامًا مع نقطة الطريق الأصلية، على الرغم من أنّه تمكّن من مطابقة جزء من العنوان المطلوب.
place_id optional
النوع:  string optional
معرّف المكان المرتبط بنقطة الطريق تحدِّد أرقام تعريف الأماكن مكانًا بشكلٍ فريد في قاعدة بيانات "أماكن Google" وعلى "خرائط Google". يمكنك الاطّلاع على مزيد من المعلومات حول معرّفات الأماكن في دليل مطوّري Places API.
types optional
النوع:  Array<string> optional
مصفوفة من السلاسل تشير إلى نوع العنصر الذي تم ترميزه جغرافيًا. للحصول على قائمة بالسلاسل المحتملة، يُرجى الرجوع إلى قسم أنواع عناصر العناوين في "دليل المطوّرين".

واجهة DirectionsRoute

google.maps.DirectionsRoute interface

مسار واحد يتضمّن مجموعة من الرحلات في DirectionsResult يُرجى العِلم أنّه على الرغم من أنّ هذا العنصر "يشبه JSON"، إلا أنّه ليس JSON تمامًا، لأنّه يتضمّن عناصر LatLng بشكل مباشر وغير مباشر.
bounds
النوع:  LatLngBounds
تمثّل هذه السمة حدود المسار.
copyrights
النوع:  string
نص حقوق الطبع والنشر الذي سيتم عرضه لهذا المسار
legs
النوع:  Array<DirectionsLeg>
مصفوفة من DirectionsLeg، يحتوي كل منها على معلومات حول الخطوات التي يتألف منها. سيكون هناك جزء واحد لكل نقطة توقّف أو وجهة محدّدة. لذا، سيتضمّن المسار الذي لا يحتوي على نقاط توقّف مؤقتة نقطة DirectionsLeg واحدة، بينما سيتضمّن المسار الذي يحتوي على نقطة توقّف مؤقتة واحدة نقطتَين.
overview_path
النوع:  Array<LatLng>
تمثّل هذه السمة مصفوفة من عناصر LatLng التي تمثّل المسار الكامل لهذه الرحلة. يتم تبسيط المسار ليكون مناسبًا في السياقات التي تتطلب عددًا صغيرًا من الرؤوس (مثل عناوين URL الخاصة بواجهة برمجة التطبيقات Static Maps API).
overview_polyline
النوع:  string
تمثيل خطوط متعدّدة مرمّزة للمسار في overview_path هذا الخط المتعدد هو مسار تقريبي (تم تنعيمه) للاتجاهات الناتجة.
summary
النوع:  string
يحتوي على وصف نصي قصير للمسار، وهو مناسب لتسمية المسار وتمييزه عن البدائل.
warnings
النوع:  Array<string>
التحذيرات التي سيتم عرضها عند إظهار هذه الاتجاهات
waypoint_order
النوع:  Array<number>
إذا تم ضبط optimizeWaypoints على true، سيحتوي هذا الحقل على الترتيب الجديد لنقاط الطريق المُدخَلة. على سبيل المثال، إذا كانت البيانات المدخلة هي:
  نقطة الانطلاق: لوس أنجلوس
  نقاط التوقف: دالاس، بانغور، فينيكس
  نقطة الوصول: نيويورك
وكانت البيانات الناتجة المحسّنة مرتّبة على النحو التالي:
  نقطة الانطلاق: لوس أنجلوس
  نقاط التوقف: فينيكس، دالاس، بانغور
  نقطة الوصول: نيويورك
سيكون هذا الحقل Array يحتوي على القيم [2, 0, 1]. يُرجى العِلم أنّ ترقيم نقاط الطريق يبدأ من الصفر.
إذا كانت أي من نقاط الطريق المدخلة تحتوي على stopover تم ضبطها على false، سيكون هذا الحقل فارغًا، لأنّ ميزة تحسين المسار غير متاحة لمثل هذه الطلبات.
fare optional
النوع:  TransitFare optional
يشير إلى السعر الإجمالي لرحلة النقل العام بأكملها. تنطبق هذه السمة على طلبات النقل العام فقط.

واجهة DirectionsLeg

google.maps.DirectionsLeg interface

تمثّل هذه السمة مرحلة واحدة تتألف من مجموعة من الخطوات في DirectionsResult. قد لا يتم عرض بعض الحقول في جزء الرحلة لجميع الطلبات. يُرجى العِلم أنّه على الرغم من أنّ هذه النتيجة "تشبه JSON"، إلا أنّها ليست JSON تمامًا، لأنّها تتضمّن كائنات LatLng بشكل مباشر وغير مباشر.
end_address
النوع:  string
تمثّل هذه السمة عنوان وجهة هذه الرحلة. يجب قراءة هذا المحتوى كما هو، ويُرجى عدم تحليله آليًا.
end_location
النوع:  LatLng
تحسب DirectionsService الاتجاهات بين المواقع الجغرافية باستخدام أقرب خيار نقل (عادةً طريق) في مواقع البداية والنهاية. تشير السمة end_location إلى الوجهة الفعلية المرمّزة جغرافيًا، والتي قد تختلف عن end_location للخطوة الأخيرة، مثلاً إذا لم يكن الطريق بالقرب من وجهة هذه الرحلة.
start_address
النوع:  string
تمثّل هذه السمة عنوان نقطة انطلاق هذه الرحلة. يجب قراءة هذا المحتوى كما هو، ويُرجى عدم تحليله آليًا.
start_location
النوع:  LatLng
تحسب DirectionsService الاتجاهات بين المواقع الجغرافية باستخدام أقرب خيار نقل (عادةً طريق) في مواقع البداية والنهاية. يشير start_location إلى نقطة الأصل الفعلية التي تم ترميزها جغرافيًا، وقد تختلف عن start_location للخطوة الأولى، مثلاً إذا لم يكن الطريق بالقرب من نقطة الأصل لهذه المرحلة.
steps
النوع:  Array<DirectionsStep>
مصفوفة من DirectionsStep، يحتوي كل منها على معلومات حول الخطوات الفردية في هذا الجزء من الرحلة.
traffic_speed_entry
النوع:  Array<*>
تعرض هذه السمة معلومات عن سرعة حركة المرور على طول الجزء من الرحلة.
via_waypoints
النوع:  Array<LatLng>
مجموعة من نقاط الطريق غير المتوقفة على طول هذه المرحلة، والتي تم تحديدها في الطلب الأصلي.

تم إيقافها نهائيًا في المسارات البديلة. سيكون الإصدار 3.27 هو آخر إصدار من واجهة برمجة التطبيقات يضيف via_waypoints إضافية في المسارات البديلة.

عند استخدام خدمة "الاتجاهات" لتنفيذ اتجاهات قابلة للسحب، يُنصح بإيقاف إمكانية سحب المسارات البديلة. يجب أن يكون المسار الرئيسي فقط قابلاً للسحب. يمكن للمستخدمين سحب المسار الرئيسي إلى أن يتطابق مع مسار بديل.
arrival_time optional
النوع:  Time optional
تمثّل هذه السمة الوقت المقدَّر للوصول إلى محطة التوقف هذه. ينطبق ذلك على طلبات TRANSIT فقط.
departure_time optional
النوع:  Time optional
تمثّل هذه السمة وقت المغادرة المقدَّر لهذه الرحلة. ينطبق ذلك على طلبات TRANSIT فقط.
distance optional
النوع:  Distance optional
تمثّل هذه السمة إجمالي المسافة التي تغطيها هذه الرحلة. قد تكون هذه السمة غير محدّدة لأنّ المسافة قد تكون غير معروفة.
duration optional
النوع:  Duration optional
تمثّل هذه السمة المدة الإجمالية لهذه الرحلة. قد تكون هذه السمة undefined لأنّ المدة قد تكون غير معروفة.
duration_in_traffic optional
النوع:  Duration optional
تمثّل هذه السمة المدة الإجمالية لهذه المرحلة، مع الأخذ في الاعتبار حالة حركة المرور الموضّحة في السمة trafficModel. قد تكون هذه السمة undefined لأنّ المدة قد تكون غير معروفة.

واجهة DirectionsStep

google.maps.DirectionsStep interface

DirectionsStep واحد في DirectionsResult قد تكون بعض الحقول undefined. يُرجى العِلم أنّه على الرغم من أنّ هذا العنصر "يشبه JSON"، إلا أنّه ليس JSON تمامًا، لأنّه يتضمّن عناصر LatLng مباشرةً.
encoded_lat_lngs
النوع:  string
تمثيل خطوط متعدّدة مرمّز للخطوة هذا مسار تقريبي (معدّل) للخطوة.
end_location
النوع:  LatLng
تمثّل هذه السمة الموقع الجغرافي الذي تنتهي فيه هذه الخطوة.
end_point
النوع:  LatLng
تمثّل هذه السمة الموقع الجغرافي الذي تنتهي فيه هذه الخطوة.
instructions
النوع:  string
تعليمات هذه الخطوة
lat_lngs
النوع:  Array<LatLng>
تمثّل هذه السمة تسلسلاً من LatLngs يصف مسار هذه الخطوة. هذا مسار تقريبي (معدّل) للخطوة.
maneuver
النوع:  string
يحتوي على الإجراء المطلوب اتّخاذه في الخطوة الحالية (turn-left أو merge أو straight أو غير ذلك). تخضع القيم للتغيير، وقد يتم تقديم قيم جديدة بدون إشعار مسبق.
path
النوع:  Array<LatLng>
تمثّل هذه السمة تسلسلاً من LatLngs يصف مسار هذه الخطوة. هذا مسار تقريبي (معدّل) للخطوة.
start_location
النوع:  LatLng
الموقع الجغرافي لبداية هذه الخطوة
start_point
النوع:  LatLng
الموقع الجغرافي لبداية هذه الخطوة
travel_mode
النوع:  TravelMode
تمثّل هذه السمة وسيلة النقل المستخدَمة في هذه الخطوة.
distance optional
النوع:  Distance optional
المسافة التي قطعتها في هذه الخطوة قد تكون هذه السمة undefined لأنّ المسافة قد تكون غير معروفة.
duration optional
النوع:  Duration optional
تمثّل هذه السمة الوقت المعتاد المطلوب لتنفيذ هذه الخطوة بالثواني وفي شكل نصي. قد تكون هذه السمة undefined لأنّ المدة قد تكون غير معروفة.
polyline optional
النوع:  DirectionsPolyline optional
يحتوي على عنصر يتضمّن سمة واحدة، وهي "نقاط"، تتضمّن تمثيلاً لخط متعدد الأضلاع مرمّز للخطوة. هذا الخط المتعدد الأضلاع هو مسار تقريبي (تم تنعيمه) للخطوة.
steps optional
النوع:  Array<DirectionsStep> optional
الخطوات الفرعية لهذه الخطوة يتم تحديدها للأقسام غير المتعلّقة بالنقل العام في مسارات النقل العام.
transit optional
النوع:  TransitDetails optional
تفاصيل خاصة بوسائل النقل العام حول هذه الخطوة لن يتم تحديد هذه السمة إلا إذا كان وضع التنقّل في هذه الخطوة هو TRANSIT.
transit_details optional
النوع:  TransitDetails optional
تفاصيل متعلقة بهذه الخطوة إذا كان وضع السفر هو TRANSIT

واجهة DirectionsPolyline

google.maps.DirectionsPolyline interface

عنصر يحتوي على السمة points لوصف الخط المتعدد الخاص بـ DirectionsStep
points
النوع:  string
خطوط متعدّدة مرمزّة

واجهة المكان

google.maps.Place interface

يحتوي على المعلومات اللازمة لتحديد موقع مكان أو تعريفه أو وصفه DirectionsRequest أو DistanceMatrixRequest. في هذا السياق، يشير مصطلح "مكان" إلى نشاط تجاري أو نقطة اهتمام أو موقع جغرافي. للحصول على معلومات حول مكان معيّن، يمكنك الاطّلاع على PlacesService.
location optional
النوع:  LatLng|LatLngLiteral optional
تمثّل هذه السمة LatLng الكيان الموصوف بهذا المكان.
placeId optional
النوع:  string optional
تمثّل هذه السمة المعرّف الخاص بالمكان (مثل نشاط تجاري أو نقطة اهتمام). معرّف المكان هو معرّف فريد لمكان في قاعدة بيانات "خرائط Google". يُرجى العِلم أنّ placeId هي الطريقة الأكثر دقة لتحديد مكان. يجب تحديد placeId بدلاً من query إذا كان ذلك ممكنًا. يمكن استرداد رقم تعريف المكان من أي طلب إلى Places API، مثل TextSearch. يمكن أيضًا استرداد أرقام تعريف الأماكن من الطلبات المُرسَلة إلى Geocoding API. لمزيد من المعلومات، اطّلِع على نظرة عامة على معرّفات الأماكن.
query optional
النوع:  string optional
تمثّل هذه السمة طلب بحث يصف المكان (مثل نشاط تجاري أو نقطة اهتمام). مثال على طلب البحث: "Quay, Upper Level, Overseas Passenger Terminal 5 Hickson Road, The Rocks NSW". يجب تحديد placeId بدلاً من query إذا كان ذلك ممكنًا. لا تضمن واجهة برمجة التطبيقات دقة تحويل سلسلة طلب البحث إلى مكان. إذا تم توفير كل من placeId وquery، سيحدث خطأ.

TravelMode ثوابت

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

وسائل النقل الصالحة التي يمكن تحديدها في DirectionsRequest بالإضافة إلى وسائل النقل التي يتم عرضها في DirectionsStep يمكنك تحديدها حسب القيمة أو باستخدام اسم الثابت. على سبيل المثال، 'BICYCLING' أو google.maps.TravelMode.BICYCLING.

يمكنك الوصول إلى الدعم من خلال الاتصال بالرقم const {TravelMode} = await google.maps.importLibrary("routes").
اطّلِع على المكتبات في Maps JavaScript API.
BICYCLING تحدّد هذه السمة طلب اتجاهات ركوب الدراجات.
DRIVING تحدّد هذه السمة طلب اتجاهات القيادة.
TRANSIT تحدّد هذه السمة طلب اتجاهات النقل العام.
BetaTWO_WHEELER تحدّد هذه السمة طلبًا للحصول على اتجاهات خاصة بالدرّاجات النارية.
WALKING تحدّد هذه السمة طلب اتجاهات سيرًا على الأقدام.

DrivingOptions interface

google.maps.DrivingOptions interface

تضبط هذه السمة DirectionsRequest عندما يكون وضع السفر مضبوطًا على DRIVING.
departureTime
النوع:  Date
وقت المغادرة المطلوب للمسار، ويتم تحديده كعنصر Date. يقيس العنصر Date الوقت بالمللي ثانية منذ 1 كانون الثاني (يناير) 1970. يجب تحديد هذه السمة ليكون DrivingOptions صالحًا. يجب ضبط وقت المغادرة على الوقت الحالي أو وقت في المستقبل. لا يمكن أن يكون في الماضي.
trafficModel optional
النوع:  TrafficModel optional
الافتراض المفضّل استخدامه عند توقّع المدة في حركة المرور القيمة التلقائية هي BEST_GUESS.

ثوابت TrafficModel

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

الافتراضات التي يجب استخدامها عند توقّع المدة في حركة المرور يتم تحديدها كجزء من DirectionsRequest أو DistanceMatrixRequest. يمكنك تحديدها حسب القيمة أو باستخدام اسم الثابت. على سبيل المثال، 'bestguess' أو google.maps.TrafficModel.BEST_GUESS.

يمكنك الوصول إلى الدعم من خلال الاتصال بالرقم const {TrafficModel} = await google.maps.importLibrary("routes").
اطّلِع على المكتبات في Maps JavaScript API.
BEST_GUESS استخدِم بيانات الزيارات السابقة لتقدير الوقت الذي يستغرقه التنقّل بشكل أفضل.
OPTIMISTIC استخدِم بيانات الزيارات السابقة لتقديم تقدير متفائل لمدة الزيارات.
PESSIMISTIC استخدِم بيانات الزيارات السابقة لتقديم تقدير متشائم لمدة التأخير.

TransitOptions

google.maps.TransitOptions interface

عنصر TransitOptions الذي سيتم تضمينه في DirectionsRequest عندما يتم ضبط وضع السفر على TRANSIT.
arrivalTime optional
النوع:  Date optional
وقت الوصول المطلوب للمسار، ويتم تحديده كعنصر "تاريخ". يقيس عنصر التاريخ الوقت بالمللي ثانية منذ 1 يناير 1970. إذا تم تحديد وقت الوصول، سيتم تجاهل وقت المغادرة.
departureTime optional
النوع:  Date optional
وقت المغادرة المطلوب للمسار، ويتم تحديده ككائن Date. يقيس عنصر التاريخ الوقت بالمللي ثانية منذ 1 يناير 1970. إذا لم يتم تحديد وقت المغادرة أو الوصول، يُفترض أنّ الوقت هو "الآن".
modes optional
النوع:  Array<TransitMode> optional
وسيلة أو أكثر من وسائل النقل العام المفضّلة، مثل الحافلة أو القطار في حال عدم تحديد أي إعداد مفضَّل، تعرض واجهة برمجة التطبيقات أفضل مسار تلقائي.
routingPreference optional
النوع:  TransitRoutePreference optional
إعداد مفضّل يمكن أن يؤثر في اختيار مسار النقل العام، مثل السير لمسافة أقصر في حال عدم تحديد أي إعداد مفضَّل، تعرض واجهة برمجة التطبيقات أفضل مسار تلقائي.

ثوابت TransitMode

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

وسيلة النقل العام الصالحة، مثل الحافلة، التي يمكن تحديدها في TransitOptions يمكنك تحديدها حسب القيمة أو باستخدام اسم الثابت. على سبيل المثال، 'BUS' أو google.maps.TransitMode.BUS.

يمكنك الوصول إلى الدعم من خلال الاتصال بالرقم const {TransitMode} = await google.maps.importLibrary("routes").
اطّلِع على المكتبات في Maps JavaScript API.
BUS تحدّد الحافلة كوسيلة نقل عام مفضّلة.
BetaLIGHT_RAIL تحدّد هذه السمة القطار الخفيف كوسيلة نقل عام مفضّلة.
RAIL تحدّد هذه السمة السكك الحديدية كوسيلة نقل عام مفضّلة.
SUBWAY تحدّد هذه السمة مترو الأنفاق كوسيلة نقل عام مفضّلة.
TRAIN تحدّد هذه السمة القطار كوسيلة نقل عام مفضّلة.
TRAM تحدّد هذه السمة الترام كوسيلة نقل عام مفضّلة.

ثوابت TransitRoutePreference

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

نوع مسار النقل العام الصالح الذي يمكن تحديده في TransitOptions يمكنك تحديدها حسب القيمة أو باستخدام اسم الثابت. على سبيل المثال، 'LESS_WALKING' أو google.maps.TransitRoutePreference.LESS_WALKING.

يمكنك الوصول إلى الدعم من خلال الاتصال بالرقم const {TransitRoutePreference} = await google.maps.importLibrary("routes").
اطّلِع على المكتبات في Maps JavaScript API.
FEWER_TRANSFERS تحدّد هذه السمة أنّ المسار المحسوب يجب أن يفضّل عددًا محدودًا من عمليات النقل.
LESS_WALKING تحدّد هذه السمة أنّ المسار المحسوب يجب أن يفضّل المشي لمسافات محدودة.

واجهة TransitFare

google.maps.TransitFare interface

تمثّل هذه السمة سعر DirectionsRoute يتضمّن القيمة والعملة.
currency
النوع:  string
رمز العملة بتنسيق ISO 4217 الذي يشير إلى العملة التي يتم التعبير عن الأجرة بها
text
النوع:  string
تمثّل هذه السمة قيمة الأجرة، ويتم التعبير عنها في currency المحدّدة كسلسلة.
value
النوع:  number
تمثّل هذه السمة القيمة الرقمية للأجرة، ويتم التعبير عنها باستخدام currency المحدّدة.

TransitDetails interface

google.maps.TransitDetails interface

تفاصيل حول المغادرة والوصول ووسيلة النقل المستخدَمة في هذه الخطوة
arrival_stop
النوع:  TransitStop
محطة الوصول في خطوة النقل العام هذه
arrival_time
النوع:  Time
وقت الوصول إلى هذه الخطوة، ويتم تحديده كعنصر Time.
departure_stop
النوع:  TransitStop
محطة المغادرة في خطوة النقل العام هذه
departure_time
النوع:  Time
وقت المغادرة لهذه الخطوة، ويتم تحديده ككائن Time.
headsign
النوع:  string
تمثّل هذه السمة اتجاه السفر على هذا الخط، كما هو موضّح على المركبة أو في محطة المغادرة.
headway
النوع:  number
عدد الثواني المتوقّع بين المركبات المشابهة في هذه المحطة
line
النوع:  TransitLine
تفاصيل حول خط النقل العام المستخدَم في هذه الخطوة
num_stops
النوع:  number
عدد المحطات في هذه الخطوة يتضمّن محطة الوصول، ولكن ليس محطة المغادرة.
trip_short_name
النوع:  string
النص الذي يظهر في الجداول ولوحات الإشارات لتحديد رحلة نقل عام للمسافرين، على سبيل المثال، لتحديد أرقام القطارات لرحلات السكك الحديدية المخصّصة للركاب يحدّد النص بشكل فريد رحلة ضمن يوم خدمة.

واجهة TransitStop

google.maps.TransitStop interface

تفاصيل حول محطة نقل عام
location
النوع:  LatLng
تمثّل هذه السمة الموقع الجغرافي لمحطة التوقف.
name
النوع:  string
اسم محطة النقل العام هذه

واجهة TransitLine

google.maps.TransitLine interface

معلومات حول خط النقل العام الذي يتم تشغيل خطوة النقل العام هذه من خلاله
agencies
النوع:  Array<TransitAgency>
مؤسسة النقل العام التي تشغّل خط النقل العام هذا
color
النوع:  string
اللون المستخدَم عادةً في اللافتات الخاصة بخط النقل العام هذا، ويتم تمثيله كسلسلة سداسية عشرية.
icon
النوع:  string
تمثّل هذه السمة عنوان URL لرمز مرتبط بهذا السطر.
name
النوع:  string
تمثّل هذه السمة الاسم الكامل لخط النقل العام، مثل "الخط المحلي في الجادة 8".
short_name
النوع:  string
تمثّل هذه السمة الاسم المختصر لخط النقل العام، مثل "E".
text_color
النوع:  string
لون النص المستخدَم عادةً في اللافتات الخاصة بخط النقل هذا، ويتم تمثيله كسلسلة سداسية عشرية.
url
النوع:  string
تمثّل هذه السمة عنوان URL الخاص بالوكالة والذي يخص خط النقل العام هذا.
vehicle
النوع:  TransitVehicle
تمثّل هذه السمة نوع المركبة المستخدَمة، مثل القطار أو الحافلة.

واجهة TransitAgency

google.maps.TransitAgency interface

تمثّل هذه السمة معلومات حول وكالة تشغّل خط نقل عام.
name
النوع:  string
تمثّل هذه السمة اسم مؤسسة النقل العام.
phone
النوع:  string
رقم هاتف مؤسسة النقل العام
url
النوع:  string
عنوان URL لمؤسسة النقل العام

واجهة TransitVehicle

google.maps.TransitVehicle interface

تعرض هذه السمة معلومات عن المركبة التي تعمل على خط نقل عام.
icon
النوع:  string
تمثّل هذه السمة عنوان URL لرمز يتوافق مع نوع المركبة المستخدَمة في هذا الخط.
local_icon
النوع:  string
عنوان URL لرمز يتوافق مع نوع المركبة المستخدَمة في هذه المنطقة بدلاً من الرمز الأكثر عمومية
name
النوع:  string
اسم لهذا النوع من TransitVehicle، مثل "قطار" أو "حافلة".
type
النوع:  VehicleType
نوع المركبة المستخدَمة، مثل القطار أو الحافلة أو العبّارة

VehicleType VehicleType

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

القيم المحتملة لأنواع المركبات

يمكنك الوصول إلى الدعم من خلال الاتصال بالرقم const {VehicleType} = await google.maps.importLibrary("routes").
اطّلِع على المكتبات في Maps JavaScript API.
BUS حافلة
CABLE_CAR مركبة تعمل على كابل، وعادةً ما تكون على الأرض قد تكون عربات التلفريك المعلّقة من النوع GONDOLA_LIFT.
COMMUTER_TRAIN قطارات سريعة
FERRY عبّارة
FUNICULAR مركبة يتم سحبها إلى أعلى منحدر شديد بواسطة كابل
GONDOLA_LIFT عربة تلفريك معلّقة
HEAVY_RAIL السكك الحديدية الثقيلة
HIGH_SPEED_TRAIN قطار عالي السرعة
INTERCITY_BUS حافلة بين المدن
METRO_RAIL قطار خفيف
MONORAIL قطار بخط حديدي واحد
OTHER المركبات الأخرى
RAIL السكك الحديدية
SHARE_TAXI سيارة الأجرة المشتركة هي نوع من وسائل النقل بالحافلات التي تتيح إقلال الركاب وتوصيلهم في أي مكان على مسارها. تستخدم سيارات الأجرة المشتركة عادةً حافلات صغيرة.
SUBWAY قطار خفيف تحت الأرض
TRAM قطار خفيف فوق الأرض
TROLLEYBUS ترولي باص

ثوابت UnitSystem

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

أنظمة الوحدات الصالحة التي يمكن تحديدها في DirectionsRequest

يمكنك الوصول إلى الدعم من خلال الاتصال بالرقم const {UnitSystem} = await google.maps.importLibrary("core").
اطّلِع على المكتبات في Maps JavaScript API.
IMPERIAL تحدّد هذه السمة أنّ المسافات في DirectionsResult يجب التعبير عنها بوحدات القياس الإنجليزية.
METRIC تحدّد هذه السمة أنّ المسافات في DirectionsResult يجب التعبير عنها بوحدات قياس مترية.

واجهة Distance

google.maps.Distance interface

تمثّل هذه السمة المسافة كقيمة رقمية وسلسلة عرض.
text
النوع:  string
تمثيل سلسلة لقيمة المسافة، باستخدام UnitSystem المحدّد في الطلب
value
النوع:  number
المسافة بالمتر

واجهة المدة

google.maps.Duration interface

تمثيل للمدة كقيمة رقمية وسلسلة عرض
text
النوع:  string
تمثيل سلسلة لقيمة المدة
value
النوع:  number
تمثّل هذه السمة المدة بالثواني.

واجهة الوقت

google.maps.Time interface

تمثيل للوقت ككائن "تاريخ" وسلسلة معدَّلة بما يناسب السوق المحلية ومنطقة زمنية
text
النوع:  string
سلسلة تمثّل قيمة الوقت. يُعرض الوقت حسب المنطقة الزمنية لمحطة النقل العام.
time_zone
النوع:  string
المنطقة الزمنية التي تقع فيها هذه المحطة القيمة هي اسم المنطقة الزمنية كما هو محدّد في "قاعدة بيانات المناطق الزمنية IANA"، مثلاً "America/New_York".
value
النوع:  Date
وقت المغادرة أو الوصول، ويتم تحديده كعنصر JavaScript Date.

ثوابت DirectionsTravelMode

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

ثوابت DirectionsUnitSystem

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