تحتوي خلاصة برنامج الرحلة على معلومات حول الإبحار في رحلة بحرية. يتضمّن كل برنامج رحلة مجموعة من الرحلات. تحتوي كل رحلة على تفاصيل عن الرحلة، مثل الموانئ وأوقات الوصول والمغادرة والتواريخ ومدة الإبحار لكل مرحلة من الرحلة ووصف كل رحلة. يمكنك تحميل خلاصات برامج الرحلات بتنسيق CSV.
المكونات الرئيسية
تحتوي خلاصة برنامج الرحلة على حقول مطلوبة غير حسّاسة لحالة الأحرف. بعض الحقول اختيارية ويمكن تركها فارغة. يؤدي إرسال البيانات الاختيارية إلى تحسين جودة البيانات.
يحتوي على الحقول الإلزامية التالية:
-
sail_id: معرّف فريد للرحلة البحرية لرحلة معيّنة.
stop_index: معرّف محطة فريد لكل منفذ مغادرةport_of_call: ميناء التوقف أو الموقع الجغرافي الذي تتوقف فيه الرحلة البحريةitinerary_desc: وصف برنامج الرحلةarrival_dt: تاريخ ووقت الوصول بالتوقيت العالمي المنسَّق للميناء.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"
}
]