نقدّم لك مجموعة أدوات واجهة المستخدم الخاصة بـ Places: هي مكتبة مكوّنات جاهزة للاستخدام ومنخفضة التكلفة تتيح لك إضافة واجهة مستخدم Places المألوفة من "خرائط Google" إلى أي خريطة تختارها. ننصحك بتجربتها و مشاركة ملاحظاتك للمساعدة في رسم مستقبل "منصة Google للتسويق".

تمت ترجمة هذه الصفحة بواسطة 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 interface

طلب البحث عن الاتجاهات الذي سيتم إرساله إلى DirectionsService

الخصائص
`destination`	النوع: `string\|LatLng\|Place\|LatLngLiteral` تمثّل هذه السمة الموقع الجغرافي للوجهة. يمكن تحديد ذلك كسلسلة سيتم تحويلها إلى ترميز جغرافي، أو `LatLng`، أو `Place`. الحقل مطلوب.
`origin`	النوع: `string\|LatLng\|Place\|LatLngLiteral` موقع المنشأ يمكن تحديد ذلك كسلسلة سيتم تحويلها إلى ترميز جغرافي، أو `LatLng`، أو `Place`. الحقل مطلوب.
`travelMode`	النوع: `TravelMode` نوع التوجيه المطلوب. الحقل مطلوب.
`avoidFerries optional`	النوع: `boolean optional` إذا كانت القيمة `true`، يطلب ذلك من خدمة "الاتجاهات" تجنُّب العبّارات حيثما أمكن ذلك. اختياريّ.
`avoidHighways optional`	النوع: `boolean optional` إذا كانت القيمة `true`، يطلب ذلك من خدمة "الاتجاهات" تجنُّب الطرق السريعة حيثما أمكن. اختياريّ.
`avoidTolls optional`	النوع: `boolean optional` إذا كانت القيمة `true`، يطلب ذلك من خدمة "الاتجاهات" تجنُّب الطرق التي تتطلّب دفع رسوم عبور حيثما أمكن ذلك. اختياريّ.
`drivingOptions optional`	النوع: `DrivingOptions optional` الإعدادات التي تنطبق فقط على الطلبات التي تكون فيها قيمة `travelMode` هي `DRIVING` لن يكون لهذا العنصر أي تأثير في وسائل النقل الأخرى.
`language optional`	النوع: `string optional` معرّف اللغة التي يجب عرض النتائج بها، إذا كان ذلك ممكنًا اطّلِع على قائمة اللغات المتاحة.
`optimizeWaypoints optional`	النوع: `boolean optional` إذا تم ضبطها على `true`، ستحاول `DirectionsService` إعادة ترتيب نقاط المرور الوسيطة المقدَّمة لتقليل التكلفة الإجمالية للمسار. في حال تم تحسين نقاط الطريق، افحص `DirectionsRoute.waypoint_order` في الرد لتحديد الترتيب الجديد.
`provideRouteAlternatives optional`	النوع: `boolean optional` تحديد ما إذا كان يجب توفير بدائل للمسار أم لا اختياريّ.
`region optional`	النوع: `string optional` رمز المنطقة المستخدَم كعامل تحيّز لطلبات الترميز الجغرافي. يقبل رمز المنطقة قيمة ccTLD ("نطاق المستوى الأعلى") مكوّنة من حرفَين. تتطابق معظم رموز نطاقات المستوى الأعلى لرمز البلد مع رموز ISO 3166-1، مع بعض الاستثناءات البارزة. على سبيل المثال، رمز 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 interface

استجابة الاتجاهات التي تم استردادها من خادم الاتجاهات يمكنك عرض هذه العناصر باستخدام 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 interface

يحدّد هذا العنصر السمات التي يمكن ضبطها على عنصر 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 interface

تمثّل 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 interface

نقطة طريق واحدة ذات ترميز جغرافي

الخصائص
`partial_match optional`	النوع: `boolean optional` ما إذا كان برنامج الترميز الجغرافي لم يعرض تطابقًا تامًا مع نقطة الطريق الأصلية، على الرغم من أنّه تمكّن من مطابقة جزء من العنوان المطلوب.
`place_id optional`	النوع: `string optional` معرّف المكان المرتبط بنقطة الطريق تحدِّد أرقام تعريف الأماكن مكانًا بشكلٍ فريد في قاعدة بيانات "أماكن Google" وعلى "خرائط Google". يمكنك الاطّلاع على مزيد من المعلومات حول معرّفات الأماكن في دليل مطوّري Places API.
`types optional`	النوع: `Array<string> optional` مصفوفة من السلاسل تشير إلى نوع العنصر الذي تم ترميزه جغرافيًا. للحصول على قائمة بالسلاسل المحتملة، يُرجى الرجوع إلى قسم أنواع عناصر العناوين في "دليل المطوّرين".

