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

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

أوجه الاختلاف بين مسارات النقل العام والمسارات الأخرى

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

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

طلبات الاختلافات الاختلافات في الردود
لا يمكنك تحديد نقاط الطريق الوسيطة. تتضمّن تفاصيل النقل العام.
يتعذّر الحصول على مسارات صديقة للبيئة يتضمن بيانات وصفية لكل وسيلة سفر تحتوي على ملخص لخطوات وضع السفر هذا، في `stepsOverview` (لطلب هذه البيانات الوصفية، استخدم قناع الحقل "routes.legs.stepsOverview").
لا يمكن تحديد كيفية تضمين بيانات عدد الزيارات وما إذا كان سيتم تضمينها
لا يمكن تحديد ميزات المسارات التي يجب تجنبها
يمكن تحديد transitPreferences فقط لسمة routingPreference. للحصول على التفاصيل، يمكنك مراجعة [TransitPreferences](reference/rest/v2/TransitPreferences).

لمزيد من المعلومات عن الردّ الذي تعرضه Routes API، يُرجى الاطّلاع على مقالة مراجعة الردود المتعلّقة بمسارات النقل العام.

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

  1. اضبط نقطة الانطلاق والوجهة.

  2. ضبط وضع السفر على النقل العام:

    travelMode: "TRANSIT"

  3. أضِف قناع حقل للحصول على حقول الردّ التي تريدها. عرض اطلب حقول مسار النقل العام التي تحتاجها.

  4. إذا لزم الأمر، اضبط معلَمات اختيارية. عرض ضبط مَعلمات مسار نقل عام

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

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

لطلب هذه المعلومات استخدام قناع الحقل هذا
كل تفاصيل المسار routes.*
كل تفاصيل النقل العام routes.legs.steps.transitDetails
موقع البدء لكل ساق routes.legs.steps.startLocation
موقع الانتهاء لكل ساق routes.legs.steps.endLocation
مسار متعدد الخطوط لكل خطوة routes.legs.steps.polyline
نوع النقل العام المستخدَم لكل خطوة routes.legs.steps.travelMode
الأجرة المقدَّرة لكل خطوة والمسار الأجرة المقدَّرة باللغة المحلية routes.travel_advisory.transitFare localized routes.localizedValues.transitFare

ملاحظة: لا يتم توفير transitFare إلا إذا تمكّنت واجهة برمجة التطبيقات من إجراء ذلك. لتحديد معلومات أسعار النقل العام لكل الخطوات.

النص المترجَم للمدة والمسافة routes.localizedValues

لمزيد من المعلومات حول تعيين أقنعة الحقول، راجع اختَر الحقول التي تريد عرضها.

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

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

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

أو

"departureTime": "yyyy-mm-ddThh:mm:ssZ"
اختياريّ. يمكنك تحديد access_time أو مغادرة_time. في حال حذف لم يتم تحديد أي وقت، فسيتم ضبط departure_time تلقائيًا على وقت التنفيذ الحالي (now). يمكنك تعيين وقت الوصول أوقات المغادرة خلال الفترة الزمنية التالية فقط، مع عرض الوقت وقت التنفيذ (now) كمرجع:
  • ما يصل إلى 7 أيام قبل now
  • بما يصل إلى 100 يوم بعد now
يتم التعبير عن الوقت كطابع زمني في RFC3339 UTC "Zulu" . مزيد من المعلومات
تضمين مسارات بديلة "computeAlternativeRoutes": true اختياريّ. يمكنك الضبط على "صحيح" لتتمكن Routes API من احتساب ما يصل إلى 3 مسارات إضافية، عندما يكون ذلك متاحًا. مزيد من المعلومات
تحديد الإعدادات المفضّلة لنوع النقل العام "transitPreferences": { allowedTravelModes: ["BUS","SUBWAY","TRAIN","LIGHT_RAIL","RAIL"]}

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

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

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

يوضح المثال التالي مسارًا للنقل باستخدام المعلمات التالية:

  • لتحديد الإعدادات المفضّلة للسفر بالقطار ومشي أقل.

  • تطلب مسارات بديلة.

  • يوفر قناع حقل يعرض تفاصيل النقل العام:

