דף זה תורגם על ידי Cloud Translation API.

יצירת סוגים אחרים של משימות

במסמך הזה אנחנו מניחים שקראתם את מדריך המבוא בנושא משימות מתוזמנות בקטע מבוא ל-Fleet Engine, וגם את המאמר מהי משימה מתוזמנת? בקטע הזה.

‫Fleet Engine למשימות מתוזמנות מספק קטגוריות רחבות שונות של משימות:

משימות משלוח: לשימוש במשימות נהיגה, כולל איסוף ומשלוח של משלוחים.
משימות של זמינות: משמשות לציון זמנים שבהם הנהגים לא זמינים, למשל הפסקות חובה.
משימות עצירה מתוזמנות: משמשות למשימות שלא קשורות לנהיגה בתיבות דואר או במיקומי לקוחות, כמו זמן הכניסה לבניין או איתור נקודת מסירה.

במאמר הזה מוסבר איך ליצור בשרת משימות שלא קשורות למשלוח. למידע על סוגי משימות משלוח, אפשר לעיין במאמר יצירת משימות משלוח.

שדות של משימות שאינן קשורות לנהיגה

בקטע הזה מתועדים שדות המשימות שנדרשים למשימות של חוסר זמינות ולמשימות של הפסקה מתוזמנת.

שדות חובה במשימה

לכל משימה שיוצרים ב-Fleet Engine, צריך לספק את שדות החובה, ואפשר גם לספק את השדות האופציונליים. ‫Fleet Engine מתעלם מכל שאר השדות, וזורק חריגה אם בקשה ליצירת משימה מספקת ערך מוקצה deliveryVehicleId. כדי להקצות משימות לרכב, צריך להשתמש ב-UpdateDeliveryVehicleRequest. מידע נוסף זמין במאמר בנושא עדכון משימות.

שדה	ערך
`type`	מגדירים את הסוג שמתאים לסוג המשימה, שהוא אחד מהערכים הבאים: `PICKUP` `DELIVERY` `SCHEDULED_STOP` `UNAVAILABLE`
`state`	`State.OPEN`
`task_id`	מזהה משימה ייחודי. הערך הזה לא יכול להיות מספר המעקב של המשלוח. אם אין לכם מזהי משימות במערכת, אתם יכולים ליצור מזהה ייחודי אוניברסלי (UUID). לפרטים נוספים, ראו מזהי משימות.
`tracking_id`	משימות `PICKUP` או `DELIVERY` בלבד: המספר או המזהה שבהם אתם משתמשים כדי לעקוב אחרי משלוח. אל תציינו את השדה הזה למשימות שלא קשורות למשלוח.
`planned_location`	`PICKUP`, `DELIVERY` או `SCHEDULED_STOP` משימות בלבד: המיקום שבו צריך להשלים את המשימה. לא נדרש עבור משימות `UNAVAILABLE`.
`task_duration`	הזמן הצפוי להשלמת המשימה. לדוגמה, לחפש חנייה או ללכת למיקום המסירה.

שדות אופציונליים של משימת משלוח

שדה	ערך
`target_time_window`	חלון הזמן שבו המשימה צריכה להסתיים. השדה הזה לא משפיע על התנהגות הניתוב.
`task_tracking_view_config`	`PICKUP` או משימות `DELIVERY` בלבד: ההגדרה למעקב אחרי משימות שמציינת אילו רכיבי נתונים גלויים למשתמשי הקצה ובאילו נסיבות.
`attributes`	רשימה של מאפייני משימה מותאמים אישית. לכל מאפיין צריך להיות מפתח ייחודי.

יצירת משימה של זמינות

אפשר ליצור משימה שמציינת חוסר זמינות, למשל להפסקות של נהגים. כדי ליצור משימה לציון זמינות, פועלים לפי ההנחיות הבאות:

מגדירים את סוג המשימה לUNAVAILABLE.
לא לכלול מזהה לצורכי מעקב.
למרות שלא צריך לציין מיקום למשימת זמינות, אם תציינו מיקום, המערכת תוכל לחשב את זמן ההגעה המשוער בצורה מדויקת יותר במהלך היום.

כשמשתפים את מיקום הרכב במסגרת משימה של UNAVAILABLE, חלים עליו כללי חשיפה מיוחדים.

אפליקציות לצרכנים שמשולבת בהן הספרייה Shipment Tracking: כשהרכב נמצא במשימת זמינות, משתמשים באפליקציה לצרכנים לא יכולים לראות את מיקום הרכב, אבל הם עדיין יכולים לראות את פרטי הסטטוס של המשלוח שלהם.
אפליקציות למעקב אחר צי רכב שמשולבות עם ספריית המעקב אחר צי רכב: כשהרכב נמצא במשימת זמינות, מנהלי צי רכב שמשתמשים באפליקציה למעקב אחר צי רכב יוכלו לראות את מיקום הרכב במשימות זמינות.

בדוגמאות הבאות מוצגות שתי דרכים ליצור משימה של זמינות מתוזמנת: באמצעות ספריית Java gRPC או באמצעות שליחת בקשת HTTP REST אל CreateTask.

