Directions

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

فئة DirectionsService

google.maps.DirectionsService الصف

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

DirectionsService
DirectionsService()
المعلّمات: لا شيء
إنشاء مثيل جديد من DirectionsService يرسل طلبات البحث عن الاتجاهات إلى خوادم Google.
route
route(request[, callback])
المعلّمات:
قيمة العرض: 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. ولن يكون لهذا الكائن أي تأثير لأوضاع السفر الأخرى.
Betalanguage optional
النوع: string optional
تمثّل هذه الخاصية معرّف اللغة للغة التي يجب عرض النتائج فيها، إن أمكن. راجع قائمة اللغات المتاحة.
optimizeWaypoints optional
النوع: boolean optional
عند الضبط على true، سيحاول DirectionsService إعادة ترتيب نقاط الطريق الوسيطة المقدمة لتقليل التكلفة الإجمالية للمسار. إذا تم تحسين نقاط الطريق، افحص DirectionsRoute.waypoint_order في الاستجابة لتحديد الترتيب الجديد.
provideRouteAlternatives optional
النوع: boolean optional
ما إذا كان يجب توفير بدائل المسار أم لا. اختياريّ.
region optional
النوع: string optional
رمز المنطقة يُستخدَم كانحياز لطلبات الترميز الجغرافي. يقبل رمز المنطقة قيمة مكوّنة من حرفين في نطاقات المستوى الأعلى التي يتم ترميزها حسب البلد (ccTLD) ("top;level;quot;). وتتطابق معظم رموز ccTLD مع رموز ISO 3166-1، مع وجود بعض الاستثناءات البارزة. على سبيل المثال، فإنّ نطاقات المستوى الأعلى التي يتم ترميزها حسب البلد (ccTLD) في المملكة المتحدة هي &"uk;quot; (.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

INVALID_REQUEST السمة DirectionsRequest التي تم تقديمها غير صالحة.
MAX_WAYPOINTS_EXCEEDED تم توفير عدد كبير جدًا من DirectionsWaypoint في DirectionsRequest. يُرجى الاطّلاع على دليل مطوّري البرامج لمعرفة الحد الأقصى المسموح به لعدد نقاط الطريق.
NOT_FOUND تعذّر ترميز موقع جغرافي واحد على الأقل من نقاط الانطلاق أو الوجهة أو نقاط المسار.
OK تتضمّن الإجابة DirectionsResult صالح.
OVER_QUERY_LIMIT تجاوزت صفحة الويب الحدّ الأقصى المسموح به للطلبات في فترة زمنية قصيرة جدًا.
REQUEST_DENIED لا يُسمح لصفحة الويب باستخدام خدمة الاتجاهات.
UNKNOWN_ERROR تعذّرت معالجة طلب اتجاهات بسبب خطأ في الخادم. قد ينجح الطلب في حال إعادة المحاولة.
ZERO_RESULTS تعذّر العثور على أي مسار بين نقطة الانطلاق والوجهة.

واجهة Directionsالنتيجة

واجهة google.maps.DirectionsResult

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

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

فئة DirectionsRenderer

google.maps.DirectionsRenderer الصف

يتم عرض الاتجاهات التي تم الحصول عليها من DirectionsService.

يمتد هذا الصف إلى MVCObject.

DirectionsRenderer
DirectionsRenderer([opts])
المعلّمات:
يُنشئ العارض باستخدام الخيارات المحددة. يمكن عرض الاتجاهات على خريطة (كتراكبات مرئية) أو أيضًا على لوحة <div> (كتعليمات نصية).
getDirections
getDirections()
المعلّمات: لا شيء
قيمة العرض: DirectionsResult
لعرض مجموعة الاتجاهات الحالية للعرض والعرض الخاص.
getMap
getMap()
المعلّمات: لا شيء
قيمة العرض: Map
عرض الخريطة التي يتم عرض DirectionsResult فيها.
getPanel
getPanel()
المعلّمات: لا شيء
قيمة العرض: HTMLElement|null
عرض اللوحة <div> التي يتم فيها عرض DirectionsResult.
getRouteIndex
getRouteIndex()
المعلّمات: لا شيء
قيمة العرض: number
عرض فهرس المسار الحالي (المستند إلى الصفر) قيد الاستخدام بواسطة عنصر DirectionsRenderer هذا.
setDirections
setDirections(directions)
المعلّمات:
قيمة العرض: لا شيء
اضبط العارض على استخدام النتيجة من DirectionsService. سيؤدي ضبط مجموعة صالحة من الاتجاهات بهذه الطريقة إلى عرض الاتجاهات على الخريطة واللوحة المحدَّدة لبرنامج العرض.
setMap
setMap(map)
المعلّمات:
قيمة العرض: لا شيء
تحدد هذه الطريقة الخريطة التي سيتم عرض الاتجاهات عليها. مرّر null لإزالة الاتجاهات من الخريطة.
setOptions
setOptions(options)
المعلّمات:
قيمة العرض: لا شيء
يمكنك تغيير إعدادات الخيارات لجهاز DirectionsRenderer بعد الإعداد.
setPanel
setPanel(panel)
المعلّمات:
قيمة العرض: لا شيء
تعرض هذه الطريقة الاتجاهات في <div>. انتقِل إلى null لإزالة المحتوى من اللوحة.
setRouteIndex
setRouteIndex(routeIndex)
المعلّمات:
  • routeIndexnumber
قيمة العرض: لا شيء
اضبط فهرس المسار (غير المستند إلى الصفر) للكائن في 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|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. ملاحظة: على الرغم من أنّ هذا العنصر هو ";quot;JSON"، مثل JSON; ، إلا أنّه ليس ملف JSON حصرًا، لأنه يتضمّن كائنات LatLng بشكل مباشر وغير مباشر.

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

واجهة DirectionsLeg

واجهة google.maps.DirectionsLeg

ساق واحدة تتكون من مجموعة من الخطوات في DirectionsResult. قد لا يتم عرض بعض الحقول في محطة الدفع لكل الطلبات. يُرجى العِلم أنّ هذه النتيجة تختلف عن "JSON;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، وأنّه ليس JSON فقط، لأنه يتضمّن كائنات LatLng مباشرةً.

encoded_lat_lngs
النوع: string
تمثيل مضلّل للخطوة. وهذا مسار تقريبي (مجسَّد) للخطوة.
end_location
النوع: LatLng
موقع نهاية هذه الخطوة.
end_point
النوع: LatLng
موقع نهاية هذه الخطوة.
instructions
النوع: string
التعليمات الخاصة بهذه الخطوة.
lat_lngs
النوع: Array<LatLng>
تسلسل LatLngs يصف مسار هذه الخطوة. وهذا مسار تقريبي (مجسَّد) للخطوة.
maneuver
النوع: string
تحتوي على الإجراء الواجب اتخاذه للخطوة الحالية (turn-left، merge، straight، وما إلى ذلك). تخضع القيم للتغيير، وقد يتم تقديم قيم جديدة بدون إشعار مسبق.
path
النوع: Array<LatLng>
تسلسل LatLngs يصف مسار هذه الخطوة. وهذا مسار تقريبي (مجسَّد) للخطوة.
start_location
النوع: LatLng
موقع بداية هذه الخطوة.
start_point
النوع: LatLng
موقع بداية هذه الخطوة.
travel_mode
النوع: TravelMode
طريقة السفر المستخدمة في هذه الخطوة.
distance optional
النوع: Distance optional
المسافة التي تغطيها هذه الخطوة قد يكون هذا الموقع undefined نظرًا لأن المسافة قد تكون غير معروفة.
duration optional
النوع: Duration optional
الوقت المعتاد المطلوب لتنفيذ هذه الخطوة بالثواني وفي شكل نصي. قد يكون هذا الموقع هو undefined نظرًا لأن المدة قد تكون غير معروفة.
polyline optional
النوع: Array<DirectionsStep> optional
يحتوي على عنصر به خاصية واحدة، 'points'، يحتوي على تمثيل مضلّع للخطوة. هذا الخط المضلع هو مسار تقريبي (ملئم) للخطوة.
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 أو تحديده أو وصفه. في هذا السياق، تعني "Place&quot: نشاط تجاري أو نقطة اهتمام أو موقع جغرافي. للحصول على معلومات حول مكان معيّن، يمكنك الاطّلاع على PlacesService.

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

وضع السفر

google.maps.TravelMode ثوابت

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

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

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

واجهة TransitOptions

واجهة google.maps.TransitOptions

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

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

ثوابت TransitMode

google.maps.TransitMode ثوابت

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

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

ثوابت TransitRoutePreferences

google.maps.TransitRoutePreference ثوابت

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

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
وقت المغادرة لهذه الخطوة، مع تحديدها كعنصر وقت.
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; Local Street"
short_name
النوع: string
الاسم المختصر لخط النقل العام هذا، مثل "E"
text_color
النوع: string
لون النص المستخدَم عادةً في اللافتات لخط النقل العام هذا، ويتم تمثيله كسلسلة سداسية عشرية.
url
النوع: string
عنوان URL للوكالة خاص بخط النقل العام هذا.
vehicle
النوع: TransitVehicle
نوع المركبة المستخدَمة، مثل القطار أو الحافلة

واجهة TransitAgency

واجهة google.maps.TransitAgency

معلومات عن مؤسسة تدير خط نقل عام

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

مركبة نقل عام واجهة

واجهة google.maps.TransitVehicle

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

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

نوع المركبة ثوابت

google.maps.VehicleType ثوابت

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

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.

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.

ثوابت Directions TravelMode

google.maps.DirectionsTravelMode ثوابت

DirectionsUnitSystem الثوابت

google.maps.DirectionsUnitSystem ثوابت