با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
این راهنما مفاهیم اصلی وسایل نقلیه Fleet Engine و نحوه کار آنها را توضیح می دهد. حتما بخوانید Fleet Engine چیست؟ و از ارائه خدمات Mobility خاص که استفاده می کنید آگاه باشید:
در Fleet Engine، وسیله نقلیه یک موجودیت داده است که نشان دهنده وسیله نقلیه واقعی است که توسط رانندگان برای حمل کالا یا افراد از مبدا به مقصد استفاده می شود.
موجودیت وسیله نقلیه مکانیزمی است که توسط آن یکی از موارد زیر را انجام می دهید:
سفرهای درخواستی را برای تحویل و تحویل در طول روز راننده مدیریت کنید.
توقف های برنامه ریزی شده را برای یک سری از کارهای برنامه ریزی شده در طول روز راننده مدیریت کنید.
تصویر در اینجا خودرو را به عنوان یک جفت وسیله نقلیه-دستگاه نشان می دهد. فرض بر این است که درایور از دستگاهی استفاده می کند که برنامه درایور شما را اجرا می کند. در طول روز، برنامه شما جریانی از به‌روزرسانی‌های مکان را به Fleet Engine ارسال می‌کند. راننده همچنین از برنامه برای پذیرش تکالیف و علامت گذاری کامل آنها قبل از خروج از ایستگاه استفاده می کند. Fleet Engine این داده‌ها را ذخیره می‌کند و شما به اطلاعات موقعیت مکانی ترکیبی و وضعیت فعالیت تجاری برای سفر دسترسی دارید تا راه‌حل‌هایی را برای اپراتور ناوگان خود بسازید.
مدل داده برای عناصر وسیله نقلیه و سفر
نمودارهای زیر مدل های داده ساده شده DeliveryVehicle برای توقف های برنامه ریزی شده و Vehicle برای سفرهای درخواستی را نشان می دهد.
این بخش مفهوم سفر در Fleet Engine را معرفی می کند. در این مستندات، برنامه سفر مجموعه ای از تکالیف برای وسیله نقلیه برای یک دوره کاری معین، مانند یک روز است. برای خدمات زمان‌بندی‌شده، این شامل مانیفست و ترتیب تحویل‌ها می‌شود. برای درخواست، این شامل تعداد سفرهای تعیین شده در هر دوره معین می شود. وسیله نقلیه زمانی برنامه سفر خود را کامل می‌کند که تمام توقف‌های مرتبط با آن پاک شوند.
این نمودارها نمونه عملیات را برای یک برنامه سفر خودرو نشان می دهد.
در Fleet Engine، مکان وسیله نقلیه، موقعیت جغرافیایی خاص یک وسیله نقلیه فعال در هر مقطع زمانی است، صرف نظر از اینکه آیا به یک ایستگاه رسیده یا از آن خارج شده است یا خیر. Fleet Engine از فیلد last_location روی شی وسیله نقلیه برای جمع‌آوری داده‌های موقعیت مکانی نزدیک به زمان واقعی و همچنین سایر داده‌های سفر مانند سمت، سرعت و ارتفاع استفاده می‌کند.
جدول زیر دستورالعمل‌هایی را برای ارسال به‌روزرسانی‌های موقعیت مکانی به Fleet Engine ارائه می‌کند:
مکان وسیله نقلیه
فرکانس
توصیه می شود : از مقدار پیش فرض استفاده کنید که هر 10 ثانیه یک بار است.
اگر به‌روزرسانی‌های فرکانس مکان را تغییر می‌دهید (توصیه نمی‌شود)، باید آنها را حداقل هر دقیقه یک بار و حداکثر هر 5 ثانیه یک بار ارسال کنید.
روش به روز رسانی مکان
درایور SDK
توصیه شده.
درایور SDK برای iOS
درایور SDK برای اندروید
کد سفارشی
اگر مکان‌های خودرو را از طریق سیستم پشتیبان خود منتقل می‌کنید، یا اگر از دستگاه‌هایی غیر از Android یا iOS استفاده می‌کنید، از این استفاده کنید. این کار را با تماس مستقیم با Fleet Engine انجام دهید.
دستورالعمل ها
دستورالعمل های مرتبط:
__به روز رسانی وظایف__ در راهنمای اختصاص و سفارش وظایف.
__به‌روزرسانی وضعیت سفر__ در راهنمای مدیریت سفرها.
خودرو متوقف می شود
توقف وسیله نقلیه یک عنصر کلیدی سفر وسیله نقلیه است که کل مسیر یک وسیله نقلیه از مبدأ تا پایان یک وظیفه خاص است.
همانطور که تکالیف یا سفر برای یک وسیله نقلیه را انجام می دهید و مدیریت می کنید، مکان هایی را نیز برای انجام آن تکالیف ارائه می کنید، و آن مکان ها با یک توقف مشخص برای سفر وسیله نقلیه، چه به عنوان یک کار یا فعالیت سفر، مرتبط می شوند.
برای سفرهای درخواستی ، فعالیت‌های تحویل یا تحویل در مکان‌های توقف مشخصی انجام می‌شوند که در مدل داده‌های درخواستی به عنوان ایستگاه‌های بین سفر شناخته می‌شوند.
برای توقف‌های برنامه‌ریزی‌شده ، یک توقف شامل فهرستی از وظایفی است که باید در محل توقف خودرو تکمیل شوند، مانند تحویل و تحویل تعدادی بسته. همچنین ممکن است استراحت های برنامه ریزی شده را در یک توقف مشخص تعیین کنید.
به طور معمول، یک سفر زمانی کامل می شود که راننده تکالیف را از صف خود پاک کند. در آن مرحله، وضعیت تراکنش را برای استفاده بعدی در تجزیه و تحلیل و صورت‌حساب به Fleet Engine ارسال می‌کنید.
تاریخ آخرین به‌روزرسانی 2025-07-29 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونهها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین به‌روزرسانی 2025-07-29 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eFleet Engine uses vehicle entities to manage on-demand trips and scheduled tasks for drivers.\u003c/p\u003e\n"],["\u003cp\u003eA vehicle's itinerary in Fleet Engine represents all its assignments for a work period, including trips or tasks.\u003c/p\u003e\n"],["\u003cp\u003eVehicle location is crucial and should be updated at least every minute using the Driver SDK or custom code.\u003c/p\u003e\n"],["\u003cp\u003eVehicle stops are associated with trip waypoints for on-demand trips or task lists for scheduled stops, forming a vehicle journey.\u003c/p\u003e\n"],["\u003cp\u003eUpon journey completion, update Fleet Engine with the transaction status for analytics and billing purposes.\u003c/p\u003e\n"]]],[],null,["This guide describes core concepts for Fleet Engine vehicles and how they work.\nBe sure to read [What is Fleet Engine?](/essentials) and be aware of the specific\nMobility service offering that you use:\n\n- [On-demand trips](/maps/documentation/mobility/fleet-engine/essentials/trip-intro)\n- [Scheduled tasks](/maps/documentation/mobility/fleet-engine/essentials/tasks-intro)\n\nWhat is a vehicle?\n\nIn Fleet Engine, a vehicle is a data entity that represents the real-life\nvehicle used by drivers to transport goods or people from an origin to a\ndestination.\n\nThe vehicle entity is the mechanism by which you accomplish one of the following:\n\n- Manage **on-demand trips** for a pickup and dropoff assigned throughout a driver's day.\n- Manage **scheduled stops** for a series of planned tasks during a driver's day.\n\nThe illustration here represents the vehicle as a vehicle-device pair. The\nassumption is that the driver uses a device that runs your driver application.\nThroughout the day, your app sends a stream of location updates to Fleet Engine.\nThe driver also uses the app to accept assignments and mark them complete before\nleaving the a stop. Fleet Engine stores this data, and you have access to the\ncombined location information and business activity status for the journey to\nbuild solutions for your fleet operator as you see fit.\n\nData model for vehicle and journey elements\n\nThe following diagrams illustrate simplified data models of the\n`DeliveryVehicle` for scheduled stops and the `Vehicle` for on-demand trips. \n\nOn-demand trips\n\n\nScheduled tasks\n\n\nVehicle itinerary\n\nThis section introduces the concept of an **itinerary** in Fleet Engine. In this\ndocumentation, an itinerary is the collection of assignments for the vehicle for\na given work period, such as a day. For scheduled services, this includes the\nmanifest and the sequence of deliveries. For on-demand, this includes the number\nof trips assigned at any given period. The vehicle completes its itinerary when\nall stops associated with have been cleared.\n\nThese diagrams illustrate sample operations for a vehicle itinerary. \n\nOn-demand trips\n\n\n\u003cbr /\u003e\n\n\nThis scenario represents an itinerary with two trips back to back.\nlocations. Here, the drop off location for Trip 1 is the same as the pickup\nlocation for Trip 2.\n\nScheduled tasks\n\n\n\u003cbr /\u003e\n\n\nThis scenario represents an itinerary with a variety of stop and task\nlocations. Note: Fleet Engine doesn't store address information.\nTheir use in this diagram illustrates how a vehicle can stop at one\nlocation associated with tasks that have separate locations.\n\nVehicle location\n\nIn Fleet Engine, vehicle location is the specific geographic location of an\nactive vehicle at any instance in time, regardless of whether or not it has\narrived at or departed from a stop. Fleet Engine uses the `last_location` field\non the vehicle object to collect near real-time location data, as well as\nother travel data, such as heading, speed, and altitude.\n| **Note:** Fleet Engine does not automatically detect the location. To ensure proper vehicle location updates for an active vehicle, you must send them to Fleet either with the Driver SDK or by using your own backend through a direct call to Fleet Engine.\n\nThe following table provides guidelines for sending location updates\nto Fleet Engine:\n\n| Vehicle Location ||\n|----------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| Frequency | **Recommended**: use the default value, which is once every 10 seconds. If you do change location frequency updates (not recommended), you must send them at least once every minute and no more than once every 5 seconds. |\n| Method of location updates | |-------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------| | Driver SDK | **Recommended.** Driver SDK for iOS Driver SDK for Android | | Custom code | Use this if you relay vehicle locations through your own backend system, or if you use devices other than Android or iOS. Do this with a direct call to Fleet Engine. | |\n| Instructions | Related instructions: __Update tasks__ in the Assign and order tasks guide. __Update trip status__ in the Manage trips guide. |\n\nVehicle stops\n\nA vehicle stop is a key element of a **vehicle journey**, which is the entire\nroute for a vehicle from origin to the termination of a specific assignment.\n\nAs you make and manage task or trip assignments for a vehicle, you also provide\nlocations for those assignments to occur, and those locations become associated\nwith a given stop for the vehicle journey, either as a task or trip activity.\n\n- For **on-demand trips**, pickup or dropoff activities occur at given stop locations, which are known as trip waypoints in the on-demand data model.\n- For **scheduled stops**, a stop contains the list of tasks to be completed at the vehicle stop location, such as delivering and picking up a number of packages. You might also assign scheduled breaks at a given stop.\n\nTypically, a journey is complete when the driver clears the assignments from\ntheir queue. At that point, you send the transaction status to Fleet Engine\nfor later use in analytics and billing.\n\nWhat's next\n\n- [On-demand trips](/maps/documentation/mobility/fleet-engine/essentials/trip-intro)\n- [Scheduled tasks](/maps/documentation/mobility/fleet-engine/essentials/tasks-intro)\n- [Create vehicles](/maps/documentation/mobility/fleet-engine/essentials/vehicles)"]]
