حدود السرعة

تعرض Roads API الحد الأقصى للسرعة المنشورة لطريق معيّن. . في حالة أجزاء الطريق ذات حدود السرعة المتغيرة، يتم تحديد يتم إرجاع حد السرعة للجزء

دقة بيانات حد السرعة التي يعرضها Roads API لا يمكن ضمانها. بيانات حد السرعة المقدمة ليست في الوقت الفعلي، وقد تكون مقدرة و/أو غير دقيقة و/أو غير مكتملة و/أو قديمة. الاطّلاع على تفاصيل التغطية لمعرفة المناطق التي تتوفر فيها بيانات حد السرعة.

الطلبات

يجب إرسال طلب حدود السرعة عبر HTTPS، ويكون على النحو التالي:

https://roads.googleapis.com/v1/speedLimits?parameters&key=YOUR_API_KEY

استخدام المَعلمة

المَعلمات المطلوبة

• إما path أو placeId.
  • path — قائمة تضم ما يصل إلى 100 زوج من خطوط الطول/العرض يمثلان مسار. يجب فصل قيم خطوط الطول والعرض بفواصل. يجب فصل أزواج خطوط الطول/العرض بحرف الشرطة الرأسية: "|". عند توفير مَعلمة path، تضيف واجهة برمجة التطبيقات أولاً المسار إلى الطريق التي تقطعها مركبة على الأرجح (كما هو الحال مع snapToRoads)، ثم تحدِّد حد السرعة جزء الطريق ذي الصلة. إذا كنت لا تريد أن تتخطى واجهة برمجة التطبيقات المسار، يجب أن يجتاز مَعلمة placeId كما هو موضّح أدناه. المثال التالي تعرِض المَعلمة path مع ثلاثة أزواج من خطوط الطول/العرض: path=60.170880,24.942795|60.170879,24.942796|60.170877,24.942796
  • placeId - أرقام تعريف الأماكن التي تمثّل جزءًا أو أكثر من أجزاء الطريق تأكَّد من أنّ كل رقم تعريف مكان يشير إلى جزء من الطريق وليس إلى نوع مختلف. من المكان. يمكنك تمرير ما يصل إلى 100 رقم تعريف مكان مع كل معرّف طلبك. لا تُجري واجهة برمجة التطبيقات التقاط صور للطرق على أرقام تعريف الأماكن المقدّمة. يتضمّن الردّ حدًا للسرعة لكل رقم تعريف مكان في الطلب. يمكنك إرسال طلب للحصول على snapToRoads أو nearestRoads. للعثور على معرفات الأماكن ذات الصلة ثم تقديمها كمدخل إلى طلب speedLimits. يوضح المثال التالي مَعلمة placeId برقم تعريف مكانَين: placeId=ChIJX12duJAwGQ0Ra0d4Oi4jOGE&placeId=ChIJLQcticc0GQ0RoiNZJVa5GxU
• key — مفتاح واجهة برمجة التطبيقات لتطبيقك. إنّ أن يعرِّف التطبيق نفسه في كل مرة يرسل فيها طلبًا إلى Roads API عن طريق تضمين مفتاح واجهة برمجة التطبيقات مع كل طلب. تعرَّف على كيفية الحصول على مفتاح.

المَعلمات الاختيارية

• units — ما إذا كان سيتم إعادة حدود السرعة بالكيلومتر أو بالميل لكل ساعة. ويمكن ضبطها على KPH أو MPH. وتكون القيمة التلقائية هي KPH.

الردود

قد تتوفّر العناصر التالية في ردّ speedLimits:

• speedLimits — مصفوفة من البيانات الوصفية للطرق. يتكون كل عنصر من الحقول التالية:
  • placeId — معرّف فريد لمكان معيّن تم عرض جميع أرقام تعريف الأماكن. بواسطة Roads API مع أجزاء الطريق.
  • speedLimit — حد السرعة لهذا الجزء من الطريق
  • units — تعرض إما KPH أو MPH.
• snappedPoints - مصفوفة من النقاط المقطوعة. هذه الصفيفة متوفّرة فقط إذا كان الطلب يحتوي على معلَمة path. تتكون كل نقطة من الحقول التالية:
  • location — يحتوي على القيمتين latitude وlongitude.
  • originalIndex - عدد صحيح يشير إلى القيمة المقابلة في الطلب الأصلي. يجب تعيين كل قيمة في الطلب قيمة بارزة في الرد. تمت فهرسة هذه القيم من 0، وبالتالي النقطة التي بها originalIndex من 4 ستكون القيمة المقطوعة للنقطة الخامسة خط العرض/الطول الذي تم تمريره إلى المعلمة path.
  • placeId — معرّف فريد لمكان معيّن تم عرض جميع أرقام تعريف الأماكن. بواسطة Roads API مع أجزاء الطريق. يمكن تمرير placeId في طلب حدود السرعة لتحديد حد السرعة على طول جزء الطريق.
• warning_message — سلسلة تحتوي على تحذير مرئي للمستخدم

