Directions

فئة DirectionsService

google.maps.DirectionsService الصف الدراسي

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

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

ثابتات الاتجاهات

google.maps.DirectionsStatus ثوابت

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

عند استخدام v=beta، يمكن الوصول إليه من خلال الاتصال بـ const {DirectionsStatus} = await google.map.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 بشكل غير مباشر.

أماكن إقامة
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.

عند استخدام v=beta، يمكن الوصول إليه من خلال الاتصال بـ const {DirectionsRenderer} = await google.map.importLibrary("routes"). راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.

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

الطُرق
getDirections	getDirections() المعلّمات: بدون قيمة الإرجاع: DirectionsResult لعرض مجموعة الاتجاهات الحالية لبرنامج العرض.
getMap	getMap() المعلّمات: بدون قيمة الإرجاع: Map لعرض الخريطة التي يتم عرض DirectionsResult عليها.
getPanel	getPanel() المعلّمات: بدون قيمة الإرجاع: HTMLElement|null لعرض اللوحة <div> حيث يتم عرض DirectionsResult.
getRouteIndex	getRouteIndex() المعلّمات: بدون قيمة الإرجاع: number لعرض فهرس المسار الحالي (المستند إلى الصفر) الذي يستخدمه عنصر DirectionsRenderer هذا.
setDirections	setDirections(directions) المعلّمات: directions: DirectionsResult قيمة الإرجاع: بدون اضبط العارض على استخدام النتيجة من DirectionsService. وسيؤدي تعيين مجموعة صالحة من الاتجاهات بهذه الطريقة إلى عرض الاتجاهات على الخريطة واللوحة المخصصة لبرنامج العرض.
setMap	setMap(map) المعلّمات: map:  Map قيمة الإرجاع: بدون تحدد هذه الطريقة الخريطة التي سيتم عرض الاتجاهات عليها. مرر null لإزالة الاتجاهات من الخريطة.
setOptions	setOptions(options) المعلّمات: options: DirectionsRendererOptions قيمة الإرجاع: بدون يمكنك تغيير إعدادات الخيارات لـ DirectionsRenderer بعد الإعداد.
setPanel	setPanel(panel) المعلّمات: panel:  HTMLElement optional قيمة الإرجاع: بدون تعرض هذه الطريقة الاتجاهات في <div>. مرِّر null لإزالة المحتوى من اللوحة.
setRouteIndex	setRouteIndex(routeIndex) المعلّمات: routeIndex: number قيمة الإرجاع: بدون يمكنك ضبط الفهرس (بدون تحديد) للمسار في العنصر DirectionsResult لعرضه. وبشكل افتراضي، سيتم عرض المسار الأول في المصفوفة.
موروث: addListener، bindTo، get، notify، set، setValues، unbind، unbindAll

الأحداث
directions_changed	function() الوسيطات: لا شيء يتم تنشيط هذا الحدث عندما تتغير الاتجاهات المعروضة، إما عندما يتم ضبط DirectionsResult جديدة أو عندما ينتهي المستخدم من سحب تغيير إلى مسار الاتجاهات.

واجهة DirectionsRendererOptions

واجهة google.maps.DirectionsRendererOptions

يحدد هذا الكائن الخصائص التي يمكن تعيينها على الكائن DirectionsRenderer.

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

واجهة DirectionsWaypoint

واجهة google.maps.DirectionsWaypoint

يمثل DirectionsWaypoint موقعًا بين نقطة الانطلاق والوجهة التي يجب أن يتم توجيه الرحلة عبرها.

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

واجهة DirectionsGeocodedWaypoint

واجهة google.maps.DirectionsGeocodedWaypoint

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

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

واجهة DirectionsRoute

واجهة google.maps.DirectionsRoute

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

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

DirectionsLeg واجهة

واجهة google.maps.DirectionsLeg

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

