Seyahat planı feed'i, gemi seyahati bilgileri içerir. Her seyahat planında bir dizi gezi bulunur. Her gezide, limanlar, varış ve kalkış saatleri ile tarihleri, yolculuğun her aşamasının seyir süresi ve her geziyle ilgili açıklama gibi gezi ayrıntıları yer alır. Seyahat planı feed'lerini CSV biçiminde yükleyebilirsiniz.
Temel bileşenler
Seyahat planı feed'inde büyük/küçük harfe duyarsız zorunlu alanlar bulunur. Bazı alanlar isteğe bağlıdır ve boş bırakılabilir. İsteğe bağlı verilerin gönderilmesi veri kalitesini artırır.
Aşağıdaki zorunlu alanları içerir:
sail_id: Belirli bir gezi için benzersiz yelkenli tanımlayıcısı.stop_index: Her kalkış bağlantı noktası için benzersiz durak tanımlayıcısı.port_of_call: Ziyaret edilen liman veya geminin durduğu yer.itinerary_desc: Seyahat planının açıklaması.arrival_dt: Limana varış tarihi ve saati (limanın Eşgüdümlü Evrensel Saati (UTC) ile).departure_dt: Limanın Eşgüdümlü Evrensel Saati (UTC) ile kalkış tarihi ve saati.ship_name: Geminin adı.sail_duration: Yelkenliyle seyahat süresi veya gün sayısı.
Alanlar
Aşağıdaki tabloda, seyahat planı feed'indeki tüm alanlar açıklanmaktadır:
| Alan adı | Zorunlu mu? | Tür | Açıklama |
|---|---|---|---|
| sail_id | Required | string | Seyahat planındaki belirli bir gezi için başlangıç ve bitiş tarihi içeren benzersiz yelkenli tanımlayıcısı.
Örneğin, 3 duraklı 5 gecelik bir seyahat planında Not: |
| stop_index | Required | integer | Cruise güzergahındaki her durak için benzersiz dizin tanımlayıcısı. İlk durak için sıfır diziniyle başlar. Sıfır, ilk kalkış limanını
temsil eder. Örneğin, stop_index, 0 olarak gösterilir.
Not: |
| port_of_call | Required | string | Şehir adı ve geminin durduğu ülkeyi içeren konum.
Örneğin, port_of_call, Venice,Italy olarak gösterilebilir.
Alıntılar ( |
| itinerary_desc | Required | string | Seyahat planının açıklaması. "X-night" ile başlar. Burada X, seyahat planındaki gece sayısıdır. Büyük/küçük harfe duyarlı değildir.
Örneğin, itinerary_desc, 7-night greek isles & eastern med olabilir. |
| arrival_dt | Required | datetime | Limanın Eşgüdümlü Evrensel Saati(UTC) ile varış tarihi ve saati.
İlk bağlantı noktası için arrival_dt boş olmalı ve stop_index sıfır olmalıdır.
Örneğin, arrival_dt, 2025-01-22T06:00:00+01:00 olarak gösterilir. |
| departure_dt | Required | datetime | Limanın Eşgüdümlü Evrensel Saati(UTC) ile kalkış tarihi ve saati.
Son bağlantı noktası için departure_dt boş olmalıdır. stop_index, seyahat planının son gecesi olmalıdır.
Örneğin, departure_dt, 2025-01-23T18:00:00+01:00 olarak gösterilir. |
| ship_name | Required | string | Geminin adı. Büyük/küçük harfe duyarlı değildir.
Örneğin, ship_name, NORWEGIAN Escape olarak gösterilebilir. |
| sail_duration | Required | integer | Yolculuğun süresi veya yelkenliyle geçirilen gece sayısı.
Örneğin, 5 gecelik bir yelkenli gezisi için sail_duration, 5 olarak gösterilir. |
| itinerary_id | Required | string | Seyahat planını tanımlar. itinerary_id, seyahat planlarını birbirinden ayırır. Aynı uğrak limanlarını ziyaret eden tüm geziler aynı itinerary_id'ı paylaşır. Bu sayede geziler gruplandırılabilir ve düzenlenebilir.
Örneğin, iki farklı seyahat planı için uğrak noktası San Francisco ise seyahat planı kimliği her iki seyahat planı için de aynıdır. |
| latitude | Optional | decimal | Bu uğrak noktasının enlemi.
WGS84 gösterimiyle belirtilmelidir. Bu bilgiler, ziyaret edilen liman kuruluşunun tam olarak yerini belirlemek için faydalıdır. Örneğin, İtalya'nın Trieste şehrinin enlem koordinatları 45.64665541364354'dır. Aşağıdakiler desteklenmez:
|
| longitude | Optional | decimal | Bu uğrak noktasının boylamı.
WGS84 gösterimiyle belirtilmelidir. Bu bilgiler, ziyaret edilen liman kuruluşunun tam olarak yerini belirlemek için faydalıdır. Örneğin, İtalya'nın Trieste şehrinin boylam koordinatları 13.76188003458354'dır. Aşağıdakiler desteklenmez:
|
| image_url | Optional | URL | Ziyaret edilen limanı temsil eden bir resmin URL'si. Örneğin,
https://partner.com/images/XXXXX.jpg |
| updated_at | Optional | datetime | Bu girişin Eşgüdümlü Evrensel Saat(UTC) ile son güncellendiği tarih ve saat. Bu bilgiler, eski verileri belirlemek için yararlıdır.
ISO 8601 biçiminde olmalıdır. Örneğin, updated_at değeri 2025-01-22T00:00:00+00:00'dir. |
Örnekler
Aşağıda, birinin tek yönlü, diğerinin ise gidiş-dönüş olduğu iki yelkenli gezi için seyahat planı feed'inin temel bir örneği verilmiştir.
Örneklerde hem CSV hem de JSON biçimleri gösterilmektedir. sail_id, stop_index alanları birleştirilerek bileşik birincil anahtar oluşturulur ve her satır için benzersiz olmalıdır.
CSV
Tek yönlü gezi (zorunlu)
İlk yolculuk veya seyahat planı, San Francisco'dan Kanada'ya 4 gecelik tek yönlü bir yolculuktur. Aşağıdaki örnekte yalnızca zorunlu alanlar gösterilmektedir:
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
Tek yön seyahat (Tümü)
Aşağıdaki örnekte, tek yönlü bir seyahat için kullanılabilen tüm alanlar gösterilmektedir:
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
Gidiş dönüş (zorunlu)
İkinci sefer, San Francisco'dan başlayıp Alaska ve Kanada'yı kapsayan 14 gecelik bir gidiş-dönüş yolculuğudur. Aşağıdaki örnekte yalnızca zorunlu alanlar gösterilmektedir:
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
Gidiş dönüş (Tümü)
Aşağıdaki örnekte, gidiş-dönüş için kullanılabilen tüm alanlar gösterilmektedir:
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 (bilgi amaçlı)
Tek yönlü gezi (zorunlu)
İlk yolculuk veya seyahat planı, San Francisco'dan Kanada'ya 4 gecelik tek yönlü bir yolculuktur. Aşağıdaki örnekte yalnızca zorunlu alanlar gösterilmektedir:
[
{
"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"
}
]
Tek yön seyahat (Tümü)
Aşağıdaki örnekte, tek yönlü seyahat için kullanılabilen tüm alanlar gösterilmektedir:
[
{
"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"
}
]
Gidiş dönüş (zorunlu)
İkinci sefer, San Francisco'dan başlayıp Alaska ve Kanada'yı kapsayan 14 gecelik bir gidiş-dönüş yolculuğudur. Aşağıdaki örnekte yalnızca zorunlu alanlar gösterilmektedir:
[
{
"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"
}
]
Gidiş dönüş (Tümü)
Aşağıdaki örnekte, gidiş-dönüş için kullanılabilen tüm alanlar gösterilmektedir:
[
{
"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"
}
]