تتضمّن Routes Library في Maps JavaScript API الفئتَين
Route
و
RouteMatrix
اللتَين تحلّان محلّ العنصرَين القديمَين
DirectionsService
و
DistanceMatrixService. حمِّل المكتبة في تطبيق الويب باستخدام
google.maps.importLibrary("routes")
(راجِع استخدام
حِزم تطوير البرامج (SDK) من جهة العميل لمعرفة سبب استخدام تطبيقات المتصفّح لهذه المكتبة
بدلاً من طلب خدمة الويب https://routes.googleapis.com
مباشرةً).
صف واحد (Route)
توفّر الفئة Route الطريقة computeRoutes() التي تعرض المسار المثالي بين موقعَين جغرافيَّين. يمكنك تقديم الاتجاهات مع معلومات عن حركة المرور في الوقت الفعلي لوسائل النقل العام أو ركوب الدراجات أو القيادة أو المركبات الآلية ذات العجلتين أو المشي بين مواقع جغرافية متعددة.
صف واحد (RouteMatrix)
تعرض الفئة RouteMatrix المسافات ومدد الرحلات لمصفوفة من المسارات بين مواقع جغرافية مختلفة لنقاط الانطلاق والوجهات. يمكنك حساب مُدد الرحلات والمسافات لوجهات متعددة لما يصل إلى 625 عنصر مسار.
اختيار فئة لحالة الاستخدام
- تخطيط المسار مع محطات توقّف متعددة: استخدِم
Route.computeRoutes(). وتتيح هذه الواجهة استخدام نقاط المسار المتوسطة وتحسين محطات التوقف والمسارات البديلة وتقديرات رسوم العبور. لرسم المسار على خريطة ثنائية الأبعاد، استخدِمcreatePolylines()وcreateWaypointAdvancedMarkers(). لعرض مسار على خريطة ثلاثية الأبعاد، استخدِم مكوّن الويبRoute3DElement(<gmp-route-3d>) أو استدعِcreate3DPolylines()وcreatePopover()وcreateWaypointMarkers(). - الإرسال والمطابقة مع أقرب موقع جغرافي: يمكنك استخدام
RouteMatrix.computeRouteMatrix()لمقارنة مُدد الرحلات والمسافات بين عدة نقاط انطلاق ووجهات، بما يصل إلى 625 عنصر مسار. على سبيل المثال، يمكنك تعيين أقرب سائق لعملية استلام أو اختيار أقرب مستودع لعملية تسليم.