أماكن إقامة
end_address	النوع: string عنوان وجهة هذه المحطة. يجب قراءة هذا المحتوى كما هو، ولا يجوز تحليل العنوان المنسَّق آليًا.
end_location	النوع: LatLng تحسب DirectionsService الاتجاهات بين المواقع باستخدام أقرب خيار للنقل (عادةً ما يكون طريقًا) في مواقع البدء والانتهاء. تشير علامة end_location إلى الوجهة المحددة جغرافيًا، والتي قد تختلف عن end_location للخطوة الأخيرة إذا لم تكن، على سبيل المثال، بالقرب من وجهة هذه المحطة.
start_address	النوع: string عنوان أصل هذه الساق. يجب قراءة هذا المحتوى كما هو، ولا يجوز تحليل العنوان المنسَّق آليًا.
start_location	النوع: LatLng تحسب DirectionsService الاتجاهات بين المواقع باستخدام أقرب خيار للنقل (عادةً ما يكون طريقًا) في مواقع البدء والانتهاء. تشير علامة start_location إلى المنشأ الفعلي المشفر، والذي قد يكون مختلفًا عن start_location للخطوة الأولى، على سبيل المثال، إذا لم تكن الطريق قريبة من أصل هذه الساق.
steps	النوع: Array<DirectionsStep> مصفوفة من DirectionsStep، يحتوي كل منها على معلومات حول الخطوات الفردية في هذه المرحلة.
traffic_speed_entry	متوقف: ستكون هذه المصفوفة فارغة دائمًا. النوع: Array<?> معلومات حول سرعة حركة المرور على طول الساق.
via_waypoints	النوع: Array<LatLng> مصفوفة من نقاط الطريق التي لا تتوقف عند هذا الجزء، والتي تم تحديدها في الطلب الأصلي. متوقف في المسارات البديلة. وسيكون الإصدار 3.27 هو آخر إصدار من واجهة برمجة التطبيقات والذي يضيف المزيد من via_waypoints في المسارات البديلة. عند استخدام خدمة الاتجاهات لتنفيذ الاتجاهات القابلة للسحب، يوصى بتعطيل سحب المسارات البديلة. يجب أن يكون المسار الرئيسي فقط قابلاً للسحب. يمكن للمستخدمين سحب المسار الرئيسي إلى أن يطابق مسارًا بديلاً.
arrival_time optional	النوع: Time optional الوقت المقدّر للوصول إلى هذه المحطة. ينطبق فقط على طلبات 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

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

أماكن إقامة
encoded_lat_lngs	النوع: string تمثيل ترميز متعدد الأسطر للخطوة. هذا مسار تقريبي (متجانس) للخطوة.
end_location	النوع: LatLng موقع الانتهاء لهذه الخطوة.
end_point	متوقف: يُرجى استخدام DirectionsStep.end_location. النوع: LatLng موقع الانتهاء لهذه الخطوة.
instructions	النوع: string تعليمات لهذه الخطوة.
lat_lngs	متوقف: يُرجى استخدام DirectionsStep.path. النوع: Array<LatLng> سلسلة من LatLng تصف مسار هذه الخطوة. هذا مسار تقريبي (متجانس) للخطوة.
maneuver	النوع: string يحتوي على الإجراء المطلوب اتخاذه للخطوة الحالية (turn-left، وmerge، وstraight، وما إلى ذلك). تخضع القيم للتغيير، وقد يتم تقديم قيم جديدة بدون إشعار مسبق.
path	النوع: Array<LatLng> سلسلة من LatLng تصف مسار هذه الخطوة. هذا مسار تقريبي (متجانس) للخطوة.
start_location	النوع: LatLng موقع بداية هذه الخطوة.
start_point	متوقف: يُرجى استخدام DirectionsStep.start_location. النوع: LatLng موقع بداية هذه الخطوة.
travel_mode	النوع: TravelMode وضع السفر المستخدم في هذه الخطوة.
distance optional	النوع: Distance optional المسافة التي تغطيها هذه الخطوة. قد تكون هذه الخاصية undefined لأن المسافة قد تكون غير معروفة.
duration optional	النوع: Duration optional الوقت المعتاد المطلوب لتنفيذ هذه الخطوة بالثواني وفي شكل نصي. قد تكون هذه الخاصية undefined لأن المدة قد تكون غير معروفة.
polyline optional	متوقف: يُرجى استخدام DirectionsStep.encoded_lat_lngs. النوع: DirectionsPolyline optional يحتوي على كائن له خاصية واحدة، "النقاط"، يحمل تمثيلاً متسلسلاً متعدد الخطوط للخطوة. ويمثل هذا الخط المتعدد (تقريبيًا) مسارًا تقريبيًا للخطوة.
steps optional	النوع: Array<DirectionsStep> optional الخطوات الفرعية لهذه الخطوة. محدد للأجزاء غير القابلة للنقل من مسارات النقل العام.
transit optional	النوع: TransitDetails optional تفاصيل النقل العام حول هذه الخطوة. سيتم إلغاء تحديد هذه الخاصية ما لم يكن وضع السفر لهذه الخطوة هو TRANSIT.
transit_details optional	النوع: TransitDetails optional التفاصيل المتعلقة بهذه الخطوة إذا كان وضع السفر هو TRANSIT.

