مرجع سریع سرویس Fleet Engine

‫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: اشتباهات رایج

  • مشکل: درخواست‌ها به 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 API reportBillableEvent. نشانه: مختص قرارداد، نه منسوخ شدن میانای برنامه‌سازی کاربردی. پس‌از انتقال، تماس‌ها ممکن است «قرارداد نامعتبر: این پروژه [...] مجاز به استفاده از FleetEngine نیست» را برگردانند. راهنمای انتقال را ببینید.

کارهایی که می‌توانید با «سرویس موتور ناوگان» انجام دهید

برای هر تکلیف، راهنماهای پیوندشده در زیر را ببینید یا محصولات را در کاوشگر قابلیت‌ها با یکدیگر مقایسه کنید.