Nguồn cấp dữ liệu hành trình chứa thông tin về chuyến đi của du thuyền. Mỗi hành trình có một nhóm chuyến đi. Mỗi chuyến đi đều có thông tin chi tiết như cảng, thời gian và ngày đến và đi, thời gian đi thuyền của từng giai đoạn trong hành trình và nội dung mô tả của từng chuyến đi. Bạn có thể tải nguồn cấp dữ liệu hành trình lên ở định dạng CSV.
Thành phần chính
Nguồn cấp dữ liệu hành trình có các trường bắt buộc không phân biệt chữ hoa chữ thường. Một số trường là không bắt buộc và có thể để trống. Việc gửi dữ liệu không bắt buộc sẽ giúp cải thiện chất lượng dữ liệu.
Tệp này có các trường bắt buộc sau:
sail_id: Giá trị nhận dạng duy nhất của chuyến đi thuyền cho một chuyến đi cụ thể.stop_index: Giá trị nhận dạng duy nhất của điểm dừng cho mỗi cảng khởi hành.port_of_call: Cảng ghé tàu hoặc vị trí mà tàu dừng lại.itinerary_desc: Nội dung mô tả về hành trình.arrival_dt: Ngày và giờ đến cảng theo Giờ phối hợp quốc tế(UTC).departure_dt: Ngày và giờ khởi hành theo Giờ phối hợp quốc tế (UTC) của cảng.ship_name: Tên của con tàu.sail_duration: Thời lượng hoặc số ngày đi thuyền.
Trường
Bảng sau đây mô tả tất cả các trường có trong nguồn cấp dữ liệu hành trình:
| Tên trường | Bắt buộc? | Loại | Mô tả |
|---|---|---|---|
| sail_id | Required | string | Giá trị nhận dạng riêng biệt của chuyến đi thuyền cho một chuyến đi cụ thể trong hành trình có ngày bắt đầu và ngày kết thúc.
Ví dụ: đối với một hành trình 5 đêm có 3 điểm dừng, Lưu ý: |
| stop_index | Required | integer | Giá trị nhận dạng chỉ mục riêng biệt cho từng điểm dừng trong hành trình du thuyền. Nó bắt đầu bằng chỉ mục 0 cho điểm dừng đầu tiên. Số 0 biểu thị cổng khởi hành đầu tiên. Ví dụ: stop_index được biểu thị là 0.
Lưu ý: |
| port_of_call | Required | string | Vị trí có tên thành phố và quốc gia nơi du thuyền dừng chân.
Ví dụ: port_of_call có thể được biểu thị dưới dạng Venice,Italy.
Bạn không bắt buộc phải dùng dấu ngoặc kép ( |
| itinerary_desc | Required | string | Nội dung mô tả về hành trình. Tên này bắt đầu bằng "X-night" (X đêm), trong đó X là số đêm trong hành trình. Tham số này không phân biệt chữ hoa chữ thường.
Ví dụ: itinerary_desc có thể là 7-night greek isles & eastern med. |
| arrival_dt | Required | datetime | Ngày và giờ đến theo Giờ phối hợp quốc tế(UTC) của cảng.
arrival_dt cho cổng đầu tiên phải trống và stop_index phải bằng 0.
Ví dụ: arrival_dt được biểu thị là 2025-01-22T06:00:00+01:00. |
| departure_dt | Required | datetime | Ngày và giờ khởi hành theo Giờ phối hợp quốc tế(UTC) của cảng.
departure_dt cho cổng cuối cùng phải trống. stop_index phải là đêm cuối cùng của hành trình.
Ví dụ: departure_dt được biểu thị là 2025-01-23T18:00:00+01:00. |
| ship_name | Required | string | Tên của con tàu. Tham số này không phân biệt chữ hoa chữ thường.
Ví dụ: ship_name có thể được biểu thị dưới dạng NORWEGIAN Escape. |
| sail_duration | Required | integer | Thời gian của chuyến đi hoặc số đêm trên biển.
Ví dụ: đối với 5 đêm đi thuyền, sail_duration được biểu thị là 5. |
| itinerary_id | Required | string | Xác định hành trình. itinerary_id giúp phân biệt các hành trình với nhau. Tất cả các chuyến đi ghé thăm cùng một cảng đều có cùng itinerary_id, cho phép nhóm và sắp xếp các chuyến đi.
Ví dụ: Nếu cả hai hành trình đều có cảng ghé qua là San Francisco thì mã hành trình sẽ giống nhau cho cả hai hành trình. Được biểu thị dưới dạng |
| latitude | Optional | decimal | Vĩ độ của cảng ghé thăm này. Bạn nên chỉ định thuộc tính này bằng ký hiệu
WGS84. Thông tin này hữu ích cho việc xác định chính xác vị trí của thực thể cảng ghé. Ví dụ: toạ độ vĩ độ cho Trieste, Ý là 45.64665541364354. Các tính năng sau đây không được hỗ trợ:
|
| longitude | Optional | decimal | Kinh độ của cảng ghé thăm này. Bạn nên chỉ định giá trị này bằng ký hiệu
WGS84. Thông tin này hữu ích cho việc xác định chính xác vị trí của thực thể cảng ghé. Ví dụ: toạ độ kinh độ cho Trieste, Ý là 13.76188003458354. Các tính năng sau đây không được hỗ trợ:
|
| image_url | Optional | URL | URL của một hình ảnh đại diện cho cảng ghé. Ví dụ: https://partner.com/images/XXXXX.jpg |
| updated_at | Optional | datetime | Ngày và giờ cập nhật mục này gần đây nhất theo Giờ phối hợp quốc tế(UTC). Thông tin này hữu ích cho việc xác định dữ liệu lỗi thời. Thuộc tính này phải tuân theo định dạng
ISO 8601. Ví dụ: updated_at là 2025-01-22T00:00:00+00:00. |
Ví dụ
Sau đây là ví dụ cơ bản về nguồn cấp dữ liệu hành trình cho 2 chuyến đi thuyền, trong đó một chuyến là chuyến đi một chiều và chuyến còn lại là chuyến đi khứ hồi.
Các ví dụ này minh hoạ cả định dạng CSV và JSON. Các trường sail_id, stop_index được nối để tạo thành khoá chính tổng hợp và phải là duy nhất cho mỗi hàng.
CSV
Chuyến đi một chiều (Bắt buộc)
Hành trình hoặc chuyến đi đầu tiên là chuyến đi một chiều từ San Francisco đến Canada trong 4 đêm. Ví dụ sau đây chỉ minh hoạ các trường bắt buộc:
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
Chuyến đi một chiều (Tất cả)
Ví dụ sau đây minh hoạ tất cả các trường có sẵn cho chuyến đi một chiều:
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
Khứ hồi (Bắt buộc)
Hành trình thứ hai là hành trình khứ hồi từ San Francisco, đi qua Alaska và Canada trong 14 đêm. Ví dụ sau đây chỉ minh hoạ các trường bắt buộc:
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
Khứ hồi (Tất cả)
Ví dụ sau đây minh hoạ tất cả các trường có sẵn cho chuyến đi khứ hồi:
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 (chỉ mang tính chất thông tin)
Chuyến đi một chiều (Bắt buộc)
Hành trình hoặc chuyến đi đầu tiên là chuyến đi một chiều từ San Francisco đến Canada trong 4 đêm. Ví dụ sau đây chỉ minh hoạ các trường bắt buộc:
[
{
"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"
}
]
Chuyến đi một chiều (Tất cả)
Ví dụ sau đây minh hoạ tất cả các trường có sẵn cho chuyến đi một chiều:
[
{
"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"
}
]
Khứ hồi (Bắt buộc)
Hành trình thứ hai là hành trình khứ hồi từ San Francisco, đi qua Alaska và Canada trong 14 đêm. Ví dụ sau đây chỉ minh hoạ các trường bắt buộc:
[
{
"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"
}
]
Khứ hồi (Tất cả)
Ví dụ sau đây minh hoạ tất cả các trường có sẵn cho chuyến đi khứ hồi:
[
{
"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"
}
]