حزمة أدوات Places UI Kit: هي مكتبة جاهزة للاستخدام تتيح للمطوّرين إمكانية التخصيص والتحكّم. ننصحك بتجربتها ومشاركة ملاحظاتك حول تجربتك مع حزمة واجهة المستخدم.

تستخدم Google تكنولوجيا الذكاء الاصطناعي لترجمة المحتوى إلى لغتك المفضّلة، وقد تتضمّن بعض الأخطاء.

Directions (deprecated)

DirectionsService class

google.maps.DirectionsService صف
مكتبة "routes"

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` اختياري	النوع: `boolean optional` إذا كانت القيمة `true`، يتم توجيه خدمة "الاتجاهات" لتجنُّب العبّارات حيثما أمكن. اختيارية:
`avoidHighways` اختياري	النوع: `boolean optional` إذا كانت القيمة `true`، يتم توجيه خدمة "اتجاهات السير" لتجنّب الطرق السريعة حيثما أمكن. اختيارية:
`avoidTolls` اختياري	النوع: `boolean optional` إذا كانت القيمة `true`، يتم توجيه خدمة "الاتجاهات" لتجنُّب الطرق برسوم عبور حيثما أمكن. اختيارية:
`drivingOptions` اختياري	النوع: `DrivingOptions optional` الإعدادات التي تنطبق فقط على الطلبات التي تكون فيها قيمة `travelMode` هي `DRIVING`. لن يكون لهذا العنصر أي تأثير في أوضاع السفر الأخرى.
`language` اختياري	النوع: `string optional` معرّف اللغة التي يجب عرض النتائج بها، إن أمكن ذلك. اطّلِع على قائمة اللغات المتاحة.
`optimizeWaypoints` اختياري	النوع: `boolean optional` إذا تم ضبطها على `true`، ستحاول `DirectionsService` إعادة ترتيب النقاط الوسيطة على المسار المقدَّمة لتقليل التكلفة الإجمالية للمسار. إذا تم تحسين النقاط على المسار، افحص `DirectionsRoute.waypoint_order` في الاستجابة لتحديد الترتيب الجديد.
`provideRouteAlternatives` اختياري	النوع: `boolean optional` ما إذا كان يجب توفير مسارات بديلة أم لا اختيارية:
`region` اختياري	النوع: `string optional` رمز المنطقة المستخدَم كتحيّز لطلبات الترميز الجغرافي يقبل رمز المنطقة قيمة ccTLD ("نطاق المستوى الأعلى") المكوّنة من حرفَين. تتطابق معظم رموز ccTLD مع رموز ISO 3166-1، مع بعض الاستثناءات الملحوظة. على سبيل المثال، نطاق المستوى الأعلى الذي يمثّل رمز البلد للمملكة المتحدة هو "uk"‏ (`.co.uk`)، في حين أنّ رمز ISO 3166-1 هو "gb" (من الناحية الفنية لكيان "المملكة المتحدة لبريطانيا العظمى وأيرلندا الشمالية").
`transitOptions` اختياري	النوع: `TransitOptions optional` الإعدادات التي تنطبق فقط على الطلبات التي يكون فيها `travelMode` هو TRANSIT. لن يكون لهذا العنصر أي تأثير في أوضاع السفر الأخرى.
`unitSystem` اختياري	النوع: `UnitSystem optional` القيمة التلقائية: نظام الوحدات المستخدَم في بلد المنشأ نظام الوحدات المفضّل استخدامه عند عرض المسافة
`waypoints` اختياري	النوع: `Array<DirectionsWaypoint> optional` مصفوفة من النقاط على المسار المتوسطة يتم احتساب الاتجاهات من نقطة الانطلاق إلى الوجهة من خلال كل نقطة على المسار في هذه المصفوفة. يُرجى الاطّلاع على دليل المطوّر لمعرفة الحد الأقصى المسموح به لعدد النقاط على المسار. لا تتوفّر النقاط على المسار في اتجاهات النقل العام. اختيارية:

ثوابت DirectionsStatus

google.maps.DirectionsStatus ثوابت
مكتبة "routes"

الحالة التي تعرضها السمة DirectionsService عند اكتمال طلب إلى route(). حدِّد هذه القيم حسب القيمة أو باستخدام اسم الثابت. على سبيل المثال، 'OK' أو google.maps.DirectionsStatus.OK.

ويمكن أيضًا استخدام هذه الثوابت كسلاسل. في TypeScript، يتم تحديد سلاسل القيم الثابتة حسب النوع DirectionsStatusString.

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`	تعذّر العثور على مسار بين نقطة الانطلاق والوجهة.

