إشعار: ستتوفّر قريبًا ميزة جديدة لتصميم الخرائط الأساسية في "منصة خرائط Google". يتضمّن هذا التعديل على تصميم الخريطة لوحة ألوان تلقائية جديدة وعلامات جديدة وتحسينات على تجارب الخريطة وسهولة استخدامها. سيتم تعديل جميع أنماط الخرائط تلقائيًا في آذار (مارس) 2025. لمزيد من المعلومات عن مدى التوفّر وكيفية تفعيل هذا النمط في وقت سابق، يُرجى الاطّلاع على نمط الخريطة الجديد لمنصّة "خرائط Google".

تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

Directions

DirectionsService class

google.maps.DirectionsService class

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

يمكنك الوصول إليه من خلال الاتصال بالرقم 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) المكوّنة من حرفَين. تتطابق معظم رموز نطاقات المستوى الأعلى لرمز البلد مع رموز 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])` المَعلمات: `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`، يشير ذلك إلى أنّ المسار يجب أن يميل إلى المرور عبر نقطة الطريق هذه، ولكن لا يجب تقسيمه إلى مرحلتين. يكون ذلك مفيدًا إذا كنت تريد إنشاء مسار استجابةً لعملية سحب نقاط الطريق من قِبل المستخدم على الخريطة.

الخصائص

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`s، يحتوي كلّ منها على معلومات عن الخطوات التي يتألّف منها. سيكون هناك رحلة واحدة لكل نقطة توقف أو وجهة محدّدة. وبالتالي، سيحتوي المسار الذي لا يتضمّن نقاط توقف على `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`	تم إيقافه نهائيًا: يُرجى استخدام `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` إن أمكن. يمكن استرداد رقم تعريف مكان من أي طلب موجَّه إلى 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`.

الخصائص

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

Directions

DirectionsService class

الشركة المصنِّعة

الطُرق

DirectionsRequest

الخصائص

DirectionsStatus الثوابت

الثوابت

واجهة DirectionsResult

الخصائص

فئة DirectionsRenderer

الشركة المصنِّعة

الطُرق

الفعاليات

واجهة DirectionsRendererOptions

الخصائص

DirectionsWaypoint

الخصائص

واجهة DirectionsGeocodedWaypoint

الخصائص

واجهة DirectionsRoute

الخصائص

واجهة DirectionsLeg

الخصائص

واجهة DirectionsStep

الخصائص

واجهة DirectionsPolyline

الخصائص

واجهة المكان

الخصائص

TravelMode الثوابت

الثوابت

DrivingOptions واجهة

الخصائص

TrafficModel الثوابت

الثوابت

واجهة TransitOptions

الخصائص

TransitMode الثوابت

الثوابت

TransitRoutePreference الثوابت

الثوابت

واجهة TransitFare

الخصائص

واجهة TransitDetails

الخصائص

واجهة TransitStop

الخصائص

واجهة TransitLine

الخصائص

TransitAgency

الخصائص

واجهة TransitVehicle

الخصائص

VehicleType الثوابت

الثوابت

UnitSystem الثوابت

الثوابت

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

الخصائص

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

الخصائص

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

الخصائص

DirectionsTravelMode الثوابت

DirectionsUnitSystem الثوابت