פיד מסלולי נסיעה

פיד מסלול הנסיעה מכיל מידע על הפלגות. כל מסלול נסיעה כולל קבוצה של נסיעות. כל נסיעה מכילה פרטים על הנסיעה, כמו נמלים, תאריכים ושעות הגעה ושעת יציאה, משך ההפלגה בכל שלב של המסע ותיאור של כל נסיעה. אפשר להעלות פידים של מסלולי נסיעה בפורמט CSV.

רכיבים מרכזיים

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

הוא כולל את השדות החובה הבאים:

  • sail_id : מזהה ייחודי של הפלגה לנסיעה ספציפית.

  • stop_index : מזהה ייחודי של עצירה לכל יציאה מנמל.

  • port_of_call: נמל העגינה או המיקום שבו נערך עצירה בשייט.

  • itinerary_desc: תיאור מסלול הנסיעה.

  • arrival_dt: תאריך ושעת ההגעה לפי הזמן האוניברסלי המותאם(UTC) של הנמל.

  • departure_dt: תאריך ושעת היציאה לפי הזמן האוניברסלי המותאם (UTC) של הנמל.

  • ship_name: שם הספינה.

  • sail_duration: משך הזמן או מספר ימי ההפלגה.

שדות

בטבלה הבאה מתוארים כל השדות הזמינים בפיד מסלולי הנסיעה:

שם השדה חובה? סוג תיאור
sail_id Required string מזהה ייחודי של הפלגה לנסיעה מסוימת במסלול, עם תאריכי התחלה וסיום.

לדוגמה, במסלול של 5 לילות עם 3 תחנות, הערך של sail_id יהיה ייחודי ויישאר זהה בכל 3 התחנות. דוגמה ל-sail_id היא ABC12345.

הערה: הערכים של sail_id ו-stop_index מקושרים כדי ליצור מפתח ראשי מורכב, והם חייבים להיות ייחודיים.
stop_index Required integer מזהה ייחודי של אינדקס לכל עצירה במסלול השייט. הוא מתחיל עם אינדקס אפס לתחנה הראשונה. אפס מייצג את יציאת המטען הראשונה. לדוגמה, הערך stop_index מיוצג כ-0.

הערה: השדות sail_id ו-stop_index מקושרים כדי ליצור מפתח ראשי מורכב, והם חייבים להיות ייחודיים.
port_of_call Required string המיקום עם שם העיר והמדינה שבהן אוניית השיט עוצרת. לדוגמה, את הפונקציה port_of_call אפשר לבטא בצורה Venice,Italy.