ردّ الاتجاهات الذي تم استرداده من خادم الاتجاهات يمكنك عرض هذه العناصر باستخدام DirectionsRenderer أو تحليل هذا العنصر وعرضه بنفسك. يجب عرض التحذيرات وحقوق الطبع والنشر كما هو موضّح في بنود خدمة "منصة خرائط Google". يُرجى العِلم أنّه على الرغم من أنّ هذه النتيجة "تشبه JSON"، فهي ليست JSON تمامًا، لأنّها تتضمّن بشكل غير مباشر كائنات LatLng.

الخصائص
`request`	النوع: `DirectionsRequest` ‫DirectionsRequest الذي أسفر عن هذه النتيجة
`routes`	النوع: `Array<DirectionsRoute>` مصفوفة من `DirectionsRoute`، يحتوي كل منها على معلومات عن المراحل والخطوات التي يتألف منها. سيكون هناك مسار واحد فقط ما لم يتم إنشاء `DirectionsRequest` مع ضبط `provideRouteAlternatives` على `true`.
`available_travel_modes` اختياري	النوع: `Array<TravelMode> optional` يحتوي على مصفوفة من وسائل النقل المتاحة. يتم عرض هذا الحقل عندما يحدّد الطلب وضع سفر ولا يحصل على أي نتائج. تحتوي المصفوفة على وسائل النقل المتاحة في بلدان مجموعة نقاط المسار المحدّدة. لا يتم عرض هذا الحقل إذا كانت نقطة واحدة أو أكثر من النقاط على المسار هي "نقاط على المسار".
`geocoded_waypoints` اختياري	النوع: `Array<DirectionsGeocodedWaypoint> optional` مصفوفة من `DirectionsGeocodedWaypoint`، يحتوي كل منها على معلومات عن الترميز الجغرافي لنقطة الانطلاق والوجهة ونقاط المسار.

فئة DirectionsRenderer

google.maps.DirectionsRenderer class
extends MVCObject
library "routes"

const {DirectionsRenderer} = await google.maps.importLibrary("routes");

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

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

واجهة google.maps.DirectionsRendererOptions

يحدّد هذا العنصر السمات التي يمكن ضبطها في عنصر DirectionsRenderer.

