Nguồn cấp dữ liệu hành trình chứa thông tin về chuyến đi của tàu du lịch. Mỗi hành trình có một nhóm chuyến đi. Mỗi chuyến đi chứa thông tin chi tiết về chuyến đi, chẳng hạn như cảng, ngày và giờ đến và khởi hành, thời gian di chuyển của từng giai đoạn trong hành trình và nội dung mô tả về từng chuyến đi. Bạn có thể tải nguồn cấp dữ liệu về hành trình lên ở định dạng CSV.
Các 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: Mã nhận dạng chuyến đi biển duy nhất cho một chuyến đi cụ thể.stop_index: Giá trị nhận dạng điểm dừng duy nhất cho mỗi cảng khởi hành.port_of_call: Cảng ghé thăm hoặc vị trí tàu du lịch dừng lại.itinerary_desc: Nội dung mô tả hành trình.arrival_dt: Ngày và giờ đến theo Giờ phối hợp quốc tế(UTC) của cảng.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 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 hiện có trong nguồn cấp dữ liệu về 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 chuyến đi biển duy nhất 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 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 duy nhất cho mỗi điểm dừng trong hành trình của chuyến đi du thuyền. Nó bắt đầu bằng chỉ mục 0 cho điểm dừng đầu tiên. Số 0 đại diện cho 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 tàu du lịch dừng lại.
Ví dụ: port_of_call có thể được biểu thị là Venice,Italy.
Bạn không bắt buộc phải sử 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", trong đó X là số đêm trong hành trình. Mã 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 tàu. Mã này không phân biệt chữ hoa chữ thường.
Ví dụ: ship_name có thể được biểu thị là NORWEGIAN Escape. |
| sail_duration | Required | integer | Thời lượng chuyến đi hoặc số đêm đi thuyề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 đến cùng một cảng đều có cùng một 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ó điểm dừng tại San Francisco, thì mã hành trình sẽ giống nhau. Giá trị này đượ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 giá trị này theo ký hiệu
WGS84. Thông tin này hữu ích cho việc xác định chính xác thực thể cảng ghé thăm. Ví dụ: toạ độ vĩ độ của 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 phải chỉ định giá trị này theo ký hiệu
WGS84. Thông tin này hữu ích cho việc xác định chính xác thực thể cảng ghé thăm. Ví dụ: toạ độ kinh độ của Trieste, Ý là 13.76188003458354. Các tính năng sau đây không được hỗ trợ:
|
| image_url | Optional | URL | URL của hình ảnh đại diện cho cảng ghé thăm. 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 cũ. Ngày phát hành 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 hai chuyến đi, trong đó một chuyến đi là một chiều và chuyến còn lại là khứ hồi.
Các ví dụ cho thấy cả định dạng CSV và JSON. Các trường sail_id, stop_index được nối với nhau để 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)
Chuyến đi hoặc hành trình đầu tiên là 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
Chuyến bay khứ hồi (Bắt buộc)
Chuyến đi thứ hai là một chuyến đi khứ hồi từ San Francisco đến 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 hành trình 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 (dùng để tham khảo)
Chuyến đi một chiều (Bắt buộc)
Chuyến đi hoặc hành trình đầu tiên là 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"
}
]
Chuyến bay khứ hồi (Bắt buộc)
Chuyến đi thứ hai là một chuyến đi khứ hồi từ San Francisco đến 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 hành trình 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"
}
]