Directions (deprecated)

DirectionsService class

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

متوقفة نهائيًا: تم إيقاف google.maps.DirectionsService نهائيًا اعتبارًا من 25 فبراير 2026. في الوقت الحالي، لا نخطّط لإيقاف google.maps.DirectionsService نهائيًا، وسنواصل إصلاح الأخطاء في أي حالات تراجُع كبيرة. سيتم إرسال إشعار قبل 12 شهرًا على الأقل من إيقاف الدعم. يُرجى الاطّلاع على https://developers.google.com/maps/legacy لمزيد من التفاصيل.

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

واجهة DirectionsResult

واجهة google.maps.DirectionsResult

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

ميزة متوقفة نهائيًا: تم إيقاف google.maps.DirectionsRenderer نهائيًا اعتبارًا من 25 فبراير 2026. في الوقت الحالي، لا نخطّط لإيقاف google.maps.DirectionsRenderer نهائيًا، وسنواصل إصلاح الأخطاء لأي حالات تراجُع كبيرة. سيتم إرسال إشعار قبل 12 شهرًا على الأقل من إيقاف الدعم. يُرجى الاطّلاع على https://developers.google.com/maps/legacy لمزيد من التفاصيل.

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

واجهة 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> تمثّل هذه السمة تسلسلاً من LatLngs يصف مسار هذه الخطوة. هذا مسار تقريبي (مبسّط) للخطوة.
maneuver	النوع: string يحتوي على الإجراء الذي يجب اتّخاذه للخطوة الحالية (turn-left أو merge أو straight أو غير ذلك). تخضع القيم للتغيير، وقد يتم تقديم قيم جديدة بدون إشعار مسبق.
path	النوع: Array<LatLng> تمثّل هذه السمة تسلسلاً من LatLngs يصف مسار هذه الخطوة. هذا مسار تقريبي (مبسّط) للخطوة.
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.

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