Feed itinerari berisi informasi pelayaran kapal pesiar. Setiap rencana perjalanan memiliki serangkaian perjalanan. Setiap perjalanan berisi detail perjalanan seperti pelabuhan, waktu dan tanggal kedatangan dan keberangkatan, durasi berlayar setiap fase perjalanan, dan deskripsi setiap perjalanan. Anda dapat mengupload feed itinerari dalam format CSV.
Komponen utama
Feed rencana perjalanan memiliki kolom wajib diisi yang tidak peka huruf besar/kecil. Beberapa kolom bersifat opsional dan dapat dibiarkan kosong. Mengirim data opsional akan meningkatkan kualitas data.
Memiliki kolom wajib diisi berikut:
sail_id: ID pelayaran unik untuk perjalanan tertentu.stop_index: ID perhentian unik untuk setiap pelabuhan keberangkatan.port_of_call: Pelabuhan persinggahan atau lokasi tempat kapal pesiar berhenti.itinerary_desc: Deskripsi itinerari.arrival_dt: Tanggal dan waktu kedatangan di 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 rencana perjalanan 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 rencana perjalanan kapal pesiar. Dimulai dengan indeks nol untuk perhentian pertama. Nol mewakili pelabuhan keberangkatan
pertama. Misalnya, stop_index ditampilkan
sebagai 0.
Catatan: |
| port_of_call | Required | string | Lokasi dengan nama kota dan negara tempat kapal pesiar berhenti.
Misalnya, port_of_call dapat ditampilkan sebagai
Venice,Italy.
Kutipan ( |
| itinerary_desc | Required | string | Deskripsi rencana perjalanan. 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 di Coordinated Universal Time(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 di Coordinated Universal Time(UTC) pelabuhan.
departure_dt untuk port terakhir harus kosong.
stop_index harus menjadi malam terakhir dalam rencana perjalanan.
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 ditampilkan sebagai
NORWEGIAN Escape. |
| sail_duration | Required | integer | Durasi perjalanan atau jumlah malam berlayar.
Misalnya, untuk 5 malam berlayar, sail_duration ditampilkan sebagai 5. |
| itinerary_id | Required | string | Mengidentifikasi itinerari. itinerary_id membedakan
itinerari satu sama lain. Semua perjalanan yang mengunjungi pelabuhan persinggahan yang sama
memiliki itinerary_id yang sama, sehingga memungkinkan pengelompokan dan
pengaturan perjalanan.
Misalnya, jika pelabuhan persinggahan adalah melalui San Francisco untuk dua
rencana perjalanan yang berbeda, ID rencana perjalanan akan sama untuk kedua
rencana perjalanan tersebut. Direpresentasikan sebagai |
| latitude | Optional | decimal | Lintang pelabuhan ini. Harus ditentukan dalam
notasi
WGS84. Informasi ini berguna untuk menemukan lokasi entitas pelabuhan persinggahan dengan tepat. Misalnya, koordinat lintang
untuk Trieste, Italia adalah 45.64665541364354. Berikut ini tidak
didukung:
|
| longitude | Optional | decimal | Bujur pelabuhan ini. Nilai ini harus ditentukan dalam notasi
WGS84. Informasi ini berguna untuk menemukan lokasi entitas pelabuhan persinggahan dengan tepat. Misalnya, koordinat bujur
untuk Trieste, Italia adalah 13.76188003458354. Berikut ini tidak
didukung:
|
| image_url | Optional | URL | URL gambar yang mewakili pelabuhan persinggahan. Misalnya,
https://partner.com/images/XXXXX.jpg |
| updated_at | Optional | datetime | Tanggal dan waktu saat entri ini terakhir diperbarui dalam
Coordinated Universal Time(UTC). Informasi ini berguna untuk
mengidentifikasi data yang tidak valid. Formatnya harus mengikuti
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 sekali jalan dan yang lainnya adalah perjalanan pulang pergi.
Contoh 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)
Perjalanan laut atau rencana perjalanan 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 sekali jalan:
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 rencana perjalanan 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 sekali jalan:
[
{
"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"
}
]