DirectionsPolyline واجهة

واجهة google.maps.DirectionsPolyline

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

أماكن إقامة
points	النوع: string خط متعدد مرمّز.

واجهة المكان

واجهة google.maps.Place

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

أماكن إقامة
location optional	النوع: LatLng|LatLngLiteral optional تمثّل هذه الخاصية LatLng للكيان الموصوف من خلال هذا المكان.
placeId optional	النوع: string optional رقم تعريف المكان للمكان (مثل نشاط تجاري أو نقطة اهتمام). رقم تعريف المكان هو معرّف فريد لمكان في قاعدة بيانات "خرائط Google". لاحظ أن placeId هي أكثر الطرق دقة لتحديد المكان. عليك تحديد placeId بدلاً من query، إن أمكن. يمكن استرداد معرّف المكان من أي طلب إلى واجهة برمجة تطبيقات الأماكن، مثل TextSearch. ويمكن أيضًا استرداد معرّفات الأماكن من الطلبات إلى واجهة برمجة تطبيقات الترميز الجغرافي. لمزيد من المعلومات، راجع نظرة عامة على أرقام تعريف الأماكن.
query optional	النوع: string optional طلب بحث يصف المكان (مثل نشاط تجاري أو نقطة اهتمام). مثال على طلب البحث هو "رصيف ميناء، مستوى أعلى، ركاب محطة الركائز 5 في هيكسون رود، ذا روكس نيو ساوث ويلز". عليك تحديد placeId بدلاً من query، إن أمكن. لا تضمن واجهة برمجة التطبيقات دقة حل سلسلة طلب البحث عن مكان. في حال تقديم كل من placeId وquery، يحدث خطأ.

سفر

google.maps.TravelMode ثوابت

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

عند استخدام v=beta، يمكن الوصول إليه من خلال الاتصال بـ const {TravelMode} = await google.map.importLibrary("routes"). راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.

الثوابت
BICYCLING	لتحديد طلب اتجاهات الدراجات.
DRIVING	لتحديد طلب اتجاهات القيادة.
TRANSIT	لتحديد طلب اتجاهات النقل العام.
WALKING	لتحديد طلب اتجاهات المشي.

DriveOptions واجهة

واجهة google.maps.DrivingOptions

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

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

نموذج حركة المرور

google.maps.TrafficModel ثوابت

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

عند استخدام v=beta، يمكن الوصول إليه من خلال الاتصال بـ const {TrafficModel} = await google.map.importLibrary("routes"). راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.

الثوابت
BEST_GUESS	استخدم بيانات الزيارات السابقة لتقدير الوقت الذي تقضيه في الزيارات بشكل أفضل.
OPTIMISTIC	استخدم بيانات الزيارات السابقة لإجراء تقدير متفائل للمدة التي سيكون عدد الزيارات خلالها.
PESSIMISTIC	استخدِم بيانات الزيارات السابقة لإجراء تقدير متشائم للمدة التي ستظهر فيها الزيارات.

TransitOptions واجهة

واجهة google.maps.TransitOptions

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

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

ثوابت TransitMode

google.maps.TransitMode ثوابت

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

عند استخدام v=beta، يمكن الوصول إليه من خلال الاتصال بـ const {TransitMode} = await google.map.importLibrary("routes"). راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.

