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

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

ثابت 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

تم استرداد استجابة الاتجاهات من خادم الاتجاهات. يمكنك عرض هذه العناصر باستخدام 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)
المَعلمات: 
  • routeIndexnumber
قيمة الإرجاع: لا شيء
ضبط الفهرس (المستند إلى صفر) للمسار في كائن 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>
مصفوفة من DirectionsLeg، تحتوي كل منها على معلومات عن الخطوات التي تم إنشاؤها بها. ستكون هناك مرحلة واحدة لكل نقطة طريق أو وجهة محددة. لذا سيحتوي المسار الذي لا توجد فيه نقاط توقف على DirectionsLeg واحد وسيحتوي المسار الذي به نقطة طريق واحدة بنقطة توقّف واحدة على اثنتين.
overview_path
النوع:  Array<LatLng>
مصفوفة من LatLng تمثل المسار الكامل لهذا المسار. يتم تبسيط المسار لجعله مناسبًا في السياقات التي تتطلّب عددًا صغيرًا من الرؤوس (مثل عناوين URL لـ API للخرائط الثابتة).
overview_polyline
النوع:  string
تمثيل خطوط متعدّدة مرمّز للمسار في Overview_path يُعد هذا الخطوط المتعددة مسارًا تقريبيًا (متجانس) للاتّجاهات الناتجة.
summary
النوع:  string
يحتوي على وصف نصي قصير للمسار، يكون مناسبًا للتسمية والتمييز بين المسار من البدائل.
warnings
النوع:  Array<string>
تحذيرات التي سيتم عرضها عند إظهار هذه الاتجاهات.
waypoint_order
النوع:  Array<number>
في حال ضبط optimizeWaypoints على true، سيتضمّن هذا الحقل التبديلات المُعاد ترتيبها لنقاط الطريق المدخلة. على سبيل المثال، إذا كان المدخل هو:
الأصل: لوس أنجلوس
نقاط الطرق: دالاس، بانغور، فينيكس
الوجهة: نيويورك
وتم ترتيب الناتج المحسّن على النحو التالي:
الأصل: لوس أنجلوس
نقاط الانطلاق: لوس أنجلوس
الوجهة: نيويورك
الوجهة: نيويورك
، سيكون هذا الحقل [2] ويحتوي على القيم 0.Array لاحظ أن عدد نقاط الطريق يعتمد على صفر.
إذا تم ضبط قيمة 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 لأنّ المدة قد تكون غير معروفة.

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

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"). يمكنك الاطّلاع على المكتبات في Maps JavaScript API.

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"). يمكنك الاطّلاع على المكتبات في Maps JavaScript API.

BUS تحدّد هذه العلامة الحافلة وسيلة النقل المفضّلة.
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

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

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

واجهة google.maps.Distance

تمثيل للمسافة كقيمة رقمية وسلسلة عرض

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

واجهة المدة

واجهة google.maps.Duration

تمثيل المدة كقيمة رقمية وسلسلة عرض

text
النوع:  string
تمثيل سلسلة لقيمة المدة.
value
النوع:  number
المدة بالثواني.

واجهة الوقت

واجهة google.maps.Time

تمثيل الوقت كعنصر تاريخ وسلسلة مترجَمة ومنطقة زمنية.

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

DirectionsTravelMode

google.maps.DirectionsTravelMode ثابت

ثابت DirectionsUnitSystem

google.maps.DirectionsUnitSystem ثابت