Seyahat planı feed'i, seyahat planı bilgilerini içerir. Her seyahat planında bir dizi gezi bulunur. Her seyahat; liman, varış ve kalkış saatleri ve tarihleri, yolculuğun her aşamasının seyir süresi ve her seyahatin açıklaması gibi seyahatle ilgili ayrıntıları içerir. Seyahat planı feed'lerini CSV biçiminde yükleyebilirsiniz.
Temel bileşenler
Seyahat planı feed'inde büyük/küçük harfe duyarlı olmayan zorunlu alanlar vardır. Bazı alanlar isteğe bağlıdır ve boş bırakılabilir. İsteğe bağlı verileri göndermek veri kalitesini artırır.
Şu zorunlu alanlara sahiptir:
sail_id: Belirli bir gezi için benzersiz bir seyir tanımlayıcısı.stop_index: Her kalkış noktası için benzersiz bir durak tanımlayıcısı.port_of_call: Varış limanı veya kruvaziyerin duracağı yer.itinerary_desc: Seyahat planının açıklaması.arrival_dt: Limanın eşgüdümlü evrensel saatine(UTC) göre varış tarihi ve saati.departure_dt: Limanın eşgüdümlü evrensel saati (UTC) ile kalkış tarihi ve saati.ship_name: Geminin adı.sail_duration: Yelkenli seyrin süresi veya sayısı.
Alanlar
Aşağıdaki tabloda, seyahat planı feed'inde kullanılabilen 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 seyahat tanımlayıcısı.
Örneğin, 3 durak içeren 5 gecelik bir seyahat planı için Not: |
| stop_index | Required | integer | Kruvaziyer seyahat planındaki her durak için benzersiz dizin tanımlayıcısı. İlk durak için sıfır dizinle başlar. Sıfır, ilk kalkış limanını temsil eder. Örneğin, stop_index 0 olarak temsil edilir.
Not: |
| port_of_call | Required | string | Yolcu gemisinin durakladığı şehrin adını ve ülkeyi içeren konum.
Örneğin, port_of_call Venice,Italy olarak temsil edilebilir.
Tırnak işaretleri ( |
| itinerary_desc | Required | string | Seyahat planının açıklaması. "X-night" ile başlar. 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) cinsinden varış tarihi ve saati.
İlk bağlantı noktası için arrival_dt boş, stop_index ise sıfır olmalıdır.
Örneğin, arrival_dt 2025-01-22T06:00:00+01:00 olarak temsil edilir. |
| departure_dt | Required | datetime | Limanın eşgüdümlü evrensel saati(UTC) cinsinden 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 temsil edilir. |
| ship_name | Required | string | Geminin adı. Büyük/küçük harfe duyarlı değildir.
Örneğin, ship_name NORWEGIAN Escape olarak temsil edilebilir. |
| sail_duration | Required | integer | Seyahatin süresi veya seyahat gecesi sayısı.
Örneğin, 5 seyir gecesi için sail_duration, 5 olarak temsil edilir. |
| itinerary_id | Required | string | Seyahat planını tanımlar. itinerary_id, seyahat planlarını birbirinden ayırt eder. Aynı limanlarda demirleyen tüm seyahatler aynı itinerary_id değerini paylaşır. Bu sayede seyahatleri gruplandırabilir ve düzenleyebilirsiniz.
Örneğin, iki farklı seyahat planı için uğranılan liman San Francisco ise seyahat planı kimliği her iki seyahat planı için de aynıdır. |
| latitude | Optional | decimal | Bu liman kentinin enlemi.
WGS84 gösterimiyle belirtilmelidir. Bu bilgiler, bağlantı noktası varlığını tam olarak belirlemek için yararlıdır. Örneğin, İtalya'nın Trieste kentinin enlem koordinatları 45.64665541364354'tür. Aşağıdakiler desteklenmez:
|
| longitude | Optional | decimal | Bu liman sahasının boylamı.
WGS84 gösterimiyle belirtilmelidir. Bu bilgiler, bağlantı noktası varlığını tam olarak belirlemek için yararlıdır. Örneğin, İtalya'nın Trieste kentinin boylam koordinatları 13.76188003458354'tür. Aşağıdakiler desteklenmez:
|
| image_url | Optional | URL | Liman adımını temsil eden resmin URL'si. Örneğin:
https://partner.com/images/XXXXX.jpg |
| updated_at | Optional | datetime | Bu girişin Eşgüdümlü Evrensel Zaman(UTC) diliminde son güncellendiği tarih ve saat. Bu bilgiler, eski verileri belirlemek için yararlıdır.
ISO 8601 biçimine uygun olmalıdır. Örneğin, updated_at değeri
2025-01-22T00:00:00+00:00'tır. |
Örnekler
Aşağıda, biri tek yönlü diğeri gidiş dönüş olmak üzere iki seyahat için seyahat planı feed'i örneği verilmiştir.
Örneklerde hem CSV hem de JSON biçimleri gösterilmektedir. sail_id, stop_index alanları, birleşik birincil anahtarı oluşturmak için birleştirilir ve her satır için benzersiz olmalıdır.
CSV
Tek yön (Zorunlu)
İlk seyahat veya seyahat planı, San Francisco'dan Kanada'ya 4 gecelik tek yöndür. 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 (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 seyahat, San Francisco'dan Alaska ve Kanada'yı kapsayan 14 gecelik bir gidiş dönüş seferidir. 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ıdır)
Tek yön (Zorunlu)
İlk seyahat veya seyahat planı, San Francisco'dan Kanada'ya 4 gecelik tek yöndür. 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 (Tümü)
Aşağıdaki örnekte, tek yön 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 seyahat, San Francisco'dan Alaska ve Kanada'yı kapsayan 14 gecelik bir gidiş dönüş seferidir. 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"
}
]