الخصائص
`directions` اختياري	النوع: `DirectionsResult optional` الاتجاهات التي سيتم عرضها على الخريطة و/أو في لوحة `<div>`، والتي يتم استردادها كعنصر `DirectionsResult` من `DirectionsService`.
`draggable` اختياري	النوع: `boolean optional` إذا كانت القيمة `true`، يسمح هذا الإعداد للمستخدم بسحب وتعديل مسارات المسارات التي يعرضها `DirectionsRenderer`.
`hideRouteList` اختياري	النوع: `boolean optional` القيمة التلقائية: `false` تشير هذه السمة إلى ما إذا كان يجب أن يوفّر العارض قائمة بالمسارات التي يمكن للمستخدم اختيارها والمعروضة في لوحة الاتجاهات.
`infoWindow` اختياري	النوع: `InfoWindow optional` تمثّل هذه السمة `InfoWindow` الذي يتم فيه عرض المعلومات النصية عند النقر على علامة. سيتم استبدال محتوى نافذة المعلومات الحالية ونقل موضعها. في حال عدم تحديد نافذة معلومات، ستنشئ `DirectionsRenderer` نافذة معلومات خاصة بها وتستخدمها. سيتم تجاهل هذه السمة إذا تم ضبط `suppressInfoWindows` على `true`.
`map` اختياري	النوع: `Map optional` الخريطة التي سيتم عرض الاتجاهات عليها
`markerOptions` اختياري	النوع: `MarkerOptions optional` خيارات العلامات ستستخدم جميع العلامات التي يعرضها `DirectionsRenderer` هذه الخيارات.
`panel` اختياري	النوع: `HTMLElement optional` تمثّل هذه السمة `<div>` الذي سيتم عرض خطوات الاتجاهات فيه.
`polylineOptions` اختياري	النوع: `PolylineOptions optional` خيارات الخطوط المتعدّدة ستستخدم جميع الخطوط المتعدّدة التي يعرضها `DirectionsRenderer` هذه الخيارات.
`preserveViewport` اختياري	النوع: `boolean optional` القيمة التلقائية: `false` إذا تم ضبط هذا الخيار على `true` أو لم يتم ضبط مركز الخريطة ومستوى التكبير/التصغير مطلقًا، يتم توسيط خريطة الإدخال وتكبيرها/تصغيرها لتناسب المربّع المحيط بهذه المجموعة من الاتجاهات.
`routeIndex` اختياري	النوع: `number optional` فهرس المسار ضمن عنصر `DirectionsResult` القيمة التلقائية هي 0.
`suppressBicyclingLayer` اختياري	النوع: `boolean optional` يتم إيقاف عرض `BicyclingLayer` عند طلب اتجاهات الدراجات.
`suppressInfoWindows` اختياري	النوع: `boolean optional` إيقاف عرض نوافذ المعلومات
`suppressMarkers` اختياري	النوع: `boolean optional` يمنع عرض العلامات.
`suppressPolylines` اختياري	النوع: `boolean optional` إيقاف عرض الخطوط المتعدّدة

واجهة DirectionsWaypoint

واجهة google.maps.DirectionsWaypoint

تمثّل السمة DirectionsWaypoint موقعًا جغرافيًا بين نقطة الانطلاق والوجهة يجب أن يمرّ المسار من خلاله.

الخصائص
`location` اختياري	النوع: `string\|LatLng\|LatLngLiteral\|Place optional` الموقع الجغرافي للنقطة على المسار يمكن أن يكون سلسلة عنوان أو `LatLng` أو `Place`. اختيارية:
`stopover` اختياري	النوع: `boolean optional` القيمة التلقائية: `true` إذا كانت القيمة `true`، يشير ذلك إلى أنّ هذه النقطة على المسار هي محطة توقّف بين نقطة الانطلاق والوجهة. يؤدي ذلك إلى تقسيم المسار إلى جزأين. إذا كانت القيمة `false`، يشير ذلك إلى أنّه يجب أن يمرّ المسار عبر نقطة على المسار هذه، ولكن بدون تقسيمه إلى جزأين. يكون ذلك مفيدًا إذا أردت إنشاء مسار استجابةً لسحب المستخدم لنقاط على المسار على الخريطة.

الخصائص

location
اختياري

النوع: string|LatLng|LatLngLiteral|Place optional

الموقع الجغرافي للنقطة على المسار يمكن أن يكون سلسلة عنوان أو LatLng أو Place. اختيارية:

stopover
اختياري

النوع: boolean optional

القيمة التلقائية: true

إذا كانت القيمة true، يشير ذلك إلى أنّ هذه النقطة على المسار هي محطة توقّف بين نقطة الانطلاق والوجهة. يؤدي ذلك إلى تقسيم المسار إلى جزأين. إذا كانت القيمة false، يشير ذلك إلى أنّه يجب أن يمرّ المسار عبر نقطة على المسار هذه، ولكن بدون تقسيمه إلى جزأين. يكون ذلك مفيدًا إذا أردت إنشاء مسار استجابةً لسحب المستخدم لنقاط على المسار على الخريطة.

واجهة DirectionsGeocodedWaypoint

واجهة google.maps.DirectionsGeocodedWaypoint

نقطة واحدة على المسار تم ترميزها جغرافيًا