gRPC

  static final String PROJECT_ID = "my-delivery-co-gcp-project";

  DeliveryServiceBlockingStub deliveryService =
    DeliveryServiceGrpc.newBlockingStub(channel);

  // Task settings
  String parent = "providers/" + PROJECT_ID;
  Task task = Task.newBuilder()
    .setType(Task.Type.UNAVAILABLE)
    .setState(Task.State.OPEN)
    .setTaskDuration(
      Duration.newBuilder().setSeconds(60 * 60))  // 1hr break
    .build();

  // Task request
  CreateTaskRequest createTaskRequest =
    CreateTaskRequest.newBuilder()  // No need for the header
        .setParent(parent)          // Avoid using auto-incrementing IDs for the taskId
        .setTaskId("task-8241890")  // Task ID assigned by the Provider
        .setTask(task)              // Initial state
        .build();

  // Error handling
  // If Fleet Engine does not have task with that ID and the credentials of the
  // requestor pass, the service creates the task successfully.

  try {
    Task createdTask = deliveryService.createTask(createTaskRequest);
  } catch (StatusRuntimeException e) {
    Status s = e.getStatus();
    switch (s.getCode()) {
       case ALREADY_EXISTS:
         break;
       case PERMISSION_DENIED:
         break;
    }
    return;
  }
  ```

REST

כדי ליצור משימה של זמינות משרת, צריך לבצע קריאת HTTP REST אל CreateTask:

POST https://fleetengine.googleapis.com/v1/providers/<project_id>/tasks?taskId=<id>

‫<id> הוא מזהה ייחודי של המשימה.

כותרת הבקשה צריכה להכיל את השדה Authorization עם הערך Bearer <token>, כאשר <token> מונפק על ידי השרת שלכם בהתאם להנחיות שמתוארות במאמרים תפקידים בחשבון שירות ואסימוני אינטרנט JSON.

גוף הבקשה צריך להכיל ישות Task עם השדות המתאימים שמתוארים במאמר שדות של משימות שאינן קשורות לנהיגה.

פקודה curl לדוגמה:

 # Set $JWT, $PROJECT_ID, and $TASK_ID in the local environment
 curl -X POST "https://fleetengine.googleapis.com/v1/providers/${PROJECT_ID}/tasks?taskId=${TASK_ID}" \
   -H "Content-type: application/json" \
   -H "Authorization: Bearer ${JWT}" \
   --data-binary @- << EOM
 {
   "type": "UNAVAILABLE",
   "state": "OPEN",
   "plannedLocation": {
      "point": {
         "latitude": -6.195139,
         "longitude": 106.820826
      }
   },
   "taskDuration": "300s"
 }
 EOM

יצירת משימה של עצירה מתוזמנת

אפשר ליצור משימה לעצירה מתוזמנת, למשל, למשימות שלא קשורות לנהיגה במיקומי לקוחות, לעצירות לתדלוק או למקרים שבהם נהג מקבל משלוחים מכלי רכב מסוג feeder. כשיוצרים משימה של עצירה מתוזמנת, חשוב לפעול לפי ההנחיות הבאות:

מגדירים את סוג המשימה ל
לא לכלול מזהה לצורכי מעקב.
אפשר גם לציין מיקום.

gRPC

  static final String PROJECT_ID = "my-delivery-co-gcp-project";

  DeliveryServiceBlockingStub deliveryService =
    DeliveryServiceGrpc.newBlockingStub(channel);

  // Task settings
  String parent = "providers/" + PROJECT_ID;
  Task task = Task.newBuilder()
    .setType(Task.Type.SCHEDULED_STOP)
    .setState(Task.State.OPEN)
    .setPlannedLocation(               // Grand Indonesia East Mall
      LocationInfo.newBuilder().setPoint(
        LatLng.newBuilder().setLatitude(-6.195139).setLongitude(106.820826)))
    .setTaskDuration(
      Duration.newBuilder().setSeconds(2 * 60))
    .build();

  // Task request
  CreateTaskRequest createTaskRequest =
    CreateTaskRequest.newBuilder()  // No need for the header
        .setParent(parent)
        .setTaskId("task-8241890")  // Task ID assigned by the Provider
        .setTrip(task)              // Initial state
        .build();

  // Error handling
  // If Fleet Engine does not have task with that ID and the credentials of the
  // requestor pass, the service creates the task successfully.

  try {
    Task createdTask = deliveryService.createTask(createTaskRequest);
  } catch (StatusRuntimeException e) {
    Status s = e.getStatus();
    switch (s.getCode()) {
       case ALREADY_EXISTS:
         break;
       case PERMISSION_DENIED:
         break;
    }
    return;
  }
  ```

REST

כדי ליצור משימת עצירה מתוזמנת מסביבת שרת, מבצעים קריאת HTTP REST אל CreateTask:

POST https://fleetengine.googleapis.com/v1/providers/<project_id>/tasks?taskId=<id>

‫<id> הוא מזהה ייחודי של המשימה.

גוף הבקשה חייב להכיל ישות Task:

פקודה curl לדוגמה:

# Set $JWT, $PROJECT_ID, and $TASK_ID in the local environment
 curl -X POST "https://fleetengine.googleapis.com/v1/providers/${PROJECT_ID}/tasks?taskId=${TASK_ID}" \
   -H "Content-type: application/json" \
   -H "Authorization: Bearer ${JWT}" \
   --data-binary @- << EOM
 {
   "type": "SCHEDULED_STOP",
   "state": "OPEN",
   "plannedLocation": {
      "point": {
         "latitude": -6.195139,
         "longitude": 106.820826
      }
   },
   "taskDuration": "600s"
 }
 EOM

יצירת סוגים אחרים של משימות קל לארגן דפים בעזרת אוספים אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.

שדות של משימות שאינן קשורות לנהיגה

שדות חובה במשימה

שדות אופציונליים של משימת משלוח

יצירת משימה של זמינות

gRPC

REST

יצירת משימה של עצירה מתוזמנת

gRPC

REST

המאמרים הבאים

יצירת סוגים אחרים של משימות