واجهة DirectionsRoute

google.maps.DirectionsRoute interface

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

الخصائص
`bounds`	النوع: `LatLngBounds` تمثّل هذه السمة حدود المسار.
`copyrights`	النوع: `string` نص حقوق الطبع والنشر الذي سيتم عرضه لهذا المسار
`legs`	النوع: `Array<DirectionsLeg>` مصفوفة من `DirectionsLeg`، يحتوي كل منها على معلومات حول الخطوات التي يتألف منها. سيكون هناك جزء واحد لكل نقطة توقّف أو وجهة محدّدة. لذا، سيتضمّن المسار الذي لا يحتوي على نقاط توقّف مؤقتة نقطة `DirectionsLeg` واحدة، بينما سيتضمّن المسار الذي يحتوي على نقطة توقّف مؤقتة واحدة نقطتَين.
`overview_path`	النوع: `Array<LatLng>` تمثّل هذه السمة مصفوفة من عناصر `LatLng` التي تمثّل المسار الكامل لهذه الرحلة. يتم تبسيط المسار ليكون مناسبًا في السياقات التي تتطلب عددًا صغيرًا من الرؤوس (مثل عناوين URL الخاصة بواجهة برمجة التطبيقات Static Maps API).
`overview_polyline`	النوع: `string` تمثيل خطوط متعدّدة مرمّزة للمسار في overview_path هذا الخط المتعدد هو مسار تقريبي (تم تنعيمه) للاتجاهات الناتجة.
`summary`	النوع: `string` يحتوي على وصف نصي قصير للمسار، وهو مناسب لتسمية المسار وتمييزه عن البدائل.
`warnings`	النوع: `Array<string>` التحذيرات التي سيتم عرضها عند إظهار هذه الاتجاهات
`waypoint_order`	النوع: `Array<number>` إذا تم ضبط `optimizeWaypoints` على `true`، سيحتوي هذا الحقل على الترتيب الجديد لنقاط الطريق المُدخَلة. على سبيل المثال، إذا كانت البيانات المدخلة هي: نقطة الانطلاق: لوس أنجلوس نقاط التوقف: دالاس، بانغور، فينيكس نقطة الوصول: نيويورك وكانت البيانات الناتجة المحسّنة مرتّبة على النحو التالي: نقطة الانطلاق: لوس أنجلوس نقاط التوقف: فينيكس، دالاس، بانغور نقطة الوصول: نيويورك سيكون هذا الحقل `Array` يحتوي على القيم [2, 0, 1]. يُرجى العِلم أنّ ترقيم نقاط الطريق يبدأ من الصفر. إذا كانت أي من نقاط الطريق المدخلة تحتوي على `stopover` تم ضبطها على `false`، سيكون هذا الحقل فارغًا، لأنّ ميزة تحسين المسار غير متاحة لمثل هذه الطلبات.
`fare optional`	النوع: `TransitFare optional` يشير إلى السعر الإجمالي لرحلة النقل العام بأكملها. تنطبق هذه السمة على طلبات النقل العام فقط.

واجهة DirectionsLeg

google.maps.DirectionsLeg interface

تمثّل هذه السمة مرحلة واحدة تتألف من مجموعة من الخطوات في 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 interface

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 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 interface

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

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

واجهة المكان

google.maps.Place interface

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

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

TravelMode ثوابت

google.maps.TravelMode الثوابت

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

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

الثوابت
`BICYCLING`	تحدّد هذه السمة طلب اتجاهات ركوب الدراجات.
`DRIVING`	تحدّد هذه السمة طلب اتجاهات القيادة.
`TRANSIT`	تحدّد هذه السمة طلب اتجاهات النقل العام.
`WALKING`	تحدّد هذه السمة طلب اتجاهات سيرًا على الأقدام.

DrivingOptions interface

google.maps.DrivingOptions interface

تضبط هذه السمة 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 interface

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

الخصائص
`arrivalTime optional`	النوع: `Date optional` وقت الوصول المطلوب للمسار، ويتم تحديده كعنصر "تاريخ". يقيس عنصر التاريخ الوقت بالمللي ثانية منذ 1 يناير 1970. إذا تم تحديد وقت الوصول، سيتم تجاهل وقت المغادرة.
`departureTime optional`	النوع: `Date optional` وقت المغادرة المطلوب للمسار، ويتم تحديده ككائن Date. يقيس عنصر التاريخ الوقت بالمللي ثانية منذ 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 interface

