פיד מסלול הנסיעה מכיל מידע על הפלגות. כל מסלול נסיעה כולל קבוצה של נסיעות. כל נסיעה כוללת פרטים כמו נמלים, שעות ותאריכי הגעה ויציאה, משך השייט בכל שלב של המסע ותיאור של כל נסיעה. אפשר להעלות פידים של מסלולי נסיעה בפורמט 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 עצירות, הערך של
הערה: הערכים |
| stop_index | Required | integer | מזהה אינדקס ייחודי לכל עצירה במסלול השייט. הוא מתחיל באינדקס אפס לתחנה הראשונה. הערך אפס מייצג את נמל היציאה הראשון. לדוגמה, התו stop_index מיוצג כ-0.
הערה: הערכים |
| 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, וכך אפשר לקבץ ולארגן את הנסיעות.
לדוגמה, אם הנמל שבו עוצרים בדרך הוא סן פרנסיסקו בשני מסלולי נסיעה שונים, מזהה מסלול הנסיעה יהיה זהה בשני המסלולים. הוא מיוצג כ- |
| latitude | Optional | decimal | קו הרוחב של נמל העגינה הזה. צריך לציין אותו בסימון
WGS84. המידע הזה שימושי למיקום מדויק של ישות נמל העגינה. לדוגמה, קואורדינטות קו הרוחב של טריאסטה, איטליה, הן 45.64665541364354. אין תמיכה בתכונות הבאות:
|
| longitude | Optional | decimal | קו האורך של נמל העגינה הזה. צריך לציין אותו בסימון
WGS84. המידע הזה שימושי למיקום מדויק של ישות נמל העגינה. לדוגמה, קואורדינטות האורך של טריאסטה באיטליה הן 13.76188003458354. אין תמיכה בתכונות הבאות:
|
| 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"
}
]