توفّر Routes API for Automotive سمات متخصصة لشركاء السيارات الذين يطوّرون ميزات التنقّل داخل السيارة. يوسّع نطاق واجهة برمجة تطبيقات Routes العادية بسمات مخصَّصة لمجال السيارات.
المعلومات المضمَّنة في مستندات Routes API for Automotive
بالإضافة إلى وثائق واجهة برمجة تطبيقات Routes API العادية، تتضمّن واجهة برمجة تطبيقات Routes للسيارات ما يلي:
- ملاحظات الإصدار (السيارات)
- استخدام OAuth (السيارات)
- مكتبات العملاء (السيارات)
- مرجع RST (السيارات)
- مرجع استدعاء إجراء عن بُعد (RPC) (للسيارات)
الموافقة على طلباتك
للسماح لطلباتك بالوصول إلى 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):
- تجنب العبّارات. عرض
FerryInfo
- تجنب رسوم العبور. عرض
TollInfo
- [معاينة] اختيار المسار "درجات حرارة اقتصادية" استنادًا إلى نوع المحرّك لمزيد من التفاصيل، راجِع الحصول على مسار صديق للبيئة.
الميزات التجريبية
إنّ الميزات التالية تجريبية وهي متاحة فقط لعملاء محدّدين:
السمات الأساسية المعروضة من خلال Routes API
- تم استخدام الرمز المميّز للمسار كإدخال اختياري. يمكنك الاطّلاع على
routeToken
فيRoute
.
المعلومات التي يمكن أن تكون متوفرة على طول الخطوط المتعددة
- قياس حالات تأخير الازدحام المروري بدقائق حركة المرور. يمكنك الاطّلاع على
IncidentType
. - تعدادات الحوادث بدون تفاصيل الحوادث النصية يمكنك الاطّلاع على
IncidentInfo
.
يمكنك الاطّلاع على PolylineDetails
.
ميزات أخرى
- الارتفاع على طول المسار. يمكنك الاطّلاع على
AltitudeInfo
. - حِزم السرعة المتوقّعة على طول المسار (8 دلاء، يتراوح عرض كل مجموعة بين 10 و20 كم/ساعة). يمكنك الاطّلاع على
PredictedSpeedInfo
.
أدوات تعديل المسارات
ويمكنك تشغيل ما يلي RouteModifiers
من واجهة برمجة التطبيقات. ومع ذلك، قد لا تلتزم المسارات بهدف التعديل لأنّها لا تزال قيد التطوير والاختبار. يُرجى التواصل مع ممثل Google الذي تتعامل معه إذا كان لديك أي أسئلة.
- تجنَّب استخدام "إعلانات الشاشة الكاملة" (
avoidVignettes[]
)، لأنّ هذه الميزة متاحة في ستة بلدان: النمسا وسويسرا وهنغاريا وسلوفينيا وسلوفاكيا وجمهورية التشيك. - السماح بالطرق ذات الإشغال المرتفع (HOV) (
hovPreference
). متوفرة في الولايات المتحدة وكندا. - تجنَّب الأنفاق (
avoidTunnels
). - المسارات الخاصة بالقطارات (
totalAxleCount
وtotalHeightMm
وtotalLengthMm
وtotalWidthMm
وtotalWeightKg
)