تمثّل هذه السمة سعر DirectionsRoute يتضمّن القيمة والعملة.

الخصائص
`currency`	النوع: `string` رمز العملة بتنسيق ISO 4217 الذي يشير إلى العملة التي يتم التعبير عن الأجرة بها
`text`	النوع: `string` تمثّل هذه السمة قيمة الأجرة، ويتم التعبير عنها في `currency` المحدّدة كسلسلة.
`value`	النوع: `number` تمثّل هذه السمة القيمة الرقمية للأجرة، ويتم التعبير عنها باستخدام `currency` المحدّدة.

TransitDetails interface

google.maps.TransitDetails interface

تفاصيل حول المغادرة والوصول ووسيلة النقل المستخدَمة في هذه الخطوة

الخصائص
`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 interface

تفاصيل حول محطة نقل عام

الخصائص
`location`	النوع: `LatLng` تمثّل هذه السمة الموقع الجغرافي لمحطة التوقف.
`name`	النوع: `string` اسم محطة النقل العام هذه

واجهة TransitLine

google.maps.TransitLine interface

معلومات حول خط النقل العام الذي يتم تشغيل خطوة النقل العام هذه من خلاله

الخصائص
`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 interface

تمثّل هذه السمة معلومات حول وكالة تشغّل خط نقل عام.

الخصائص
`name`	النوع: `string` تمثّل هذه السمة اسم مؤسسة النقل العام.
`phone`	النوع: `string` رقم هاتف مؤسسة النقل العام
`url`	النوع: `string` عنوان URL لمؤسسة النقل العام

واجهة TransitVehicle

google.maps.TransitVehicle interface

تعرض هذه السمة معلومات عن المركبة التي تعمل على خط نقل عام.

الخصائص
`icon`	النوع: `string` تمثّل هذه السمة عنوان URL لرمز يتوافق مع نوع المركبة المستخدَمة في هذا الخط.
`local_icon`	النوع: `string` عنوان URL لرمز يتوافق مع نوع المركبة المستخدَمة في هذه المنطقة بدلاً من الرمز الأكثر عمومية
`name`	النوع: `string` اسم لهذا النوع من TransitVehicle، مثل "قطار" أو "حافلة".
`type`	النوع: `VehicleType` نوع المركبة المستخدَمة، مثل القطار أو الحافلة أو العبّارة

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` يجب التعبير عنها بوحدات قياس مترية.

واجهة Distance

google.maps.Distance interface

تمثّل هذه السمة المسافة كقيمة رقمية وسلسلة عرض.

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

واجهة المدة

google.maps.Duration interface

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

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

واجهة الوقت

google.maps.Time interface

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

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

ثوابت DirectionsTravelMode

google.maps.DirectionsTravelMode الثوابت

ثوابت DirectionsUnitSystem

google.maps.DirectionsUnitSystem الثوابت

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

فئة DirectionsService

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

الطُرق

واجهة DirectionsRequest

الخصائص

ثوابت DirectionsStatus

الثوابت

واجهة DirectionsResult

الخصائص

فئة DirectionsRenderer

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

الطُرق

الفعاليات

واجهة DirectionsRendererOptions

الخصائص

واجهة DirectionsWaypoint

الخصائص

واجهة DirectionsGeocodedWaypoint

الخصائص

واجهة DirectionsRoute

الخصائص

واجهة DirectionsLeg

الخصائص

واجهة DirectionsStep

الخصائص

واجهة DirectionsPolyline

الخصائص

واجهة المكان

الخصائص

TravelMode ثوابت

الثوابت

DrivingOptions interface

الخصائص

ثوابت TrafficModel

الثوابت

TransitOptions

الخصائص

ثوابت TransitMode

الثوابت

ثوابت TransitRoutePreference

الثوابت

واجهة TransitFare

الخصائص

TransitDetails interface

الخصائص

واجهة TransitStop

الخصائص

واجهة TransitLine

الخصائص

واجهة TransitAgency

الخصائص

واجهة TransitVehicle

الخصائص

VehicleType VehicleType

الثوابت

ثوابت UnitSystem

الثوابت

واجهة Distance

الخصائص

واجهة المدة

الخصائص

واجهة الوقت

الخصائص

ثوابت DirectionsTravelMode

ثوابت DirectionsUnitSystem

Directions