إشعار الأمان: نما إلى علمنا بمشكلة أمنية قد تؤثر في المواقع الإلكترونية التي تستخدم مكتبات معيّنة تابعة لجهات خارجية (بما في ذلك polyfill.io). وقد تؤدي هذه المشكلة في بعض الأحيان إلى إعادة توجيه الزائرين بعيدًا عن الموقع الإلكتروني المقصود بدون معرفة مالك الموقع أو إذنه. وفي السابق، كان يتضمّن العديد من نماذج JavaScript تعريف النص البرمجي polyfill.io. تمت إزالة هذا المحتوى من نماذجنا. إذا كنت قد استخدمت نماذج JavaScript التي تحتوي على هذا التعريف، ننصحك بإزالة التعريف.

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

Directions

فئة DirectionsService

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

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

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

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

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

أماكن إقامة

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

Directions

فئة DirectionsService

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

الطُرق

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