curl -X POST -H 'content-type: application/json' -d '{
  "origin": {
    "address": "Humberto Delgado Airport, Portugal"
  },
  "destination": {
    "address": "Basílica of Estrela, Praça da Estrela, 1200-667 Lisboa, Portugal"
  },
  "travelMode": "TRANSIT",
  "computeAlternativeRoutes": true,
  "transitPreferences": {
     routingPreference: "LESS_WALKING",
     allowedTravelModes: ["TRAIN"]
  },
}' \
-H 'Content-Type: application/json' \
-H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: routes.legs.steps.transitDetails' \
'https://routes.googleapis.com/directions/v2:computeRoutes'

يعرض الردّ حقلَين (route.legs.steps.transitDetails) للمسارَين:

{
  "routes": [
    {
    "legs": [
        {
        "steps": [
          {},
          {},
          {},
          {
          "transitDetails": {
            "stopDetails": {
            "arrivalStop": {
              "name": "Saldanha",
              "location": {
                "latLng": {
                  "latitude": 38.73532,
                  "longitude": -9.14543
                }
              }
            },
            "arrivalTime": "2023-08-26T10:49:42Z",
            "departureStop": {
              "name": "Aeroporto",
              "location": {
                "latLng": {
                  "latitude": 38.769047799999996,
                  "longitude": -9.1284593
                }
              }
            },
            "departureTime": "2023-08-26T10:32:10Z"
              },
              "localizedValues": {
              "arrivalTime": {
                  "time": {
                    "text": "11:49"
                  },
                  "timeZone": "Europe/Lisbon"
              },
              "departureTime": {
                "time": {
                  "text": "11:32"
                },
                "timeZone": "Europe/Lisbon"
              }
            },
              "headsign": "São Sebastião",
              "transitLine": {
                "agencies": [
                  {
                    "name": "Metropolitano de Lisboa, E.P.E.",
                    "phoneNumber": "+351 21 350 0115",
                    "uri": "https://www.metrolisboa.pt/"
                  }
                ],
                "name": "Vermelha",
                "color": "#f23061",
                "nameShort": "Vm",
                "textColor": "#000000",
                "vehicle": {
                  "name": {
                    "text": "Metrô"
                  },
                "type": "SUBWAY",
                "iconUri": "//maps.gstatic.com/mapfiles/transit/iw2/6/subway2.png"
                }
              },
              "stopCount": 11
            }
          },
        {},
        {
          "transitDetails": {
            "stopDetails": {
              "arrivalStop": {
                "name": "Rato",
                "location": {
                  "latLng": {
                    "latitude": 38.7201022,
                    "longitude": -9.1540562
                  }
              }
            },
            "arrivalTime": "2023-08-26T11:01:37Z",
            "departureStop": {
              "name": "Saldanha",
                "location": {
                  "latLng": {
                    "latitude": 38.73527,
                    "longitude": -9.1455200000000012
                  }
                }
              },
              "departureTime": "2023-08-26T10:57:57Z"
            },
            "localizedValues": {
              "arrivalTime": {
                "time": {
                  "text": "12:01"
                },
                "timeZone": "Europe/Lisbon"
              },
              "departureTime": {
                "time": {
                  "text": "11:57"
                },
                "timeZone": "Europe/Lisbon"
              }
            },
            "headsign": "Rato",
            "transitLine": {
              "agencies": [
                {
                "name": "Metropolitano de Lisboa, E.P.E.",
                "phoneNumber": "+351 21 350 0115",
                "uri": "https://www.metrolisboa.pt/"
                }
              ],
              "name": "Amarela",
              "color": "#f2c200",
              "nameShort": "Am",
              "textColor": "#000000",
              "vehicle": {
                "name": {
                  "text": "Metrô"
                },
                "type": "SUBWAY",
                "iconUri": "//maps.gstatic.com/mapfiles/transit/iw2/6/subway2.png"
              }
            },
            "stopCount": 4
          }
        },
        {},
        {},
        {},
        {},
        {},
        {}
        ]
      }
    ]
  }
]
}