مثال على طلب باستخدام مسار

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

طلب

https://roads.googleapis.com/v1/speedLimits?path=38.75807927603043,-9.03741754643809|38.6896537,-9.1770515|41.1399289,-8.6094075&key=YOUR_API_KEY

الردّ

{
  speedLimits:
  [
    {
      placeId: "ChIJX12duJAwGQ0Ra0d4Oi4jOGE",
      speedLimit: 105,
      units: "KPH"
    },
    {
      placeId: "ChIJLQcticc0GQ0RoiNZJVa5GxU",
      speedLimit: 70,
      units: "KPH"
    },
    {
      placeId: "ChIJJ4vQRudkJA0RpednU70A-5M",
      speedLimit: 55,
      units: "KPH"
    }
  ],
  snappedPoints:
  [
    {
      location:
      {
        latitude: 38.75807927603043,
        longitude: -9.037417546438084
      },
      originalIndex: 0,
      placeId: "ChIJX12duJAwGQ0Ra0d4Oi4jOGE"
    },
    {
      location:
      {
        latitude: 38.689653701836896,
        longitude: -9.177051486847693
      },
      originalIndex: 1,
      placeId: "ChIJLQcticc0GQ0RoiNZJVa5GxU"
    },
    {
      location:
      {
        latitude: 41.13993011767777,
        longitude: -8.609400794783655
      },
      originalIndex: 2,
      placeId: "ChIJJ4vQRudkJA0RpednU70A-5M"
    }
  ],
  warningMessage: "Input path is too sparse. You should provide a path where consecutive points are closer to each other. Refer to the 'path' parameter in Google Roads API documentation."
}

لاحِظ رسالة التحذير بشأن ندرة النقاط في الردّ أعلاه. إذا كنت الذين يطلبون حدود السرعة لأقرب مقاطع من الطرق في النقاط العشوائية، يجب الاتصال بـ speedLimits باستخدام معرّفات الأماكن التي تم استردادها من نقطة نهاية nearestRoads بدلاً من ذلك.

مثال على طلب باستخدام أرقام تعريف الأماكن

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

يطلب المثال التالي حدود السرعة لبعض أجزاء الطريق عبور جسر فاسكو دا جاما في لشبونة بالبرتغال.

طلب

https://roads.googleapis.com/v1/speedLimits?placeId=ChIJX12duJAwGQ0Ra0d4Oi4jOGE&placeId=ChIJLQcticc0GQ0RoiNZJVa5GxU&placeId=ChIJJ4vQRudkJA0RpednU70A-5M&key=YOUR_API_KEY

الردّ

{
  "speedLimits": [
    {
      placeId: "ChIJX12duJAwGQ0Ra0d4Oi4jOGE",
      speedLimit: 105,
      units: "KPH"
    },
    {
      placeId: "ChIJLQcticc0GQ0RoiNZJVa5GxU",
      speedLimit: 70,
      units: "KPH"
    },
    {
      placeId: "ChIJJ4vQRudkJA0RpednU70A-5M",
      speedLimit: 55,
      units: "KPH"
    }
  ]
}

اقتراحات الاستخدام

لتقليل مستوى المكالمات الواردة إلى خدمة "الحد الأقصى للسرعة"، ننصحك ويتم أخذ عينات من مواقع مواد العرض في فترات زمنية تتراوح بين 5 و15 دقيقة ( تعتمد قيمتها على سرعة انتقال مادة العرض). إذا كانت مادة العرض ثابتة، تكون عينة موقع واحدة كافية (ليست هناك حاجة لإجراء مكالمات متعددة).

لتقليل وقت الاستجابة الإجمالي، ننصحك بالاتصال بخدمة "حدّ السرعة". فبعد تجميع بعض البيانات، بدلاً من طلب بيانات من واجهة برمجة التطبيقات في كل مرة الموقع الذي تم الحصول عليه من مادة عرض الجوّال.

ما سبب عدم توفّر بعض/جميع حدود السرعة؟

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

يستخدم المثال أعلاه جسر فاسكو دا جاما لتوضيح المفاهيم؛ ويدعم الجسر الطريق E90 الذي يعبر فوق نهر "ريو تيجو". الجسر لها معرِّف مكان ChIJUzt97ZEwGQ0RM1JzQfqoDtU. الجزء الأول من الطريق في الإجابة أعلاه هي جزء من الطريق E90 ولها رقم تعريف مكان ChIJX12duJAwGQ0Ra0d4Oi4jOGE في مثال الطلب، في حال استبدال الطريق معرّف المكان مع معرّف مكان مجموعة إعدادات نقل المحتوى، ثم في الاستجابة سيكون هناك حدا سرعة في المصفوفة speedLimits لأن رقم تعريف مكان الجسر لا يشير إلى جزء من الطريق. علاوة على ذلك، إذا لم يتم أرقام تعريف الأماكن مخصّصة لأجزاء الطرق، فلن يحتوي الردّ على أي وحدود السرعة.

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