אין צורך להוסיף מירכאות (").

itinerary_desc Required string תיאור מסלול הנסיעה. השם מתחיל ב-'X-night', כאשר X הוא מספר הלילות במסלול הנסיעה. הוא לא תלוי אותיות רישיות. לדוגמה, הערך של itinerary_desc יכול להיות 7-night greek isles & eastern med.
arrival_dt Required datetime תאריך ושעת ההגעה לפי זמן אוניברסלי מתואם(UTC) של הנמל. השדה arrival_dt של היציאה הראשונה חייב להיות ריק, והשדה stop_index חייב להיות אפס. לדוגמה, הערך arrival_dt מיוצג כ-2025-01-22T06:00:00+01:00.
departure_dt Required datetime תאריך ושעת היציאה לפי הזמן האוניברסלי המתואם(UTC) של הנמל. השדה departure_dt של היציאה האחרונה חייב להיות ריק. הערך של stop_index חייב להיות הלילה האחרון של מסלול הנסיעה. לדוגמה, הערך departure_dt מיוצג כ-2025-01-23T18:00:00+01:00.
ship_name Required string שם הספינה. הוא לא תלוי אותיות רישיות. לדוגמה, את הפונקציה ship_name אפשר לבטא בצורה NORWEGIAN Escape.
sail_duration Required integer משך המסע או מספר הלילות במסע. לדוגמה, עבור 5 לילות שייט, הערך של sail_duration הוא 5.
itinerary_id Required string מזהה את מסלול הנסיעה. השדה itinerary_id מבדיל בין מסלולים שונים. כל הנסיעות שמגיעות לאותו יציאה חולקות את אותו itinerary_id, ומאפשרות לקבץ ולסדר את הנסיעות.

לדוגמה, אם שתי מסלולים שונים כוללים עצירה בסן פרנסיסקו, מזהה המסלול יהיה זהה בשני המסלולים. הוא מיוצג כ-XYZ12345.
latitude Optional decimal קו הרוחב של נמל העצירה הזה. צריך לציין אותו בסימן WGS84. המידע הזה שימושי למציאת הישות של נמל הקריאה החוזרת בצורה מדויקת. לדוגמה, קואורדינטות קו הרוחב של טרייסט, איטליה הן 45.64665541364354. אין תמיכה בתכונות הבאות:
  • טוקיו
  • GCJ-02
longitude Optional decimal קו האורך של נמל העצירה הזה. צריך לציין אותו בסימן WGS84. המידע הזה שימושי למציאת הישות של נמל הקריאה החוזרת בצורה מדויקת. לדוגמה, קו האורך של טרייסט, איטליה הוא 13.76188003458354. אין תמיכה בתכונות הבאות:
  • טוקיו
  • GCJ-02
image_url Optional URL כתובת ה-URL של תמונה שמייצגת את נמל העצירה. לדוגמה, https://partner.com/images/XXXXX.jpg
updated_at Optional datetime התאריך והשעה שבהם הרשומה עודכנה בפעם האחרונה, לפי זמן אוניברסלי מתואם(UTC). המידע הזה שימושי לזיהוי נתונים לא עדכניים. הפורמט צריך להיות ISO 8601. לדוגמה, הערך של updated_at הוא 2025-01-22T00:00:00+00:00.

דוגמאות

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

בדוגמאות מוצגים גם הפורמט CSV וגם הפורמט JSON. השדות sail_id ו-stop_index מקושרים כדי ליצור את המפתח הראשי המורכב, והם חייבים להיות ייחודיים לכל שורה.

CSV

נסיעה בכיוון אחד (חובה)

המסלול הראשון הוא שייט בכיוון אחד מסן פרנסיסקו לקנדה למשך 4 לילות. בדוגמה הבאה מוצגים רק השדות החובה:

sail_id; stop_index; port_of_call; itinerary_desc; arrival_dt; departure_dt;ship_name;sail_duration;itinerary_id
54321; 0; Seattle, Washington; 4 Night Alaska Cruise Trip; NULL;2025-05-23 15:00:00; Floating Home; 04; 888888
54321; 1; Ketchikan, Alaska; 4 Night Alaska Cruise Trip;2025-05-25 18:00:00; 2025-05-25 7:00:00; Floating Home; 04; 888888
54321; 2; Vancouver (Canada Place), British Columbia;4 Night Alaska Cruise Trip; 2025-05-27 7:30:00; NULL; Floating Home; 04; 888888

טיסה בכיוון אחד (הכול)

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

sail_id; stop_index; port_of_call; itinerary_desc; arrival_dt; departure_dt; ship_name;sail_duration; itinerary_id; latitude; longitude; image_url; updated_at
54321; 0; Seattle, Washington; 4 Night Alaska Cruise Trip; NULL; 2025-05-23 15:00:00; Floating Home;04; 888888; 47.608013; -122.335167; https://partner.com/images/XXXXX.jpg; 2025-05-23T00:00:00+00:00
54321; 1; Ketchikan, Alaska; 4 Night Alaska Cruise Trip; 2025-05-25 18:00:00; 2025-05-25 7:00:00;Floating Home; 04; 888888; 55.341808; -131.647507; https://partner.com/images/XXXXX.jpg; 2025-05-25T00:00:00+00:00
54321; 2; Vancouver (Canada Place), British Columbia; 4 Night Alaska Cruise Trip; 2025-05-27 7:30:00; NULL; Floating Home; 04; 888888; 49.246292; -123.116226; https://partner.com/images/XXXXX.jpg; 2025-05-27T00:00:00+00:00

הלוך ושוב (חובה)

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

sail_id; stop_index; port_of_call; itinerary_desc; arrival_dt; departure_dt; ship_name;sail_duration; itinerary_id
12345; 0; San Francisco, California; 14 Night Alaska Cruise with Glacier Bay National Park; NULL;2025-06-06 16:00:00; Beautiful Ship; 14; 888888
12345; 1; Ketchikan, Alaska; 14 Night Alaska Cruise with Glacier Bay National Park; 2025-06-09 21:00:00; 2025-06-10 5:00:00; Beautiful Ship; 14; 888888
12345; 2; Vancouver (Canada Place), British Columbia; 14 Night Alaska Cruise with Glacier Bay   National Park; 2025-06-13 14:00:00; 2025-06-14 20:00:00; Beautiful Ship; 14; 888888
12345; 3; Victoria, British Columbia; 14 Night Alaska Cruise with Glacier Bay National Park 2025-06-15 21:00:00; 2025-06-16 6:00:00; Beautiful Ship; 14; 888888
12345; 4; San Francisco, California; 14 Night Alaska Cruise with Glacier Bay National Park 2025-06-20 7:00:00; NULL; Beautiful Ship; 14; 888888

הלוך ושוב (הכול)

הדוגמה הבאה ממחישה את כל השדות הזמינים לנסיעה הלוך ושוב:

sail_id; stop_index; port_of_call; itinerary_desc; arrival_dt; departure_dt; ship_name; sail_duration; itinerary_id; latitude; longitude; image_url; updated_at
12345; 0; San Francisco, California; 14 Night Alaska Cruise with Glacier Bay National Park; NULL; 2025-06-06 16:00:00; Beautiful Ship; 14; 888888; 37.773972; -122.431297; https://partner.com/images/XXXXX.jpg; 2025-06-06T00:00:00+00:00
12345; 1; Ketchikan, Alaska; 14 Night Alaska Cruise with Glacier Bay National Park; 2025-06-09 21:00:00; 2025-06-10 5:00:00; Beautiful Ship; 14; 888888; 55.341808; -131.647507; https://partner.com/images/XXXXX.jpg;  2025-06-09T00:00:00+00:00
12345; 2; Vancouver (Canada Place), British Columbia; 14 Night Alaska Cruise with Glacier Bay National Park; 2025-06-13 14:00:00; 2025-06-14 20:00:00; Beautiful Ship; 14; 888888; 49.246292; -123.116226; https://partner.com/images/XXXXX.jpg; 2025-06-13T00:00:00+00:00
12345; 3; Victoria, British Columbia; 14 Night Alaska Cruise with Glacier Bay National Park; 2025-06-15 21:00:00; 2025-06-16 6:00:00; Beautiful Ship; 14; 888888; 48.407326; -123.329773; https://partner.com/images/XXXXX.jpg; 2025-06-15T00:00:00+00:00
12345; 4; San Francisco, California; 14 Night Alaska Cruise with Glacier Bay National Park;2025-06-20 7:00:00; NULL; Beautiful Ship; 14; 888888; 37.773972; -122.431297; https://partner.com/images/XXXXX.jpg; 2025-06-20T00:00:00+00:00

JSON (לצורכי מידע בלבד)

נסיעה בכיוון אחד (חובה)

המסלול הראשון הוא שייט בכיוון אחד מסן פרנסיסקו לקנדה למשך 4 לילות. בדוגמה הבאה מוצגים רק השדות החובה:

[
  {
    "sail_id": "54321",
    "stop_index": "0",
    "port_of_call": "Seattle, Washington",
    "itinerary_desc": "4 Night Alaska Cruise Trip",
    "arrival_dt": null,
    "departure_dt": "2025-05-23 15:00:00",
    "ship_name": "Floating Home",
    "sail_duration": 4,
    "itinerary_id": "888888"
  },
  ---
  {
    "sail_id": "54321",
    "stop_index": "2",
    "port_of_call": "Vancouver (Canada Place), British Columbia",
    "itinerary_desc": "4 Night Alaska Cruise Trip",
    "arrival_dt": "2025-05-27 7:30:00",
    "departure_dt": null,
    "ship_name": "Floating Home",
    "sail_duration": 4,
    "itinerary_id": "888888"
  }
]

נסיעה בכיוון אחד (הכול)

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

[
  {
    "sail_id": "54321",
    "stop_index": "0",
    "port_of_call": "Seattle, Washington",
    "itinerary_desc": "4 Night Alaska Cruise Trip",
    "arrival_dt": "2025-05-23 15:00:00",
    "departure_dt": null,
    "ship_name": "Floating Home",
    "sail_duration": 4,
    "itinerary_id": "888888",
    "latitude": "47.608013",
    "longitude": "-122.335167",
    "image_url": "https://partner.com/images/XXXXX.jpg",
    "updated_at": "2025-05-23T00:00:00+00:00"
  },
  ---
  {
    "sail_id": "54321",
    "stop_index": "2",
    "port_of_call": "Vancouver (Canada Place), British Columbia",
    "itinerary_desc": "4 Night Alaska Cruise Trip",
    "arrival_dt": null,
    "departure_dt": "2025-05-27 7:30:00",
    "ship_name": "Floating Home",
    "sail_duration": 4,
    "itinerary_id": "888888",
    "latitude": "49.246292",
    "longitude": "-123.116226",
    "image_url": "https://partner.com/images/XXXXX.jpg",
    "updated_at": "2025-05-27T00:00:00+00:00"
  }
]

הלוך ושוב (חובה)

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

[
  {
    "sail_id": "12345",
    "stop_index": "0",
    "port_of_call": "San Francisco, California",
    "itinerary_desc": "14 Night Alaska Cruise with Glacier Bay National Park",
    "arrival_dt": null,
    "departure_dt": "2025-06-06 16:00:00",
    "ship_name": "Beautiful Ship",
    "sail_duration": 14,
    "itinerary_id": "888888"
  },
  {
    "sail_id": "12345",
    "stop_index": "1",
    "port_of_call": "Ketchikan, Alaska",
    "itinerary_desc": "14 Night Alaska Cruise with Glacier Bay National Park",
    "arrival_dt": "2025-06-09 21:00:00",
    "departure_dt": "2025-06-10 5:00:00",
    "ship_name": "Beautiful Ship",
    "sail_duration": 14,
    "itinerary_id": "888888"
  },
  ---
  {
    "sail_id": "12345",
    "stop_index": "4",
    "port_of_call": "San Francisco, California",
    "itinerary_desc": "14 Night Alaska Cruise with Glacier Bay National Park",
    "arrival_dt": "2025-06-20 7:00:00",
    "departure_dt": null,
    "ship_name": "Beautiful Ship",
    "sail_duration": 14,
    "itinerary_id": "888888"
  }
]

הלוך ושוב (הכול)

הדוגמה הבאה ממחישה את כל השדות הזמינים לנסיעה הלוך ושוב:

[
  {
    "sail_id": "12345",
    "stop_index": "0",
    "port_of_call": "San Francisco, California",
    "itinerary_desc": "14 Night Alaska Cruise with Glacier Bay National Park",
    "arrival_dt": null,
    "departure_dt": "2025-06-06 16:00:00",
    "ship_name": "Beautiful Ship",
    "sail_duration": 14,
    "itinerary_id": "888888",
    "latitude": "37.773972",
    "longitude": "-122.335167",
    "image_url": "https://partner.com/images/XXXXX.jpg",
    "updated_at": "2025-06-06T00:00:00+00:00"
  },
  {
    "sail_id": "12345",
    "stop_index": "1",
    "port_of_call": "Ketchikan, Alaska",
    "itinerary_desc": "14 Night Alaska Cruise with Glacier Bay National Park",
    "arrival_dt": "2025-06-09 21:00:00",
    "departure_dt": "2025-06-10 5:00:00",
    "ship_name": "Beautiful Ship",
    "sail_duration": 14,
    "itinerary_id": "888888",
    "latitude": "55.341808",
    "longitude": "-131.647507",
    "image_url": "https://partner.com/images/XXXXX.jpg",
    "updated_at": "2025-06-09T00:00:00+00:00"
  },
  ---
  {
    "sail_id": "12345",
    "stop_index": "4",
    "port_of_call": "San Francisco, California",
    "itinerary_desc": "14 Night Alaska Cruise with Glacier Bay National Park",
    "arrival_dt": "2025-06-20 7:00:00",
    "departure_dt": null,
    "ship_name": "Beautiful Ship",
    "sail_duration": 14,
    "itinerary_id": "888888",
    "latitude": "37.773972",
    "longitude": "-122.431297",
    "image_url": "https://partner.com/images/XXXXX.jpg",
    "updated_at": "2025-06-20T00:00:00+00:00"
  }
]