Directions

فئة DirectionsService

صف واحد (google.maps.DirectionsService)

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

يمكنك الوصول من خلال الاتصال على الرقم const {DirectionsService} = await google.maps.importLibrary("routes"). يمكنك الاطّلاع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.

الشركة المصنِّعة
DirectionsService	DirectionsService() المَعلمات: لا شيء ينشئ مثيلاً جديدًا من DirectionsService يرسل طلبات البحث عن الاتجاهات إلى خوادم Google.

الطُرق
route	route(request[, callback]) المَعلمات:  request:  DirectionsRequest callback:  function(DirectionsResult optional, DirectionsStatus): void optional قيمة الإرجاع:  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 ("نطاق المستوى الأعلى"). تتطابق معظم رموز 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 مصفوفة من نقاط الطريق المتوسطة. يتم حساب الاتجاهات من نقطة الانطلاق إلى الوجهة عن طريق كل نقطة طريق في هذا الصفيف. راجِع دليل المطوِّر لمعرفة الحد الأقصى لعدد نقاط الطريق المسموح بها. لا تتوفّر نقاط الطريق لاتجاهات النقل العام. اختياريّ.

الاتجاهات الثابتة

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 سمة 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"). يمكنك الاطّلاع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.

الشركة المصنِّعة
DirectionsRenderer	DirectionsRenderer([opts]) المَعلمات:  opts:  DirectionsRendererOptions optional لإنشاء عارض باستخدام الخيارات المحددة. يمكن عرض الاتجاهات على خريطة (كتراكبات مرئية) أو بالإضافة إلى لوحة <div> (كتعليمات نصية).

الطُرق
getDirections	getDirections() المَعلمات: لا شيء قيمة الإرجاع:  DirectionsResult لعرض مجموعة الاتجاهات الحالية للعارض.
getMap	getMap() المَعلمات: لا شيء قيمة الإرجاع:  Map لعرض الخريطة التي يتم عرض DirectionsResult عليها.
getPanel	getPanel() المَعلمات: لا شيء قيمة الإرجاع:  HTMLElement|null تعرض اللوحة <div> حيث يتم عرض DirectionsResult.
getRouteIndex	getRouteIndex() المَعلمات: لا شيء قيمة الإرجاع:  number تعرض فهرس المسار الحالي (استنادًا إلى الصفر) الذي يستخدمه كائن DirectionsRenderer هذا.
setDirections	setDirections(directions) المَعلمات:  directions:  DirectionsResult قيمة العرض: لا شيء اضبط العارض لاستخدام النتيجة من DirectionsService. سيؤدي تعيين مجموعة صالحة من الاتجاهات بهذه الطريقة إلى عرض الاتجاهات على الخريطة واللوحة المحددة في العارض.
setMap	setMap(map) المَعلمات:  map:  Map قيمة العرض: لا شيء تحدد هذه الطريقة الخريطة التي سيتم عرض الاتجاهات عليها. المرور null لإزالة الاتجاهات من الخريطة.
setOptions	setOptions(options) المَعلمات:  options:  DirectionsRendererOptions قيمة العرض: لا شيء يمكنك تغيير إعدادات الخيارات لجهاز DirectionsRenderer هذا بعد الإعداد.
setPanel	setPanel(panel) المَعلمات:  panel:  HTMLElement optional قيمة العرض: لا شيء تعرض هذه الطريقة الاتجاهات في <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. اطّلع على مزيد من المعلومات عن أرقام تعريف الأماكن في دليل مطوّري برامج واجهة برمجة تطبيقات الأماكن.
types optional	النوع:  Array<string> optional مصفوفة من السلاسل تشير إلى نوع العنصر الذي تم عرضه جغرافيًا. للحصول على قائمة بالسلاسل المحتملة، يُرجى الرجوع إلى قسم أنواع مكونات العناوين في دليل المطوِّر.

واجهة الاتجاهات

واجهة google.maps.DirectionsRoute

