الحصول على مسار النقل العام

مطوّرو المنطقة الاقتصادية الأوروبية

يوفّر مسار النقل العام تعليمات التنقّل باستخدام خيارات النقل العام المتاحة في المنطقة. قد تشمل خيارات النقل العام الحافلات ومترو الأنفاق والقطارات وغيرها. يتضمّن مسار النقل العام أيضًا عادةً تعليمات حول كيفية التنقّل سيرًا على الأقدام من محطات النقل العام وإليها وبينها. بما أنّ مسار النقل العام يتطلّب عادةً التنقّل باستخدام أكثر من وسيلة نقل، تختلف طريقة طلب المسار وبعض أجزاء الرد.

كيف تختلف مسارات النقل العام عن المسارات الأخرى؟

تختلف مسارات النقل العام، التي تطلبها من خلال ضبط travelMode على TRANSIT، عن المسارات التي تستخدم خيارات مختلفة لوسائل النقل. لا يمكنك طلب كل الكائنات والخيارات نفسها، وستعرض الاستجابة حقولاً مختلفة مقارنةً بالمسارات الأخرى.

في واجهة Routes API، تكون الخطوات عبارة عن تعليمات تنقّل واحدة في جميع أنواع الرحلات. لذا، كل تعليمات تنقّل هي خطوة. تتشابه استجابة مسار النقل العام إلى حد كبير مع المسارات التي تستخدم وسائل نقل أخرى، مع بعض الاختلافات الرئيسية:

طلب الاختلافات الاختلافات في الردود
لا يمكنك تحديد نقاط طريق وسيطة. يتضمّن تفاصيل النقل العام.
يتعذّر الحصول على مسارات صديقة للبيئة تتضمّن هذه السمة البيانات الوصفية لكل وسيلة نقل تتضمّن ملخّصًا للخطوات الخاصة بوسيلة النقل هذه، وذلك في stepsOverview (لطلب هذه البيانات الوصفية، استخدِم قناع الحقل stepsOverview).
لا يمكن تحديد كيفية تضمين بيانات حركة المرور وما إذا كان سيتم تضمينها
لا يمكن تحديد ميزات المسار التي يجب تجنُّبها
يمكن تحديد transitPreferences فقط. للحصول على التفاصيل، يُرجى الاطّلاع على TransitPreference.

للحصول على مسار نقل عام

  1. حدِّد نقطة الانطلاق والوجهة.
  2. يجب ضبط قيمة travelMode على TRANSIT.
  3. أضِف أقنعة الحقول المناسبة للحصول على الردّ الذي تحتاجه. راجِع مقالة طلب حقول مسار النقل العام التي تحتاج إليها.
  4. إذا لزم الأمر، اضبط المَعلمات الاختيارية. ضبط مَعلمات لمسار نقل عام

طلب حقول مسار النقل العام التي تحتاج إليها

اطلب حقول مسار النقل العام التي تحتاج إليها باستخدام أقنعة الحقول. يحتوي الجدول التالي على بعض الردود المقترَحة لمسار النقل العام، وقناع الحقل الذي يجب استخدامه لطلبها.

لطلب هذه المعلومات استخدام قناع الحقل هذا
جميع تفاصيل المسار *
تفاصيل النقل العام لأجزاء المسار legs
تعرض هذه السمة الأجرة المقدَّرة لكل خطوة من خطوات المسار، والأجرة المقدَّرة المترجمة. travelAdvisory
النص المترجَم للمدة والمسافة localizedValues

ضبط مَعلمات لمسار نقل عام

في ما يلي المَعلمات ذات الصلة بمسارات النقل العام:

لإجراء ذلك، استخدام هذه المَعلمة ملاحظات
اختيار وسيلة النقل العام travelMode: "TRANSIT" الحقل مطلوب. مزيد من المعلومات
ضبط وقت الوصول أو المغادرة arrivalTime: new Date(yyyy-mm-ddThh:mm:ssZ)

أو

departureTime: new Date(yyyy-mm-ddThh:mm:ssZ)		 اختيارية: يمكنك تحديد وقت الوصول أو وقت المغادرة. في حال عدم تحديد أي من الوقتين، يتم ضبط القيمة التلقائية departureTime على وقت التنفيذ الحالي (now). يمكنك ضبط وقتَي الوصول والمغادرة ضمن الفترة الزمنية التالية فقط، مع استخدام وقت التنفيذ الحالي (now) كمرجع:
  • حتى 7 أيام قبل now
  • خلال 100 يوم من now، بما في ذلك هذا اليوم
يتم التعبير عن الوقت باستخدام عنصر Date.

ملاحظة: تتغيّر جداول النقل العام بشكل متكرّر، وقد تتغيّر رحلات النقل العام المتاحة بمرور الوقت، ولا يمكن ضمان تقديم نتائج متّسقة للتوقّعات قبل وقت طويل.
تضمين مسارات بديلة computeAlternativeRoutes: true اختيارية: اضبط القيمة على "صحيح" لكي يحسب computeRoutes ما يصل إلى 3 مسارات إضافية، إذا كانت متاحة. مزيد من المعلومات
تحديد الإعدادات المفضّلة لنوع النقل العام transitPreference: {allowedTransitModes: ["BUS", "SUBWAY", "TRAIN", "LIGHT_RAIL", "RAIL"]}

ملاحظة: في حال تحديد وسيلة نقل مفضّلة، قد تستخدم الطرق التي يتم عرضها وسائل نقل أخرى، أو قد تستخدم وسائل نقل أخرى فقط، وذلك حسب كفاءة الطريق وتوفّر وسيلة النقل المفضّلة.

 اختيارية: تحديد وسائل النقل العام المفضّلة مزيد من المعلومات
تحديد الإعدادات المفضّلة لمسار النقل العام transitPreference: {routingPreference: "LESS_WALKING|FEWER_TRANSFERS"} اختيارية: تحديد إعدادات التوجيه المفضّلة لوسائل النقل العام مزيد من المعلومات

مثال على الطلب

يوضّح المثال التالي كيفية طلب مسار نقل عام:

const request = {
  origin: 'Hunters Point San Francisco, CA 94124',
  destination: '201 Marine Dr, San Francisco, CA 94129',
  travelMode: 'TRANSIT',
  departureTime: new Date(),
  transitPreference: {
    allowedTransitModes: ['BUS', 'SUBWAY', 'TRAIN', 'LIGHT_RAIL', 'RAIL'],
    routingPreference: 'FEWER_TRANSFERS', // Alternatively, 'LESS_WALKING'.
  },
  fields: ['path', 'legs', 'travelAdvisory', 'localizedValues'],
};