مرجع سريع حول حزمة SDK للمستهلك في JavaScript

تتيح حزمة تطوير البرامج (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 في الحالات التالية:

حزمة تطوير البرامج (SDK) للمستهلكين في JavaScript: الإعداد

حزمة تطوير البرامج (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

يمكنك الاطّلاع على الأدلة المرتبطة أدناه لكل مهمة، أو المقارنة بين المنتجات في مستكشف الإمكانات.