تحتوي خلاصة برنامج الرحلة على معلومات عن رحلات السفن السياحية. يتضمّن كل برنامج رحلة مجموعة من الرحلات. تحتوي كل رحلة على تفاصيلها، مثل الموانئ وأوقات الوصول والمغادرة وتواريخهما، ومدة الإبحار في كل مرحلة من الرحلة، ووصف كل رحلة. يمكنك تحميل خلاصات برنامج الرحلة بتنسيق 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` نفسه، ما يسمح بتجميع الرحلات وتنظيمها.
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"
}
]