Routes API for Automotive

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

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

بالإضافة إلى وثائق واجهة Routes API القياسية، تشمل واجهة Routes API للسيارات ما يلي:

تفويض طلباتك

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

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

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

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

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

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

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

الاصطلاحات والمصطلحات المتعلقة بحالات الجمل

تستخدم المستندات في الغالب اصطلاحات حالة الجمل في REST (مثل annotatePaths) بدلاً من اصطلاحات حالة غلاف الجمل (RPC) (AnnotatePaths)، إلا أنّ كلتا الحالتَين صالحتان.

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

Google Analytics (التوفر العام) والميزات التجريبية

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

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

E7 متعدد الخطوط (الخطوط المتعددة المشفرة القياسي الموضح باستخدام إحداثيات E7 بدلاً من E5):

  • يجب تجنّب العبّارات. الاطّلاع على FerryInfo
  • تجنب رسوم العبور. الاطّلاع على TollInfo
  • [معاينة] اختيار "المسار الاقتصادي" استنادًا إلى نوع المحرّك لمزيد من التفاصيل، راجِع الحصول على مسار صديق للبيئة.

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

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

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

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

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

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

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

ميزات أخرى

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

معدِّلات المسارات

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

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