Routes API for Automotive

توفّر Routes API for Automotive سمات متخصصة لشركاء السيارات الذين يطوّرون ميزات التنقّل داخل السيارة. يوسّع نطاق واجهة برمجة تطبيقات Routes العادية بسمات مخصَّصة لمجال السيارات.

المعلومات المضمَّنة في مستندات Routes API for Automotive

بالإضافة إلى وثائق واجهة برمجة تطبيقات Routes API العادية، تتضمّن واجهة برمجة تطبيقات Routes للسيارات ما يلي:

الموافقة على طلباتك

للسماح لطلباتك بالوصول إلى annotatePaths، يجب استخدام طريقة OAuth الموضَّحة هنا: استخدام OAuth (السيارات). تتطلّب الطلبات استخدام انتحال الهوية مع OAuth، على غرار الطريقة التي تستخدم بها واجهة برمجة التطبيقات Automotive Maps API (ولكن على نطاق مختلف).

ومع ذلك، إذا كنت تستدعي الطريقتين computeRoutes أو computeRoutesMatrix، يمكنك استخدام أي من نوعَي التفويض الموضح في مستندات واجهة برمجة تطبيقات Routes العادية: مفاتيح واجهة برمجة التطبيقات أو OAuth.

المستندات المشتركة مع Standard Routes API

تشارك واجهة Routes API for Automotive المستندات مع واجهة برمجة تطبيقات Routes العادية، مثل البرامج التعليمية ضمن علامة التبويب "الإرشادات".

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

الحصول على المساعدة

نظرًا لأنّ Routes API for Automotive غير متاح للجميع، نطلب منك تجنُّب تقديم أي أخطاء متعلّقة به إلى أداة تتبُّع المشاكل العامة. لقد زوّدنا فريقك بمكون خاص بالشركة لتتبُّع المشاكل يمكن من خلاله الإبلاغ عن الأخطاء. يمكنك التواصل مع جهة اتصال Google التي تتعامل معها إذا كانت لديك مخاوف أخرى.

اصطلاحات حالة الجمل

يستخدم المستندات في الغالب اصطلاحات حالة حالة الجمل REST (مثل annotatePaths) بدلاً من اصطلاحات حالة RPC (AnnotatePaths). ومع ذلك، فإن كلا حالتي الأحرف صالحان بشكل متساوٍ.

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

"إحصاءات Google" (مدى التوفّر العام) والميزات التجريبية

يصف هذا القسم السمات الفريدة في Routes API for Automotive. تتوفر الميزات التالية بشكل عام.

السمات الأساسية المعروضة من خلال Routes API

خطوط E7 المتعددة (خطوط متعددة مرمّزة عادية وموصوفة بإحداثيات E7 بدلاً من E5):

الميزات التجريبية

إنّ الميزات التالية تجريبية وهي متاحة فقط لعملاء محدّدين:

السمات الأساسية المعروضة من خلال Routes API

  • تم استخدام الرمز المميّز للمسار كإدخال اختياري. يمكنك الاطّلاع على routeToken في Route.

المعلومات التي يمكن أن تكون متوفرة على طول الخطوط المتعددة

  • قياس حالات تأخير الازدحام المروري بدقائق حركة المرور. يمكنك الاطّلاع على IncidentType.
  • تعدادات الحوادث بدون تفاصيل الحوادث النصية يمكنك الاطّلاع على IncidentInfo.

يمكنك الاطّلاع على PolylineDetails.

ميزات أخرى

  • الارتفاع على طول المسار. يمكنك الاطّلاع على AltitudeInfo.
  • حِزم السرعة المتوقّعة على طول المسار (8 دلاء، يتراوح عرض كل مجموعة بين 10 و20 كم/ساعة). يمكنك الاطّلاع على PredictedSpeedInfo.

أدوات تعديل المسارات

ويمكنك تشغيل ما يلي RouteModifiers من واجهة برمجة التطبيقات. ومع ذلك، قد لا تلتزم المسارات بهدف التعديل لأنّها لا تزال قيد التطوير والاختبار. يُرجى التواصل مع ممثل Google الذي تتعامل معه إذا كان لديك أي أسئلة.

  • تجنَّب استخدام "إعلانات الشاشة الكاملة" (avoidVignettes[])، لأنّ هذه الميزة متاحة في ستة بلدان: النمسا وسويسرا وهنغاريا وسلوفينيا وسلوفاكيا وجمهورية التشيك.
  • السماح بالطرق ذات الإشغال المرتفع (HOV) (hovPreference). متوفرة في الولايات المتحدة وكندا.
  • تجنَّب الأنفاق (avoidTunnels).
  • المسارات الخاصة بالقطارات (totalAxleCount وtotalHeightMm وtotalLengthMm وtotalWidthMm وtotalWeightKg)