ฟีดแผนการเดินทางมีข้อมูลการล่องเรือ แผนการเดินทางแต่ละรายการจะมีชุด การเดินทาง การเดินทางแต่ละครั้งจะมีรายละเอียดของการเดินทาง เช่น ท่าเรือ เวลาและวันที่การมาถึงและการออกเดินทาง ระยะเวลาการล่องเรือในแต่ละช่วงของเส้นทาง และคำอธิบายของการเดินทางแต่ละครั้ง คุณอัปโหลดฟีดแผนการเดินทางในรูปแบบ 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 | ตัวระบุดัชนีที่ไม่ซ้ำกันสำหรับแต่ละจุดในแผนการเดินทางของเรือสำราญ โดยจะ
เริ่มต้นด้วยดัชนี 0 สำหรับป้ายจอดรถแรก 0 หมายถึงท่าเรือต้นทางแรก ตัวอย่างเช่น 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 ต้องเป็น 0
ตัวอย่างเช่น 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 เดียวกัน ซึ่งช่วยให้จัดกลุ่มและ
จัดระเบียบการเดินทางได้
ตัวอย่างเช่น หากท่าเรือที่แวะพักอยู่ผ่านซานฟรานซิสโกสำหรับแผนการเดินทาง 2 แผนที่แตกต่างกัน รหัสแผนการเดินทางจะเหมือนกันสำหรับทั้ง 2 แผนการเดินทาง โดยแสดงเป็น |
| 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 |
ตัวอย่าง
ตัวอย่างพื้นฐานของฟีดแผนการเดินทางสำหรับการล่องเรือ 2 เที่ยว โดยเที่ยวหนึ่งเป็นเที่ยวเดียวและอีกเที่ยวหนึ่งเป็นแบบไปกลับ
ตัวอย่างแสดงทั้งรูปแบบ 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
ไป-กลับ (ต้องระบุ)
การล่องเรือครั้งที่ 2 เป็นการเดินทางไปกลับจากซานฟรานซิสโกไปยังอลาสก้าและ แคนาดาเป็นเวลา 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"
}
]
ไป-กลับ (ต้องระบุ)
การล่องเรือครั้งที่ 2 เป็นการเดินทางไปกลับจากซานฟรานซิสโกไปยังอลาสก้าและ แคนาดาเป็นเวลา 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"
}
]