Directions

DirectionsService class

google.maps.DirectionsService class

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

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

DirectionsRequest

google.maps.DirectionsRequest واجهة

طلب للحصول على الاتجاهات لإرساله إلى 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، مع بعض الاستثناءات البارزة. على سبيل المثال، رمز المستوى الأعلى للمنطقة الجغرافية للمملكة المتحدة هو 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"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.
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 واجهة

تم استرداد استجابة الاتجاهات من خادم الاتجاهات. يمكنك عرض هذه العناصر باستخدام DirectionsRenderer أو تحليل هذا الكائن وعرضه بنفسك. يجب عرض التحذيرات وحقوق الطبع والنشر كما هو موضّح في بنود خدمة "منصّة خرائط Google". يُرجى العلم أنّ هذه النتيجة "تشبه تنسيق JSON"، ولكنها ليست بتنسيق JSON بدقة، لأنّها تتضمّن بشكل غير مباشر عناصر LatLng.
request
النوع:  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 class

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

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

يمكنك الوصول إليه من خلال الاتصال بالرقم const {DirectionsRenderer} = await google.maps.importLibrary("routes"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.
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 واجهة

يحدِّد هذا العنصر السمات التي يمكن ضبطها على عنصر 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 واجهة

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

واجهة DirectionsGeocodedWaypoint

google.maps.DirectionsGeocodedWaypoint واجهة

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

واجهة DirectionsRoute

google.maps.DirectionsRoute واجهة

مسار واحد يحتوي على مجموعة من المراحل في DirectionsResult يُرجى العِلم أنّ هذا الكائن "يشبه JSON"، ولكنه ليس JSON بدقة، لأنّه يتضمّن عناصر LatLng مباشرةً وغير مباشرة.
bounds
النوع:  LatLngBounds
حدود هذا المسار
copyrights
النوع:  string
نص حقوق الطبع والنشر المطلوب عرضه لهذا المسار
legs
النوع:  Array<DirectionsLeg>
صفيف من DirectionsLegs، يحتوي كلّ منها على معلومات عن الخطوات التي يتألّف منها. سيكون هناك رحلة واحدة لكل نقطة توقف أو وجهة محدّدة. وبالتالي، سيحتوي المسار الذي لا يتضمّن نقاط توقف على 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 واجهة

رحلة واحدة تتألّف من مجموعة من الخطوات في 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 واجهة

DirectionsStep واحد في DirectionsResult قد تكون بعض الحقول undefined. يُرجى العِلم أنّ هذا العنصر "يشبه JSON"، ولكنه ليس JSON بدقة، لأنّه يتضمّن عناصر LatLng مباشرةً.
encoded_lat_lngs
النوع:  string
تمثيل لخط متعدد مُشفَّر للخطوة هذا هو مسار الخطوة التقريبي (المُبسَّط).
end_location
النوع:  LatLng
الموقع الجغرافي الذي تنتهي عنده هذه الخطوة
end_point
النوع:  LatLng
الموقع الجغرافي الذي تنتهي عنده هذه الخطوة
instructions
النوع:  string
تعليمات هذه الخطوة
lat_lngs
النوع:  Array<LatLng>
تسلسل من LatLng يصف مسار هذه الخطوة هذا هو مسار الخطوة التقريبي (المُبسَّط).
maneuver
النوع:  string
يحتوي على الإجراء الذي يجب اتّخاذه في الخطوة الحالية (turn-left أو merge أو straight أو غير ذلك). تخضع القيم للتغيير، وقد يتم إدخال قيم جديدة بدون إشعار مسبق.
path
النوع:  Array<LatLng>
تسلسل من LatLng يصف مسار هذه الخطوة هذا هو مسار الخطوة التقريبي (المُبسَّط).
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 واجهة

عنصر يحتوي على سمة points لوصف الخط المتعدّد لعنصر DirectionsStep.
points
النوع:  string
خطوط متعدّدة مُشفّرة

واجهة المكان

google.maps.Place واجهة

يحتوي على المعلومات اللازمة لتحديد موقع مكان أو وصفه أو التعرّف عليه في 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"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.
BICYCLING تُحدِّد طلب اتّجاهات ركوب الدراجات.
DRIVING تُحدِّد طلب اتجاهات القيادة.
TRANSIT تُستخدَم لتحديد طلب اتجاهات النقل العام.
WALKING تُحدِّد طلب اتّجاهات المشي.

DrivingOptions واجهة

google.maps.DrivingOptions واجهة

يتم ضبط 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"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.
BEST_GUESS استخدِم بيانات الزيارات السابقة لتقدير الوقت الذي تقضيه في الزحام على أفضل نحو.
OPTIMISTIC استخدِم بيانات الزيارات السابقة لإجراء تقدير متفائل لمدة الزيارات.
PESSIMISTIC استخدِم بيانات الزيارات السابقة لإجراء تقدير متشائم لمدة الزيارات.

واجهة TransitOptions

google.maps.TransitOptions واجهة

عنصر TransitOptions الذي سيتم تضمينه في DirectionsRequest عند ضبط وضع التنقّل على TRANSIT
arrivalTime optional
النوع:  Date optional
وقت الوصول المطلوب للمسار، المحدَّد كعنصر تاريخ يقيس عنصر التاريخ الوقت بالمللي ثانية منذ 1 كانون الثاني (يناير) 1970. في حال تحديد وقت الوصول، يتم تجاهل وقت المغادرة.
departureTime optional
النوع:  Date optional
وقت المغادرة المطلوب للمسار، المحدَّد كعنصر تاريخ يقيس عنصر التاريخ الوقت بالمللي ثانية منذ 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"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.
BUS تُستخدَم لتحديد الحافلة كوسيلة نقل مفضّلة.
RAIL تُحدِّد السكك الحديدية كوسيلة نقل مفضّلة.
SUBWAY تُحدِّد مترو الأنفاق كوسيلة نقل مفضّلة.
TRAIN تُحدِّد القطار كوسيلة نقل مفضّلة.
TRAM تُحدِّد الترام كوسيلة نقل مفضّلة.

TransitRoutePreference الثوابت

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

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

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

واجهة TransitFare

google.maps.TransitFare واجهة

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

واجهة TransitDetails

google.maps.TransitDetails واجهة

تفاصيل حول وقت المغادرة والوصول ووسيلة النقل المستخدَمة في هذه الخطوة
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 واجهة

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

واجهة TransitLine

google.maps.TransitLine واجهة

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

TransitAgency

google.maps.TransitAgency واجهة

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

واجهة TransitVehicle

google.maps.TransitVehicle واجهة

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

VehicleType الثوابت

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

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

يمكنك الوصول إليه من خلال الاتصال بالرقم const {VehicleType} = await google.maps.importLibrary("routes"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.
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"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.
IMPERIAL تُحدِّد هذه السمة أنّ المسافات في DirectionsResult يجب التعبير عنها بالوحدات الإمبراطورية.
METRIC تُستخدَم لتحديد أنّ المسافات في DirectionsResult يجب التعبير عنها بوحدات مترية.

واجهة المسافة

google.maps.Distance واجهة

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

واجهة "المدة"

google.maps.Duration واجهة

تمثيل للمدة بصفتها قيمة رقمية وسلسلة عرض
text
النوع:  string
تمثيل سلسلة لقيمة المدة
value
النوع:  number
المدة بالثواني

واجهة "الوقت"

google.maps.Time واجهة

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

DirectionsTravelMode الثوابت

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

DirectionsUnitSystem الثوابت

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