الخصائص
`partial_match` اختياري	النوع: `boolean optional` ما إذا كانت أداة الترميز الجغرافي لم تعرض مطابقة تامة للنقطة الأصلية على المسار، على الرغم من أنّها تمكّنت من مطابقة جزء من العنوان المطلوب
`place_id` اختياري	النوع: `string optional` رقم تعريف المكان المرتبط بالنقطة على المسار تحدِّد أرقام تعريف الأماكن مكانًا بشكلٍ فريد في قاعدة بيانات "أماكن Google" وعلى "خرائط Google". مزيد من المعلومات عن أرقام تعريف الأماكن في دليل مطوّري Places API
`types` اختياري	النوع: `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, 0, 1]. يُرجى العِلم أنّ ترقيم النقاط على المسار يستند إلى الصفر. إذا تم ضبط `stopover` على `false` في أي من النقاط على المسار التي تم إدخالها، سيكون هذا الحقل فارغًا، لأنّ ميزة تحسين المسار غير متاحة لمثل هذه الطلبات.
`fare` اختياري	النوع: `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` اختياري	النوع: `Time optional` وقت الوصول المقدَّر لهذه المرحلة ينطبق ذلك فقط على طلبات TRANSIT.
`departure_time` اختياري	النوع: `Time optional` وقت المغادرة المقدَّر لهذه المرحلة ينطبق ذلك فقط على طلبات TRANSIT.
`distance` اختياري	النوع: `Distance optional` إجمالي المسافة التي يغطيها هذا الجزء قد تكون هذه السمة غير محدّدة لأنّ المسافة قد تكون غير معروفة.
`duration` اختياري	النوع: `Duration optional` إجمالي مدة هذا الجزء قد تكون هذه السمة `undefined` لأنّ المدة قد تكون غير معروفة.
`duration_in_traffic` اختياري	النوع: `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`s يصف مسار هذه الخطوة. هذا مسار تقريبي (مبسّط) للخطوة.
`maneuver`	النوع: `string` يحتوي على الإجراء الذي يجب اتّخاذه للخطوة الحالية (`turn-left` أو `merge` أو `straight` أو غير ذلك). تخضع القيم للتغيير، وقد يتم تقديم قيم جديدة بدون إشعار مسبق.
`path`	النوع: `Array<LatLng>` تمثّل هذه السمة تسلسلاً من `LatLng`s يصف مسار هذه الخطوة. هذا مسار تقريبي (مبسّط) للخطوة.
`start_location`	النوع: `LatLng` الموقع الجغرافي لبداية هذه الخطوة
`start_point`	متوقّف نهائيًا: يُرجى استخدام `DirectionsStep.start_location`. النوع: `LatLng` الموقع الجغرافي لبداية هذه الخطوة
`travel_mode`	النوع: `TravelMode` تمثّل هذه السمة وسيلة السفر المستخدَمة في هذه الخطوة.
`distance` اختياري	النوع: `Distance optional` المسافة التي تغطيها هذه الخطوة قد تكون هذه السمة `undefined` لأنّ المسافة قد تكون غير معروفة.
`duration` اختياري	النوع: `Duration optional` الوقت المعتاد المطلوب لتنفيذ هذه الخطوة بالثواني وفي شكل نصي. قد تكون هذه السمة `undefined` لأنّ المدة قد تكون غير معروفة.
`polyline` اختياري	متوقّف نهائيًا: يُرجى استخدام `DirectionsStep.encoded_lat_lngs`. النوع: `DirectionsPolyline optional` يحتوي على عنصر يحمل سمة واحدة، وهي "النقاط"، التي تحتوي على تمثيل خطوط متعدّدة مرمّزة للخطوة. هذا الشكل المتعدّد الخطوط هو مسار تقريبي (مبسّط) للخطوة.
`steps` اختياري	النوع: `Array<DirectionsStep> optional` الخطوات الفرعية لهذه الخطوة يتم تحديدها للأقسام غير المخصّصة للنقل العام في مسارات النقل العام.
`transit` اختياري	النوع: `TransitDetails optional` تفاصيل خاصة بالنقل العام حول هذه الخطوة ستكون هذه السمة غير محدّدة ما لم يكن وضع السفر لهذه الخطوة هو `TRANSIT`.
`transit_details` اختياري	النوع: `TransitDetails optional` تفاصيل تتعلّق بهذه الخطوة إذا كان وضع السفر هو `TRANSIT`.

واجهة DirectionsPolyline

واجهة google.maps.DirectionsPolyline

عنصر يحتوي على السمة points لوصف الخطوط المتعدّدة لـ DirectionsStep.

الخصائص
`points`	النوع: `string` خطوط متعدّدة مشفّرة

واجهة Place

واجهة google.maps.Place

تحتوي على المعلومات اللازمة لتحديد موقع مكان ما أو التعرّف عليه أو وصفه لـ DirectionsRequest أو DistanceMatrixRequest. في هذا السياق، يشير "المكان" إلى نشاط تجاري أو نقطة اهتمام أو موقع جغرافي. لجلب معلومات عن مكان معيّن، يُرجى الاطّلاع على PlacesService.

الخصائص
`location` اختياري	النوع: `LatLng\|LatLngLiteral optional` تمثّل هذه السمة `LatLng` الكيان الذي يصفه هذا المكان.
`placeId` اختياري	النوع: `string optional` رقم تعريف المكان (مثل مؤسسة أو نقطة اهتمام) رقم تعريف المكان هو معرّف فريد لمكان في قاعدة بيانات "خرائط Google". يُرجى العِلم أنّ `placeId` هو الطريقة الأكثر دقة لتحديد مكان. يجب تحديد السمة `placeId` بدلاً من `query` إن أمكن. يمكن استرداد رقم تعريف المكان من أي طلب إلى Places API، مثل TextSearch. يمكن أيضًا استرداد أرقام تعريف الأماكن من الطلبات المرسَلة إلى Geocoding API. لمزيد من المعلومات، يُرجى الاطّلاع على نظرة عامة على أرقام تعريف الأماكن.
`query` اختياري	النوع: `string optional` طلب بحث يصف المكان (مثل نشاط تجاري أو نقطة اهتمام) مثال على طلب البحث: "Quay, Upper Level, Overseas Passenger Terminal 5 Hickson Road, The Rocks NSW". يجب تحديد السمة `placeId` بدلاً من `query` إن أمكن. لا تضمن واجهة برمجة التطبيقات دقة حلّ سلسلة طلب البحث إلى مكان. في حال تقديم كل من `placeId` و`query`، سيحدث خطأ.

ثوابت TravelMode

google.maps.TravelMode ثوابت
مكتبة "routes"

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

ويمكن أيضًا استخدام هذه الثوابت كسلاسل. في TypeScript، يتم تحديد سلاسل القيم الثابتة حسب النوع TravelModeString.

const {TravelMode} = await google.maps.importLibrary("routes");

الثوابت
`BICYCLING`	يحدّد طلب اتجاهات الدراجات.
`DRIVING`	تحدّد هذه السمة طلبًا للحصول على اتجاهات القيادة.
`TRANSIT`	تحدّد طلبًا للحصول على اتجاهات النقل العام.
`TWO_WHEELER`	ملاحظة: تتوفّر هذه الميزة فقط في قناة تجريبية. تحدّد هذه السمة طلبًا للحصول على اتجاهات ركوب الدرّاجات النارية.
`WALKING`	تحدّد طلبًا للحصول على اتجاهات المشي.

واجهة DrivingOptions

واجهة google.maps.DrivingOptions

تتيح هذه السياسة ضبط DirectionsRequest عند ضبط وضع السفر على DRIVING.

الخصائص
`departureTime`	النوع: `Date` وقت المغادرة المطلوب للمسار، ويتم تحديده كعنصر `Date`. يقيس العنصر `Date` الوقت بالملي ثانية منذ 1 يناير 1970. يجب تحديد هذه السمة ليكون `DrivingOptions` صالحًا. يجب ضبط وقت المغادرة على الوقت الحالي أو وقت في المستقبل. ولا يمكن أن يكون في الماضي.
`trafficModel` اختياري	النوع: `TrafficModel optional` الافتراض المفضّل استخدامه عند توقّع المدة في حركة المرور القيمة التلقائية هي `BEST_GUESS`.

الخصائص

departureTime

النوع: Date

وقت المغادرة المطلوب للمسار، ويتم تحديده كعنصر Date. يقيس العنصر Date الوقت بالملي ثانية منذ 1 يناير 1970. يجب تحديد هذه السمة ليكون DrivingOptions صالحًا. يجب ضبط وقت المغادرة على الوقت الحالي أو وقت في المستقبل. ولا يمكن أن يكون في الماضي.

trafficModel
اختياري

النوع: TrafficModel optional

الافتراض المفضّل استخدامه عند توقّع المدة في حركة المرور القيمة التلقائية هي BEST_GUESS.

ثوابت TrafficModel

google.maps.TrafficModel ثوابت
مكتبة "routes"

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

ويمكن أيضًا استخدام هذه الثوابت كسلاسل. في TypeScript، يتم تحديد سلاسل القيم الثابتة حسب النوع TrafficModelString.

const {TrafficModel} = await google.maps.importLibrary("routes");

الثوابت
`BEST_GUESS`	استخدِم بيانات حركة المرور السابقة لتقدير الوقت المستغرَق في حركة المرور على أفضل وجه.
`OPTIMISTIC`	استخدِم بيانات الزيارات السابقة لتقدير المدة التي ستستغرقها الرحلة في حركة المرور بشكل متفائل.
`PESSIMISTIC`	استخدِم بيانات الزيارات السابقة لتقدير المدة التي ستستغرقها الرحلة في حركة المرور.

TransitOptions interface

واجهة google.maps.TransitOptions

تمثّل هذه السمة عنصر TransitOptions الذي سيتم تضمينه في DirectionsRequest عندما يكون وضع السفر مضبوطًا على TRANSIT.

الخصائص
`arrivalTime` اختياري	النوع: `Date optional` وقت الوصول المطلوب للمسار، ويتم تحديده كعنصر Date. يقيس عنصر Date الوقت بالمللي ثانية منذ 1 يناير 1970. إذا تم تحديد وقت الوصول، يتم تجاهل وقت المغادرة.
`departureTime` اختياري	النوع: `Date optional` وقت المغادرة المطلوب للمسار، ويتم تحديده كعنصر Date. يقيس عنصر Date الوقت بالمللي ثانية منذ 1 يناير 1970. إذا لم يتم تحديد وقت المغادرة أو وقت الوصول، يتم افتراض أنّ الوقت هو "الآن".
`modes` اختياري	النوع: `Array<TransitMode> optional` وسيلة نقل عام مفضّلة واحدة أو أكثر، مثل الحافلة أو القطار في حال عدم تحديد أي خيار مفضّل، تعرض واجهة برمجة التطبيقات أفضل مسار تلقائي.
`routingPreference` اختياري	النوع: `TransitRoutePreference optional` تمثّل هذه السمة خيارًا مفضّلاً يمكن أن يؤثّر في اختيار مسار النقل العام، مثل السير لمسافة أقصر. في حال عدم تحديد أي خيار مفضّل، تعرض واجهة برمجة التطبيقات أفضل مسار تلقائي.

ثوابت TransitMode

google.maps.TransitMode ثوابت
مكتبة "routes"

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

ويمكن أيضًا استخدام هذه الثوابت كسلاسل. في TypeScript، يتم تحديد سلاسل القيم الثابتة حسب النوع TransitModeString.

const {TransitMode} = await google.maps.importLibrary("routes");

الثوابت
`BUS`	تحدّد الحافلة كوسيلة نقل مفضّلة.
`LIGHT_RAIL`	ملاحظة: تتوفّر هذه الميزة فقط في قناة تجريبية. لتحديد القطار الخفيف كوسيلة نقل مفضّلة
`RAIL`	تحدّد هذه السمة القطار كوسيلة نقل مفضّلة.
`SUBWAY`	يحدّد مترو الأنفاق كوسيلة نقل مفضّلة.
`TRAIN`	تحدّد هذه السمة القطار كوسيلة النقل العام المفضّلة.
`TRAM`	تحدّد هذه السمة الترام كوسيلة نقل عام مفضّلة.

ثوابت TransitRoutePreference

google.maps.TransitRoutePreference ثوابت
مكتبة "routes"

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

ويمكن أيضًا استخدام هذه الثوابت كسلاسل. في TypeScript، يتم تحديد سلاسل القيم الثابتة حسب النوع TransitRoutePreferenceString.

const {TransitRoutePreference} = await google.maps.importLibrary("routes");

الثوابت
`FEWER_TRANSFERS`	تحدّد هذه السمة أنّ المسار المحسوب يجب أن يفضّل عددًا محدودًا من عمليات النقل.
`LESS_WALKING`	تحدّد هذه السمة أنّ المسار المحسوب يجب أن يفضّل المشي لمسافات محدودة.

واجهة TransitFare

واجهة google.maps.TransitFare

أجرة DirectionsRoute تتكوّن من قيمة وعملة

الخصائص
`currency`	النوع: `string` رمز العملة وفقًا لمعيار ISO 4217 الذي يشير إلى العملة التي يتم التعبير عن الأجرة بها
`text`	النوع: `string` تمثّل هذه السمة قيمة الأجرة، ويتم التعبير عنها بالعملة المحدّدة في `currency`، كسلسلة.
`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 ثوابت
مكتبة "routes"

