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

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

Directions

فئة DirectionsService

google.maps.DirectionsService الصف الدراسي

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

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

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

الثوابت
`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 بشكل غير مباشر.

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

الشركة المصنِّعة
`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. تعرف على المزيد من المعلومات عن أرقام تعريف الأماكن في دليل مطوّر برامج واجهة برمجة تطبيقات الأماكن.
`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 الثابتة لواجهة برمجة التطبيقات للخرائط).
`overview_polyline`	النوع: `string` تمثيل متعدد الخطوط مشفر للمسار في overview_path. يمثل هذا الخط المتعدد (تقريبيًا) مسارًا تقريبيًا للاتجاهات الناتجة.
`summary`	النوع: `string` يحتوي على وصف نصي قصير للمسار، ويكون مناسبًا لتسمية المسار وتوضيحه من البدائل.
`warnings`	النوع: `Array<string>` تحذيرات يتم عرضها عند عرض هذه الاتجاهات.
`waypoint_order`	النوع: `Array<number>` في حال ضبط `optimizeWaypoints` على `true`، سيحتوي هذا الحقل على تبديل نقاط نقاط الإدخال المُعاد ترتيبها. على سبيل المثال، إذا كان الإدخال هو: الأصل: لوس أنجلوس نقاط الطريق: دالاس، بانغور، فينيكس الوجهة: نيويورك ، وتم ترتيب المخرجات المحسّنة على النحو التالي: الأصل: لوس أنجلوس نقاط الطريق: فينيكس، دالاس، بانغور الوجهة: نيويورك ، فحينئذٍ سيكون هذا الحقل `Array` يحتوي على القيم [2]، سيكون هذا الحقل `Array` يحتوي على القيم [2]، سيكون هذا الحقل `Array` يحتوي على القيم [1]، [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` الوقت المقدّر للوصول إلى هذه المحطة. ينطبق فقط على طلبات 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`، إن أمكن. يمكن استرداد معرّف المكان من أي طلب إلى واجهة برمجة تطبيقات الأماكن، مثل TextSearch. ويمكن أيضًا استرداد معرّفات الأماكن من الطلبات إلى واجهة برمجة تطبيقات الترميز الجغرافي. لمزيد من المعلومات، راجع نظرة عامة على أرقام تعريف الأماكن.
`query optional`	النوع: `string optional` طلب بحث يصف المكان (مثل نشاط تجاري أو نقطة اهتمام). مثال على طلب البحث هو "رصيف ميناء، مستوى أعلى، ركاب محطة الركائز 5 في هيكسون رود، ذا روكس نيو ساوث ويلز". عليك تحديد `placeId` بدلاً من `query`، إن أمكن. لا تضمن واجهة برمجة التطبيقات دقة حل سلسلة طلب البحث عن مكان. في حال تقديم كل من `placeId` و`query`، يحدث خطأ.

سفر

google.maps.TravelMode ثوابت

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

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

الثوابت
`BICYCLING`	لتحديد طلب اتجاهات الدراجات.
`DRIVING`	لتحديد طلب اتجاهات القيادة.
`TRANSIT`	لتحديد طلب اتجاهات النقل العام.
`WALKING`	لتحديد طلب اتجاهات المشي.

DriveOptions واجهة

واجهة 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.

نموذج حركة المرور

google.maps.TrafficModel ثوابت

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

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

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

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

ثوابت TransitRoutePreference

google.maps.TransitRoutePreference ثوابت

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

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

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

الثوابت
`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`	حافلة ترولي.

وحدات النظام الثابتة

google.maps.UnitSystem ثوابت

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

الوصول من خلال الاتصال بـ const {UnitSystem} = await google.maps.importLibrary("core"). راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.

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

Directions

فئة DirectionsService

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

الطُرق

DirectionsRequest واجهة

أماكن إقامة

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

الثوابت

DirectionsResult واجهة

أماكن إقامة

DirectionsRenderer

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

الطُرق

الأحداث

واجهة DirectionsRendererOptions

أماكن إقامة

واجهة DirectionsWaypoint

أماكن إقامة

واجهة DirectionsGeocodedWaypoint

أماكن إقامة

واجهة DirectionsRoute

أماكن إقامة

DirectionsLeg واجهة

أماكن إقامة

DirectionsStep واجهة

أماكن إقامة

DirectionsPolyline واجهة

أماكن إقامة

واجهة المكان

أماكن إقامة

سفر

الثوابت

DriveOptions واجهة

أماكن إقامة

نموذج حركة المرور

الثوابت

TransitOptions واجهة

أماكن إقامة

ثوابت TransitMode

الثوابت

ثوابت TransitRoutePreference

الثوابت

واجهة TransitFare

أماكن إقامة

TransitDetails واجهة

أماكن إقامة

واجهة TransitStop

أماكن إقامة

واجهة TransitLine

أماكن إقامة

واجهة TransitAgency

أماكن إقامة

TransitVehicle واجهة

أماكن إقامة

VehicleType الثوابت

الثوابت

وحدات النظام الثابتة

الثوابت

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

أماكن إقامة

واجهة المدة

أماكن إقامة

واجهة الوقت

أماكن إقامة

DirectionsTravelMode الثوابت

ثوابت DirectionsUnitSystem