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

تمت ترجمة هذه الصفحة بواسطة 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` يحتوي على وصف نصي قصير للمسار، وهو مناسب لتسمية المسار وتمييزه عن البدائل.

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

فئة DirectionsService

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

الطُرق

واجهة DirectionsRequest

الخصائص

ثوابت DirectionsStatus

الثوابت

واجهة DirectionsResult

الخصائص

فئة DirectionsRenderer

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

الطُرق

الفعاليات

واجهة DirectionsRendererOptions

الخصائص

واجهة DirectionsWaypoint

الخصائص

واجهة DirectionsGeocodedWaypoint

الخصائص

واجهة DirectionsRoute

الخصائص

Directions