القيم المحتملة لأنواع المركبات

ويمكن أيضًا استخدام هذه الثوابت كسلاسل. في TypeScript، يتم تحديد سلاسل القيم الثابتة حسب النوع VehicleTypeString.

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`	ترولي باص

UnitSystem

google.maps.UnitSystem ثوابت
مكتبة "core"

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

const {UnitSystem} = await google.maps.importLibrary("core");

الثوابت
`IMPERIAL`	تحدّد هذه السمة أنّه يجب التعبير عن المسافات في `DirectionsResult` بوحدات إمبراطورية.
`METRIC`	تحدّد هذه السياسة أنّه يجب التعبير عن المسافات في `DirectionsResult` بالوحدات المترية.

واجهة Distance

واجهة google.maps.Distance

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

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

واجهة Duration

واجهة google.maps.Duration

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

الخصائص
`text`	النوع: `string` تمثيل سلسلة لقيمة المدة
`value`	النوع: `number` المدة بالثواني

واجهة الوقت

واجهة google.maps.Time

تمثيل للوقت ككائن Date وسلسلة معدَّلة بما يناسب السوق المحلية ومنطقة زمنية

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

Directions (deprecated) تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

DirectionsService class

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

الطُرق

واجهة DirectionsRequest

الخصائص

ثوابت DirectionsStatus

الثوابت

واجهة DirectionsResult

الخصائص

فئة DirectionsRenderer

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

الطُرق

الفعاليات

DirectionsRendererOptions interface

الخصائص

واجهة DirectionsWaypoint

الخصائص

واجهة DirectionsGeocodedWaypoint

الخصائص

واجهة DirectionsRoute

الخصائص

واجهة DirectionsLeg

الخصائص

واجهة DirectionsStep

الخصائص

واجهة DirectionsPolyline

الخصائص

واجهة Place

الخصائص

ثوابت TravelMode

الثوابت

واجهة DrivingOptions

الخصائص

ثوابت TrafficModel

الثوابت

TransitOptions interface

الخصائص

ثوابت TransitMode

الثوابت

ثوابت TransitRoutePreference

الثوابت

واجهة TransitFare

الخصائص

واجهة TransitDetails

الخصائص

واجهة TransitStop

الخصائص

واجهة TransitLine

الخصائص

واجهة TransitAgency

الخصائص

واجهة TransitVehicle

الخصائص

ثوابت VehicleType

الثوابت

UnitSystem

الثوابت

واجهة Distance

الخصائص

واجهة Duration

الخصائص

واجهة الوقت

الخصائص

Directions (deprecated)