หน้านี้ได้รับการแปลโดย Cloud Translation API

ฟีดแผนการเดินทาง

ฟีดแผนการเดินทางมีข้อมูลการออกเดินทางของเรือสำราญ แผนการเดินทางแต่ละรายการมีชุดการเดินทาง การเดินทางแต่ละครั้งจะมีรายละเอียดของการเดินทาง เช่น ท่าเรือ เวลาและวันที่มาถึงและออกเดินทาง ระยะเวลาการแล่นเรือในแต่ละระยะของการเดินทาง และรายละเอียดของการเดินทางแต่ละครั้ง คุณอัปโหลดฟีดแผนการเดินทางในรูปแบบ CSV ได้

องค์ประกอบหลัก

ฟีดแผนการเดินทางมีช่องที่ต้องกรอกซึ่งไม่คำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่ ฟิลด์บางช่องเป็นฟิลด์ที่ไม่บังคับและสามารถปล่อยว่างไว้ได้ การส่งข้อมูลที่เลือกได้จะช่วยปรับปรุงคุณภาพของข้อมูล

โดยไฟล์ดังกล่าวจะมีช่องที่ต้องกรอกต่อไปนี้

sail_id : ตัวระบุการแล่นเรือที่ไม่ซ้ำกันสำหรับการเดินทางหนึ่งๆ
stop_index : ตัวระบุป้ายจอดรถที่ไม่ซ้ำกันสำหรับแต่ละท่าเรือต้นทาง

ประเด็นสำคัญ: 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	ตัวระบุดัชนีที่ไม่ซ้ำกันสำหรับแต่ละจุดจอดของแผนการเดินทางของเรือสำราญ โดยเริ่มจากดัชนี 0 สำหรับป้ายแรก 0 หมายถึงพอร์ตต้นทางแรก เช่น `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` ต้องเท่ากับ 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 รายการก็จะเหมือนกัน ซึ่งจะแสดงเป็น `XYZ12345`
latitude	Optional	decimal	ละติจูดของจุดจอดเรือนี้ โดยควรระบุในรูปแบบ `WGS84` ข้อมูลนี้มีประโยชน์ในการระบุตำแหน่งของนิติบุคคลที่เป็นผู้เรียกให้แสดง เช่น พิกัดละติจูดของเมือง Trieste ในอิตาลีคือ `45.64665541364354` ระบบไม่รองรับสิ่งต่อไปนี้ โตเกียว GCJ-02
longitude	Optional	decimal	ลองจิจูดของท่าเรือนี้ โดยควรระบุในรูปแบบ `WGS84` ข้อมูลนี้มีประโยชน์ในการระบุตำแหน่งของนิติบุคคลที่เป็นผู้เรียกให้แสดง เช่น พิกัดลองจิจูดของเมือง Trieste ในอิตาลีคือ `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`

ตัวอย่าง

ต่อไปนี้เป็นตัวอย่างพื้นฐานของฟีดแผนการเดินทางสำหรับการเดินทาง 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 (มีไว้เพื่อให้ข้อมูล)