الثوابت
BUS	لتحديد الحافلة باعتبارها وسيلة النقل المفضلة.
RAIL	لتحديد السكك الحديدية باعتبارها وسيلة النقل العام المفضلة.
SUBWAY	لتحديد مترو الأنفاق باعتباره وسيلة النقل العام المفضلة.
TRAIN	لتحديد القطار باعتباره وسيلة النقل العام المفضلة.
TRAM	لتحديد الترام كطريقة مفضلة للنقل العام.

ثوابت TransitRoutePreference

google.maps.TransitRoutePreference ثوابت

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

عند استخدام v=beta، يمكن الوصول إليه من خلال الاتصال بـ const {TransitRoutePreference} = await google.map.importLibrary("routes"). راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.

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

واجهة TransitFare

واجهة google.maps.TransitFare

الأجرة DirectionsRoute التي تتألف من القيمة والعملة.

أماكن إقامة
currency	النوع: string رمز عملة وفقًا لمعيار ISO 4217 يشير إلى العملة المستخدَمة للتعبير عن السعر.
value	النوع: number القيمة الرقمية للسعر، ويتم التعبير عنها في currency المحدّدة.

TransitDetails واجهة

واجهة google.maps.TransitDetails

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

أماكن إقامة
arrival_stop	النوع: TransitStop محطة الوصول لخطوة النقل العام هذه.
arrival_time	النوع: Time وقت الوصول لهذه الخطوة، والذي يتم تحديده ككائن "الوقت".
departure_stop	النوع: TransitStop محطة المغادرة لخطوة النقل العام هذه.
departure_time	النوع: Time وقت مغادرة هذه الخطوة المحدّد كعنصر في 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 جادة محلية".
short_name	النوع: string الاسم المختصر لخط النقل العام هذا، على سبيل المثال "E"
text_color	النوع: string لون النص المستخدم عادةً في اللافتات لخط النقل العام هذا، ويتم تمثيله كسلسلة سداسية عشرية.
url	النوع: string تمثّل هذه الخاصية عنوان URL للوكالة المحدّد لخط النقل العام هذا.
vehicle	النوع: TransitVehicle نوع المركبة المستخدَمة، مثل القطار أو الحافلة

واجهة TransitAgency

واجهة google.maps.TransitAgency

معلومات حول وكالة تدير خط نقل عام

أماكن إقامة
name	النوع: string اسم مؤسسة النقل العام هذه
phone	النوع: string رقم هاتف مؤسسة النقل العام
url	النوع: string عنوان URL لشركة النقل العام

TransitVehicle واجهة

واجهة google.maps.TransitVehicle

معلومات حول المركبة التي تعمل على خط نقل عام

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

VehicleType الثوابت

google.maps.VehicleType ثوابت

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

عند استخدام v=beta، يمكن الوصول إليه من خلال الاتصال بـ const {VehicleType} = await google.map.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	حافلة ترولي.

وحدات النظام الثابتة

google.maps.UnitSystem ثوابت

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

عند استخدام v=beta، يمكن الوصول إليه من خلال الاتصال بـ const {UnitSystem} = await google.map.importLibrary("core"). راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.

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

واجهة المسافة

واجهة google.maps.Distance

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

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

واجهة المدة

واجهة google.maps.Duration

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

أماكن إقامة
text	النوع: string تمثيل سلسلة لقيمة المدة.
value	النوع: number المدة بالثواني.

واجهة الوقت

واجهة google.maps.Time

تمثيل للوقت كائن التاريخ وسلسلة مترجَمة ومنطقة زمنية.

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

DirectionsTravelMode الثوابت

google.maps.DirectionsTravelMode ثوابت

متوقف: تم إيقاف العمل به اعتبارًا من عام 2011. يمكنك استخدام TravelMode بدلاً من ذلك.

ثوابت DirectionsUnitSystem

google.maps.DirectionsUnitSystem ثوابت

متوقف: تم إيقاف العمل به اعتبارًا من عام 2011. يمكنك استخدام UnitSystem بدلاً من ذلك.