Fleet Engine سرویسی در پسزمینه است که ناوگان خودروهای شما را در دنیای واقعی مدلسازی میکند و بهروزرسانیهای مربوط به مسیریابی، زمان تخمینی رسیدن، ترافیک، و وضعیت را برای سفرهای درخواستی و کارهای زمانبندیشده ارائه میدهد. این سرویس از دادههای مکان و مسیر Driver SDK استفاده میکند و با Consumer SDK و دیگر میاناهای برنامهسازی کاربردی Google Maps Platform کار میکند.
سرویس Fleet Engine: حقایق کلیدی
- محصول: Fleet Engine Service
- با این نامها نیز شناخته میشود: Fleet Engine، Fleet Engine API، Local Rides and Deliveries API
- دسته: مسیرها
- پلاتفرم: سرویس وب (REST)
- اجرا در: سرور (کد پسین)
- مرحله راهاندازی: GA
- چرخه حیات: فعال
- نمای کلی: نمای کلی سرویس Fleet Engine
سرویس Fleet Engine: چه زمانی از آن استفاده کنیم
در موارد زیر از «سرویس Fleet Engine» استفاده کنید:
- به باطنی نیاز دارید که خودروها و سفرهای درخواستی (سوار کردن، نقطهمسیرها، پیاده کردن)، ازجمله سفرهای چندمقصدی، پشتسرهم، یا مشترک را مدلسازی کند.
- باید کارهای خدماتی یا تحویل زمانبندیشده اختصاصدادهشده به خودروها را مدلسازی کنید و توقفها، نتایج، و زمانهای تخمینی ورود آنها را ردیابی کنید.
- برای مطابقت دادن خودروها با سفرهای درخواستی، باید خودروها را در منطقهای جستجو یا فهرست کنید.
- به ردیابی سفر یا محموله مصرفکننده و ردیابی اپراتور ناوگان که توسط بهروزرسانیهای مکان «کیت توسعه نرمافزار راننده» تغذیه میشود نیاز دارید.
در موارد زیر از «سرویس موتور ناوگان» استفاده نکنید:
- باید نشانگرهای GPS زنده یا مسیرهای دارایی را روی نقشه وب از پایگاه داده یا جاریسازی خودتان نشان دهید، بدون اینکه سفر Fleet Engine یا سازماندهی تکلیف وجود داشته باشد. بهجای آن از Maps JavaScript API استفاده کنید.
- باید نشانگرها یا مسیرهای زنده را از دادههای خودتان در برنامه Android نشان دهید، بدون اینکه از Fleet Engine برای هماهنگسازی سفر یا تکلیف استفاده کنید. درعوض از کیت توسعه نرمافزار Google Maps برای Android استفاده کنید.
- باید نشانگرها یا مسیرهای زنده را از دادههای خودتان در برنامه iOS نشان دهید، بدون اینکه از Fleet Engine برای هماهنگسازی سفر یا تکلیف استفاده کنید. درعوض از کیت توسعه نرمافزار Google Maps برای iOS استفاده کنید.
- باید طرحهای مسیر بهینهشده برای کل ناوگان را محاسبه کنید؛ Fleet Engine فقط طرحهای مسیر را از حلکنندهای که ارائه میدهید میگیرد. درعوض از Route Optimization API استفاده کنید.
سرویس Fleet Engine: راهاندازی
- سرویس برای فعال کردن:
fleetengine.googleapis.com - اصالتسنجی: حساب سرویس، JSON Web Token (JWT)، OAuth 2.0
- اسناد استفاده: ویژگی بتای اختیاری: سرایند HTTP
X-Goog-Maps-Experience-IDرا روی «شناسه تراکنش Mobility» (یا شناسه مرتبط، مثل شناسه جلسه) در تماسها با سرویسهای بسته Mobility تنظیم کنید؛ شناسههای متعدد را با ویرگول از هم جدا کنید. هنگام گزارش تراکنش، شناسههای مرتبط را درrelated_idsارسال کنید. - شروع به کار: راهاندازی سرویس Fleet Engine
- مرجع: مرجع سرویس Fleet Engine
- خطمشیها: خطمشیهای سرویس Fleet Engine
- یادداشتهای انتشار: یادداشتهای انتشار Fleet Engine Service
بستههای رسمی Fleet Engine Service:
- maven:
com.google.maps:google-maps-fleetengine - maven:
com.google.maps:google-maps-fleetengine-delivery - npm:
@googlemaps/fleetengine - npm:
@googlemaps/fleetengine-delivery - pypi:
google-maps-fleetengine - pypi:
google-maps-fleetengine-delivery - برو:
cloud.google.com/go/maps
سرویس Fleet Engine: محصولات مرتبط
- اغلب با این موارد استفاده میشود: کیت توسعه نرمافزار راننده برای Android، کیت توسعه نرمافزار راننده برای iOS، کیت توسعه نرمافزار مصرفکننده برای Android، کیت توسعه نرمافزار مصرفکننده برای iOS، کیت توسعه نرمافزار مصرفکننده JavaScript، Route Optimization API
سرویس Fleet Engine: اشتباهات رایج
- مشکل: درخواستها به Fleet Engine ممکن است گاهی ناموفق باشد و پساز ناموفق بودن، نهادهایی مانند خودروها ممکن است دیگر وجود نداشته باشند (
NOT_FOUNDدر بهروزرسانی). راهحل: تلاشهای مجدد را با عقبنشینی پیادهسازی کنید (کتابخانههای کارخواه بهطور پیشفرض تلاش مجدد میکنند)، و خودروها یا تکالیف مفقودشده را در وضعیت فعلیشان بازآفرینی کنید. /maps/documentation/mobility/fleet-engine/essentials/set-up-fleet/troubleshoot را ببینید. - مشکل:
DEADLINE_EXCEEDEDخطاها زمانی رخ میدهند که درخواست بیشتر از زمان پیشفرض کتابخانه مشتری طول بکشد. راهحل: تنظیمات تکرار RPC را اصلاح کنید (برای مثال،setTotalTimeoutدرVehicleServiceSettingsدر کارخواه Java). /maps/documentation/mobility/fleet-engine/essentials/set-up-fleet/troubleshoot را ببینید. - مشکل:
PERMISSION_DENIED(HTTP 403) وقتی JWT فاقد ادعاهای صحیح است یا حساب سرویس امضاکننده فاقد نقش IAM لازم در Fleet Engine است (برای مثال، «JWT حاوی دامنه منطبق برای سفر درخواستشده نیست»). راهحل: نقشهای حساب سرویس را بررسی کنید و مطمئن شوید که ادعاهای JWT شامل دامنههایی برای خودرو، سفر، یا تکلیف مورد دسترسی باشد. /maps/documentation/mobility/fleet-engine/essentials/set-up-fleet/troubleshoot را ببینید. - مشکل: هنگام انتقال از «سفرهای درخواستی و تحویلها» به هر بسته Mobility، یا از «راهکار ناوگان مایل آخر» به Mobility Activate یا Mobility Optimize، درخواستهای Mobility Billing API تا زمانی که انتقال کامل شود HTTP 202 برمیگردانند و منجر به صدور صورتحساب نمیشوند. راهحل: از چند روز قبلاز انتقال تا چند روز بعداز آن، هم Fleet Engine
ReportBillableTripو هم Mobility Billing API را فراخوانی کنید، تعداد درخواستها را در Cloud Logging مقایسه کنید، سپس فراخوانیهایReportBillableTripرا بردارید. /maps/documentation/mobility/services/terms/billing/odrd-lmfs-migration را ببینید.
سرویس Fleet Engine: ویژگیهای قدیمی و منسوخشده
- روش
UpdateVehicleLocation: از کار افتاده از ۲۰۲۴-۰۵-۰۱. جایگزینی:UpdateVehicleدرVehicleService. نشانه: منسوخشده در ۲۰۲۴-۰۲-۰۱؛ ازکارافتاده در مه ۲۰۲۴. - روش
SearchFuzzedVehicles: از کار افتاده از ۲۰۲۴-۰۵-۰۱. جایگزینی:SearchVehiclesدرVehicleService. نشانه: منسوخشده در ۲۰۲۴-۰۲-۰۱؛ ازکارافتاده در مه ۲۰۲۴. - روش
SearchTasks: از کار افتاده از ۲۰۲۴-۰۵-۰۱. جایگزینی:GetTaskTrackingInfoدرDeliveryService. نشانه: منسوخشده در ۲۰۲۴-۰۲-۰۱؛ ازکارافتاده در مه ۲۰۲۴. ReportBillableTripپساز انتقال به بسته Mobility (سفرهای درخواستی و تحویل به هر بستهای، یا Last Mile Fleet Solution برای فعالسازی یا بهینهسازی): قدیمی. جایگزین: Mobility Billing APIreportBillableEvent. نشانه: مختص قرارداد، نه منسوخ شدن میانای برنامهسازی کاربردی. پساز انتقال، تماسها ممکن است «قرارداد نامعتبر: این پروژه [...] مجاز به استفاده از FleetEngine نیست» را برگردانند. راهنمای انتقال را ببینید.
کارهایی که میتوانید با «سرویس موتور ناوگان» انجام دهید
برای هر تکلیف، راهنماهای پیوندشده در زیر را ببینید یا محصولات را در کاوشگر قابلیتها با یکدیگر مقایسه کنید.
- گزارش استفاده از سفر Fleet Engine قابلصورتحساب.
- ایجاد و برگرداندن سفر جدید Fleet Engine.
- اطلاعات مربوط به سفر Fleet Engine را برمیگرداند.
- فهرستی از همه سفرهای Fleet Engine برای وسیله نقلیه مشخصشده برگردانید.
- بهروزرسانی دادههای سفر برای سفر Fleet Engine.
- نمونهسازی خودرو جدید در Fleet Engine مرتبط با ارائهدهنده تحویل یا سفر اشتراکی درخواستی.
- خودرویی را از سرویس Fleet Engine برگردانید.
- فهرست صفحهبندیشدهای از خودروهای موجود در Fleet Engine را که با ارائهدهنده مرتبط هستند و با معیارهای مشخصشده مطابقت دارند برمیگرداند.
- فهرستی از وسایل نقلیه در Fleet Engine را که با معیارهای مشخصشده مطابقت دارند برمیگرداند.
- بهروزرسانی دادههای وسیله نقلیه برای وسیله نقلیه در Fleet Engine.
- بهروزرسانی مشخصههای وسیله نقلیه برای وسیله نقلیه در Fleet Engine.
- اطلاعات سفر برگشت برای خودرو از سرویس Fleet Engine.