Feed itinerari berisi informasi pelayaran kapal pesiar. Setiap itinerari memiliki kumpulan perjalanan. Setiap perjalanan berisi detail perjalanan seperti pelabuhan, waktu dan tanggal kedatangan dan keberangkatan, durasi pelayaran setiap fase perjalanan, dan deskripsi setiap perjalanan. Anda dapat mengupload feed itinerari dalam format CSV.
Komponen utama
Feed itinerari memiliki kolom wajib diisi yang tidak peka huruf besar/kecil. Beberapa kolom opsional dan dapat dibiarkan kosong. Mengirim data opsional akan meningkatkan kualitas data.
Kolom ini memiliki kolom wajib berikut:
sail_id: ID pelayaran unik untuk perjalanan tertentu.stop_index: ID perhentian unik untuk setiap port keberangkatan.port_of_call: Pelabuhan tujuan atau lokasi tempat kapal pesiar berhenti.itinerary_desc: Deskripsi itinerari.arrival_dt: Tanggal dan waktu kedatangan dalam Waktu Universal Terkoordinasi(UTC) pelabuhan.departure_dt: Tanggal dan waktu keberangkatan dalam Waktu Universal Terkoordinasi (UTC) pelabuhan.ship_name: Nama kapal.sail_duration: Durasi atau jumlah hari berlayar.
Kolom
Tabel berikut menjelaskan semua kolom yang tersedia di feed itinerari:
| Nama kolom | Wajib? | Jenis | Deskripsi |
|---|---|---|---|
| sail_id | Required | string | ID pelayaran unik untuk perjalanan tertentu dalam itinerari dengan
tanggal mulai dan akhir.
Misalnya, untuk itinerari 5 malam yang memiliki 3 perhentian, Catatan: |
| stop_index | Required | integer | ID indeks unik untuk setiap perhentian dalam itinerari pelayaran. Dimulai dengan indeks nol untuk perhentian pertama. Nol mewakili port keberangkatan
pertama. Misalnya, stop_index
direpresentasikan sebagai 0.
Catatan: |
| port_of_call | Required | string | Lokasi dengan nama kota dan negara tempat kapal pesiar berhenti.
Misalnya, port_of_call dapat direpresentasikan sebagai
Venice,Italy.
Tanda kutip ( |
| itinerary_desc | Required | string | Deskripsi itinerari. Dimulai dengan "X-night" dengan X adalah
jumlah malam dalam itinerari. ID ini tidak peka huruf besar/kecil.
Misalnya, itinerary_desc dapat berupa
7-night greek isles & eastern med. |
| arrival_dt | Required | datetime | Tanggal dan waktu kedatangan dalam Waktu Universal Terkoordinasi(UTC) pelabuhan.
arrival_dt untuk port pertama harus kosong dan
stop_index harus nol.
Misalnya, arrival_dt direpresentasikan sebagai
2025-01-22T06:00:00+01:00. |
| departure_dt | Required | datetime | Tanggal dan waktu keberangkatan dalam Waktu Universal Terkoordinasi(UTC) pelabuhan.
departure_dt untuk port terakhir harus kosong. stop_index
harus berupa malam terakhir itinerari.
Misalnya, departure_dt direpresentasikan sebagai
2025-01-23T18:00:00+01:00. |
| ship_name | Required | string | Nama kapal. ID ini tidak peka huruf besar/kecil.
Misalnya, ship_name dapat direpresentasikan sebagai
NORWEGIAN Escape. |
| sail_duration | Required | integer | Durasi pelayaran atau jumlah malam berlayar.
Misalnya, untuk 5 malam berlayar, sail_duration
direpresentasikan sebagai 5. |
| itinerary_id | Required | string | Mengidentifikasi itinerari. itinerary_id membedakan
itinerari satu sama lain. Semua perjalanan yang mengunjungi pelabuhan yang sama
memiliki itinerary_id yang sama, sehingga memungkinkan pengelompokan dan
pengaturan perjalanan.
Misalnya, jika pelabuhan singgah adalah melalui San Francisco untuk dua
itinerari yang berbeda, ID itinerari akan sama untuk kedua
itinerari tersebut. Status ini direpresentasikan sebagai |
| latitude | Optional | decimal | Lintang pelabuhan panggilan ini. Nilai ini harus ditentukan dalam
notasi
WGS84. Informasi ini berguna untuk menemukan entity port of call dengan tepat. Misalnya, koordinat lintang
untuk Trieste, Italia adalah 45.64665541364354. Hal berikut tidak
didukung:
|
| longitude | Optional | decimal | Bujur pelabuhan panggilan ini. Nilai ini harus ditentukan dalam
notasi
WGS84. Informasi ini berguna untuk menemukan entity port of call dengan tepat. Misalnya, koordinat bujur untuk Trieste, Italia adalah 13.76188003458354. Hal berikut tidak
didukung:
|
| image_url | Optional | URL | URL gambar yang mewakili pelabuhan panggilan. Misalnya,
https://partner.com/images/XXXXX.jpg |
| updated_at | Optional | datetime | Tanggal dan waktu terakhir kali entri ini diperbarui dalam
Waktu Universal Terkoordinasi(UTC). Informasi ini berguna untuk
mengidentifikasi data yang sudah tidak berlaku. Format ini harus mengikuti format
ISO 8601. Misalnya, updated_at adalah
2025-01-22T00:00:00+00:00. |
Contoh
Berikut adalah contoh dasar feed itinerari untuk dua pelayaran, dengan satu pelayaran adalah perjalanan satu arah dan yang lainnya adalah perjalanan pulang-pergi.
Contoh ini menunjukkan format CSV dan JSON. Kolom sail_id, stop_index
digabungkan untuk membentuk kunci utama gabungan dan harus unik untuk
setiap baris.
CSV
Perjalanan sekali jalan (Wajib)
Pelayaran atau itinerari pertama adalah sekali jalan dari San Francisco ke Kanada selama 4 malam. Contoh berikut hanya mengilustrasikan kolom wajib diisi:
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
Perjalanan sekali jalan (Semua)
Contoh berikut mengilustrasikan semua kolom yang tersedia untuk perjalanan satu arah:
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
Pulang pergi (Wajib)
Pelayaran kedua adalah perjalanan pulang-pergi dari San Francisco yang mencakup Alaska dan Kanada selama 14 malam. Contoh berikut hanya mengilustrasikan kolom wajib diisi:
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
Pulang pergi (Semua)
Contoh berikut mengilustrasikan semua kolom yang tersedia untuk perjalanan pulang-pergi:
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 (untuk tujuan informasi)
Perjalanan sekali jalan (Wajib)
Pelayaran atau itinerari pertama adalah sekali jalan dari San Francisco ke Kanada selama 4 malam. Contoh berikut hanya mengilustrasikan kolom wajib diisi:
[
{
"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"
}
]
Perjalanan sekali jalan (Semua)
Contoh berikut mengilustrasikan semua kolom yang tersedia untuk perjalanan satu arah:
[
{
"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"
}
]
Pulang pergi (Wajib)
Pelayaran kedua adalah perjalanan pulang-pergi dari San Francisco yang mencakup Alaska dan Kanada selama 14 malam. Contoh berikut hanya mengilustrasikan kolom wajib diisi:
[
{
"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"
}
]
Pulang pergi (Semua)
Contoh berikut mengilustrasikan semua kolom yang tersedia untuk perjalanan pulang-pergi:
[
{
"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"
}
]