تعرض 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
طلبات، يمكن لأي منهما عرض معرّفات أماكن متعددة من
مكالمة واحدة.