تتيح حزمة تطوير البرامج (SDK) للمستهلكين في JavaScript لتطبيق المستهلك المستنِد إلى الويب عرض موقع المركبات والمواقع الأخرى التي يتم تتبُّعها في Fleet Engine على خريطة، حتى يتمكّن المستهلكون من متابعة مستوى تقدّم رحلة عند الطلب أو شحنة مجدوَلة. ويتم تحميلها كمكتبة journeySharing في Maps JavaScript API.
حزمة تطوير البرامج (SDK) للمستهلك المستندة إلى JavaScript: معلومات أساسية
- المنتج: حزمة تطوير البرامج (SDK) للمستهلكين في JavaScript
- تُعرف أيضًا باسم: حزمة تطوير البرامج (SDK) للمستهلكين في JavaScript، وJavaScript للرحلات عند الطلب في خدمات التنقّل، وحزمة تطوير البرامج (SDK) في JavaScript
- الفئة: المسارات
- المنصة: JavaScript (المتصفّح)
- يعمل على: العميل (رمز التطبيق أو المتصفّح)
- مرحلة الإطلاق: GA
- Lifecycle: نشط
- نظرة عامة: نظرة عامة على حزمة تطوير البرامج (SDK) للمستهلكين في JavaScript
حزمة تطوير البرامج (SDK) للمستهلك المستندة إلى JavaScript: حالات الاستخدام
استخدام حزمة SDK للمستهلكين المستندة إلى JavaScript في الحالات التالية:
- عليك عرض الموقع الجغرافي المباشر للمركبة ومسارها للمستهلكين في رحلة عند الطلب يتتبّعها Fleet Engine، وذلك في صفحة ويب أو تطبيق ويب.
- عليك السماح للمستهلكين بمتابعة مستوى تقدّم عملية الاستلام أو التسليم لشحنة مجدوَلة يتم تتبُّعها في Fleet Engine في متصفّح.
- عليك عرض الوقت المقدَّر للوصول والمسافة المتبقية والكثافة في حركة المرور في الوقت الفعلي على مسار رحلة في عرض خريطة مستند إلى الويب.
- تحتاج إلى تخصيص علامات الرحلات أو الخطوط المتعدّدة للمسارات أو نمط الخريطة في عرض تتبُّع المستهلك على الويب.
لا تستخدِم حزمة SDK للمستهلك في JavaScript في الحالات التالية:
- تحتاج إلى تجربة مستهلك لتتبُّع الرحلات داخل تطبيق Android أصلي. استخدِم حزمة تطوير البرامج (SDK) للمستهلكين في Android بدلاً من ذلك.
- إذا كنت بحاجة إلى تجربة تتبُّع الرحلات للمستهلكين داخل تطبيق iOS أصلي، استخدِم حزمة تطوير البرامج (SDK) للمستهلكين على أجهزة iOS بدلاً من ذلك.
- عليك إبلاغ Fleet Engine بالموقع الجغرافي للسائق ومستوى تقدّم الرحلة من تطبيق Android الخاص بالسائق. يمكنك استخدام حزمة تطوير البرامج (SDK) للسائقين على Android بدلاً من ذلك.
- عليك إبلاغ Fleet Engine بالموقع الجغرافي للسائق ومستوى تقدّم الرحلة من تطبيق iOS الخاص بالسائق. يمكنك استخدام حزمة تطوير البرامج (SDK) للسائقين على أجهزة iOS بدلاً من ذلك.
- إذا كنت بحاجة إلى خريطة ويب عامة لا تتّبع رحلات أو مهام Fleet Engine استخدِم Maps JavaScript API بدلاً من ذلك.
حزمة تطوير البرامج (SDK) للمستهلكين في JavaScript: الإعداد
- المصادقة: مفتاح واجهة برمجة التطبيقات، رمز JSON المميّز للويب (JWT)
- يجب أيضًا تفعيل: Maps JavaScript API وخدمة Fleet Engine
- تحديد مصدر الاستخدام: معرّف معاملة التنقّل الاختياري (إصدار تجريبي): اضبط
google.maps.Settings.getInstance().experienceIdsعلى مصفوفة من معرّفات معاملات التنقّل (أو المعرّفات ذات الصلة) قبل إنشاءJourneySharingMapView. لا يتوفّرexperienceIdsإلا في قناةv=betaمن Maps JavaScript API. - البدء: إعداد حزمة تطوير البرامج (SDK) للمستهلك في JavaScript
- المرجع: مرجع حزمة تطوير البرامج (SDK) للمستهلك في JavaScript
- ملاحظات الإصدار: ملاحظات إصدار حزمة تطوير البرامج (SDK) للمستهلك في JavaScript
حزمة SDK للمستهلك المستندة إلى JavaScript: المنتجات ذات الصلة
- تُستخدم غالبًا مع: خدمة Fleet Engine وMaps JavaScript API وحزمة تطوير البرامج (SDK) للسائقين على Android وحزمة تطوير البرامج (SDK) للسائقين على iOS
حزمة تطوير البرامج (SDK) للمستهلكين في JavaScript: الأخطاء الشائعة
- المشكلة: إذا لم تمنح خريطة
JourneySharingMapViewإطار عرض أوّليًا (المركز والتكبير/التصغير)، قد لا يتم تنشيط حدث'ready'في الخريطة. الحلّ: استدعِmapView.map.setCenter(...)وmapView.map.setZoom(...)بعد إنشاء عرض الخريطة. يُرجى الاطّلاع على /maps/documentation/mobility/journey-sharing/on-demand/javascript/share-journey. - المشكلة: لا يتم عرض الأخطاء الناتجة عن طلبات معلومات الرحلات غير المتزامنة. وتصل فقط كأحداث
'error'على موفّر الموقع الجغرافي، لذا لا يتم رصدها ما لم تتم إضافة أداة معالجة الحدث. الحلّ: أضِفlocationProvider.addListener('error', ...)وأدرِج طلبات المكتبة في مجموعاتtry...catch. يُرجى الاطّلاع على /maps/documentation/mobility/journey-sharing/on-demand/javascript/share-journey. - المشكلة: لا تتوفّر فئات
google.maps.journeySharingما لم يتم تحميل مكتبةjourneySharing. الحلّ: أضِفlibraries=journeySharingإلى عنوان URL الخاص بالنص البرمجي لـ Maps JavaScript API، أو حمِّل الفئات باستخدامawait google.maps.importLibrary("journeySharing"). يُرجى الاطّلاع على /maps/documentation/mobility/journey-sharing/on-demand/javascript/share-journey. - المشكلة: تتطلّب طلبات Fleet Engine من المتصفّح (بيئة منخفضة الثقة) رموز JWT التي يصدرها خادم الخلفية. لا يمنح مفتاح واجهة برمجة التطبيقات وحده الإذن بالوصول إلى بيانات الرحلات. الحلّ: يمكنك إصدار رموز JWT من الخلفية وتوفير
authTokenFetcherيعرض الرمز المميّز وexpiresInSeconds. يُرجى الاطّلاع على /maps/documentation/mobility/journey-sharing/on-demand/javascript/setup.
حزمة تطوير البرامج (SDK) للمستهلكين المستندة إلى JavaScript: الميزات القديمة والمتوقفة نهائيًا
- خيارات إعداد العلامات والخطوط المتعدّدة في
JourneySharingMapViewوJourneySharingMapViewOptions(vehicleMarkerSetupوoriginMarkerSetupوdestinationMarkerSetupوwaypointMarkerSetupوanticipatedRoutePolylineSetupوtakenRoutePolylineSetupوغيرها): متوقّفة نهائيًا. البديل: خياراMarkerCustomizationFunctionوPolylineCustomizationFunctionفي موفّر الموقع الجغرافي (على سبيل المثال،vehicleMarkerCustomization). المؤشر: من المقرّر إزالته في إصدار مستقبلي. يُرجى الاطّلاع على دليل نقل البيانات. -
JourneySharingMapView.locationProviderوJourneySharingMapViewOptions.locationProvider: متوقّف نهائيًا. الاستبدال:JourneySharingMapView.locationProvidersوJourneySharingMapViewOptions.locationProviders - سمات قائمة العلامات والخطوط المتعدّدة في
JourneySharingMapView(vehicleMarkersوoriginMarkersوdestinationMarkersوwaypointMarkersوanticipatedRoutePolylinesوtakenRoutePolylinesوسمات علامات المهام): متوقّفة نهائيًا. البديل: عمليات الاستدعاءMarkerCustomizationFunctionوPolylineCustomizationFunctionفي موفّر الموقع الجغرافي. يُرجى الاطّلاع على دليل نقل البيانات.
الإجراءات التي يمكنك تنفيذها باستخدام JavaScript Consumer SDK
يمكنك الاطّلاع على الأدلة المرتبطة أدناه لكل مهمة، أو المقارنة بين المنتجات في مستكشف الإمكانات.
- أضِف خطوطًا متعدّدة للمسار لتتبُّع رحلة من Fleet Engine إلى خريطة على صفحة ويب أو تطبيق للأجهزة الجوّالة.
- تعديل مستوى تقدّم الرحلة على طول مسار في خريطة على صفحة ويب أو تطبيق للأجهزة الجوّالة لرحلة في Fleet Engine
- تغيير نمط الطرق والخطوط المتعدّدة والمضلّعات على خريطة تتتبّع تقدّم رحلة من Fleet Engine
- عرض عناصر الخريطة أو إخفاؤها على خريطة تتتبّع تقدّم رحلة من Fleet Engine
- تغيير نمط الرموز والنصوص على خريطة تتتبّع مستوى تقدّم رحلة من Fleet Engine
- تطبيق أنماط خرائط مختلفة على مستويات تكبير مختلفة على خريطة تتتبّع مستوى تقدّم رحلة من Fleet Engine
- تغيير كثافة الأماكن على خريطة تتتبّع تقدّم رحلة من Fleet Engine ميزة تجريبية ملاحظة: تتوفّر ميزة "تصميم الخرائط باستخدام السحابة الإلكترونية" في حزمة تطوير البرامج (SDK) للمستهلكين بشكل عام، في حين أنّ ميزة "التحكّم في كثافة نقاط الاهتمام" هي ميزة تجريبية من ميزات "تصميم الخرائط باستخدام السحابة الإلكترونية" (تتوفّر في أنماط الخرائط البسيطة فقط).
- تغيير نمط المباني على خريطة تتتبّع مستوى تقدّم رحلة من Fleet Engine تجريبي ملاحظة: يتوفّر دعم "تصميم الخرائط باستخدام السحابة الإلكترونية" في حزمة تطوير البرامج (SDK) للمستهلك بشكل متوفّر للجمهور العام، في حين أنّ تخصيص نمط المباني الثلاثية الأبعاد ومساحة المباني هو ميزة تجريبية من ميزات "تصميم الخرائط باستخدام السحابة الإلكترونية" (يتوفّر في أنماط الخرائط الفاتحة فقط).
- تغيير نمط المعالم على خريطة تتتبّع مستوى تقدّم رحلة من Fleet Engine ميزة تجريبية ملاحظة: تتوفّر ميزة "تصميم الخرائط باستخدام السحابة الإلكترونية" في حزمة تطوير البرامج (SDK) للمستهلكين بشكل عام، في حين أنّ ميزة تخصيص رمز المَعلم هي ميزة تجريبية في "تصميم الخرائط باستخدام السحابة الإلكترونية" (تتوفّر في أنماط الخرائط الفاتحة فقط).
- تخصيص علامة على خريطة تتتبّع تقدّم رحلة من Fleet Engine
- تخصيص الخطوط المتعدّدة للمسار على خريطة تتتبّع تقدّم رحلة من Fleet Engine