مسار واحد يحتوي على مجموعة من الأرجل في DirectionsResult. يُرجى العِلم أنّ هذا الكائن يشبه JSON، إلا أنه ليس JSON بشكل صارم، حيث يتضمن كائنات LatLng بشكل مباشر وغير مباشر.

أماكن إقامة
bounds	النوع:  LatLngBounds حدود هذا المسار.
copyrights	النوع:  string نص حقوق الطبع والنشر الذي سيتم عرضه لهذا المسار.
legs	النوع:  Array<DirectionsLeg> تمثّل هذه السمة مصفوفة من DirectionsLeg، وتحتوي كل سمة على معلومات حول الخطوات التي تم تأليفها. ستكون هناك مرحلة واحدة لكل نقطة طريق أو وجهة محددة للتوقف. لذا، سيحتوي المسار الذي لا يشتمل على نقاط لمحطات التوقف على نقطة DirectionsLeg واحدة، وسيحتوي المسار الذي يحتوي على نقطة طريق من نقطة توقف واحدة على اثنتين.
overview_path	النوع:  Array<LatLng> مصفوفة من LatLng تمثل مسار هذا المسار بالكامل. يتم تبسيط المسار لجعله مناسبًا في السياقات التي تتطلب عددًا قليلاً من الرؤوس (مثل عناوين URL لواجهة برمجة التطبيقات للخرائط الثابتة).
overview_polyline	النوع:  string تمثيل خطوط متعددة مرمّز للمسار في Overview_path. هذا الخط المتعدد هو مسار تقريبي (متجانس) للاتجاهات الناتجة.
summary	النوع:  string يحتوي على وصف نصي موجز للمسار، مناسب لتسمية الطريق وتمييزه عن البدائل.
warnings	النوع:  Array<string> التحذيرات التي سيتم عرضها عند عرض هذه الاتجاهات
waypoint_order	النوع:  Array<number> في حال ضبط optimizeWaypoints على true، سيحتوي هذا الحقل على التبديل المعاد ترتيبه لنقاط الطريق التي يتم إدخالها. على سبيل المثال، إذا كان الإدخال: الأصل: لوس أنجلوس النقاط: دالاس أو بانغور أو فينيكس الوجهة: نيويورك وتم ترتيب المخرجات المُحسَّنة على النحو التالي: الأصل: لوس أنجلوس النقاط: فينيكس، دالاس، بانغور الطرق: دالاس، بانغور، ، سيكون هذا الحقل Array يحتوي على القيمتَين [2]، الوجهة 0 والقيمة [2]. لاحظ أن عدد نقاط الطريق يعتمد على صفر. إذا كانت قيمة 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 وقت وصول تقديري لهذه المحطة. ينطبق فقط على طلبات النقل العام.
departure_time optional	النوع:  Time optional وقت المغادرة المقدَّر لهذه المحطة. ينطبق فقط على طلبات النقل العام.
distance optional	النوع:  Distance optional المسافة الإجمالية التي تغطيها هذه الساق. قد تكون هذه السمة غير معرَّفة لأنّ المسافة قد تكون غير معروفة.
duration optional	النوع:  Duration optional المدة الإجمالية لهذه الخطوة. قد تكون هذه السمة undefined لأنّ المدة قد تكون غير معروفة.
duration_in_traffic optional	النوع:  Duration optional إجمالي مدة هذه المرحلة، مع الأخذ في الاعتبار ظروف حركة المرور المُشار إليها في السمة trafficModel. قد تكون هذه السمة undefined لأنّ المدة قد تكون غير معروفة.

واجهة الاتجاهات

واجهة google.maps.DirectionsStep

DirectionsStep واحدة في DirectionsResult. قد تكون بعض الحقول undefined. يُرجى العِلم أنّ هذا الكائن يشبه JSON، إلا أنه ليس JSON بشكل صارم، حيث يتضمن كائنات LatLng مباشرةً.

أماكن إقامة
encoded_lat_lngs	النوع:  string تمثيل متعدد الخطوط مرمّز للخطوة. ويُعد هذا مسارًا تقريبيًا (متجانس) للخطوة.
end_location	النوع:  LatLng موقع النهاية لهذه الخطوة.
end_point	متوقّفة نهائيًا: يُرجى استخدام DirectionsStep.end_location. النوع:  LatLng موقع النهاية لهذه الخطوة.
instructions	النوع:  string تعليمات هذه الخطوة.
lat_lngs	متوقّفة نهائيًا: يُرجى استخدام DirectionsStep.path. النوع:  Array<LatLng> تمثّل هذه السمة تسلسلاً من LatLng يصف مسار هذه الخطوة. ويُعد هذا مسارًا تقريبيًا (متجانس) للخطوة.
maneuver	النوع:  string يحتوي على الإجراء المطلوب اتخاذه للخطوة الحالية (turn-left، وmerge، وstraight، وما إلى ذلك). تخضع القيم للتغيير، وقد يتم إدخال قيم جديدة بدون إشعار مسبق.
path	النوع:  Array<LatLng> تمثّل هذه السمة تسلسلاً من LatLng يصف مسار هذه الخطوة. ويُعد هذا مسارًا تقريبيًا (متجانس) للخطوة.
start_location	النوع:  LatLng تمثّل هذه السمة موقع بداية هذه الخطوة.
start_point	متوقّفة نهائيًا: يُرجى استخدام DirectionsStep.start_location. النوع:  LatLng تمثّل هذه السمة موقع بداية هذه الخطوة.
travel_mode	النوع:  TravelMode وسيلة النقل المستخدمة في هذه الخطوة.
distance optional	النوع:  Distance optional تمثّل هذه السمة المسافة التي تغطيها هذه الخطوة. قد تكون هذه السمة undefined لأنّ المسافة قد تكون غير معروفة.
duration optional	النوع:  Duration optional يشير ذلك المصطلح إلى الوقت المعتاد اللازم لتنفيذ هذه الخطوة بالثواني. قد تكون هذه السمة undefined لأنّ المدة قد تكون غير معروفة.
polyline optional	متوقّفة نهائيًا: يُرجى استخدام DirectionsStep.encoded_lat_lngs. النوع:  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، إن أمكن. يمكن استرداد معرّف المكان من أي طلب إلى واجهة برمجة تطبيقات الأماكن، مثل ميزة البحث النصي. ويمكن أيضًا استرداد أرقام تعريف الأماكن من الطلبات إلى واجهة برمجة تطبيقات الترميز الجغرافي. لمزيد من المعلومات، اطّلع على نظرة عامة على أرقام تعريف الأماكن.
query optional	النوع:  string optional طلب بحث يصف المكان (مثل نشاط تجاري أو نقطة اهتمام). مثال على طلب البحث هو "Quay, Upper Level, Overseas النموذج 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	تحدد هذه السمة طلب اتجاهات المشي.

واجهة DriveOptions

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

الثوابت
BUS	تحدد الحافلة وسيلة النقل المفضلة لديها.
RAIL	تحدّد السكك الحديدية كوسيلة نقل مفضَّلة للنقل.
SUBWAY	تحدد مترو الأنفاق على أنه وسيلة النقل المفضلة.
TRAIN	تحدد هذه السمة القطار على أنّه وسيلة النقل المفضّلة.
TRAM	تحدد الترام وسيلة النقل المفضلة للنقل.

الثبات TransitRoutePreferences

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 وقت وصول هذه الخطوة، الذي تم تحديده ككائن وقت.
departure_stop	النوع:  TransitStop تمثّل هذه السمة محطة مغادرة خطوة النقل العام هذه.
departure_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 الجادة المحلية".
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 اسم لهذا النوع من مركبات النقل العام، مثل "قطار" أو "حافلة".
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 ثابت

متوقّف نهائيًا: متوقف نهائيًا اعتبارًا من عام 2011. يمكنك استخدام TravelMode كبديل.

القيم الثابتة DirectionsUnitSystem

google.maps.DirectionsUnitSystem ثابت

متوقّف نهائيًا: متوقف نهائيًا اعتبارًا من عام 2011. يمكنك استخدام UnitSystem كبديل.