Plik danych o planie podróży zawiera informacje o rejsie. Każdy plan podróży zawiera zestaw przejazdów. Każda podróż zawiera szczegóły, takie jak porty, daty i godziny przyjazdu i odjazdu, czas trwania poszczególnych etapów podróży oraz opis każdej podróży. Pliki danych z rozkładami lotów możesz przesyłać w formacie CSV.
Kluczowe komponenty
Plik danych planu podróży zawiera wymagane pola, w których wielkość liter nie ma znaczenia. Niektóre pola są opcjonalne i można je pozostawić puste. Wysyłanie opcjonalnych danych poprawia ich jakość.
Zawiera te wymagane pola:
sail_id: unikalny identyfikator żeglugi dla konkretnego rejsu.stop_index: niepowtarzalny identyfikator przystanku dla każdego portu wylotu.port_of_call: port lub miejsce, w którym statek zatrzymują się podczas rejsu.itinerary_desc: opis planu podróży.arrival_dt: data i godzina przybycia do portu w uniwersalnym czasie koordynowanym(UTC).departure_dt: data i godzina wypłynięcia według uniwersalnego czasu koordynowanego (UTC) w porcie.ship_name: nazwa statku.sail_duration: czas trwania lub liczba dni żeglugi.
Pola
W tabeli poniżej znajdziesz opis wszystkich dostępnych pól w pliku danych o planie podróży:
| Nazwa pola | Wymagany? | Typ | Opis |
|---|---|---|---|
| sail_id | Required | string | Unikalny identyfikator rejsu dla konkretnej podróży w planie podróży z datą rozpoczęcia i zakończenia.
Na przykład w przypadku planu podróży obejmującego 5 nocy i 3 przystanki element Uwaga: wartości |
| stop_index | Required | integer | Unikalny identyfikator indeksu dla każdego przystanku w programie rejsu. Zaczyna się od indeksu 0 w przypadku pierwszego przystanku. Wartość 0 oznacza pierwszy port wylotu. Na przykład stop_index jest reprezentowane jako 0.
Uwaga: |
| port_of_call | Required | string | Miejsce z nazwą miasta i kraju, w którym odbywa się rejs.
Na przykład pole port_of_call może być reprezentowane jako Venice,Italy.
Cudzysłowy ( |
| itinerary_desc | Required | string | Opis planu podróży. Zaczyna się od „X-night”, gdzie X to liczba nocy w planie podróży. Wielkość liter nie ma znaczenia.
Na przykład pole itinerary_desc może być polem 7-night greek isles & eastern med. |
| arrival_dt | Required | datetime | Data i godzina przybycia w porcie według uniwersalnego czasu koordynowanego(UTC).
Wartość arrival_dt dla pierwszego portu musi być pusta, a wartość stop_index musi wynosić 0.
Na przykład arrival_dt jest reprezentowane jako 2025-01-22T06:00:00+01:00. |
| departure_dt | Required | datetime | Data i godzina wypłynięcia według uniwersalnego czasu koordynowanego(UTC) w porcie.
Wartość departure_dt dla ostatniego portu musi być pusta. stop_index musi być ostatnią nocą w ramach planu podróży.
Na przykład departure_dt jest reprezentowane jako 2025-01-23T18:00:00+01:00. |
| ship_name | Required | string | Nazwa statku. Wielkość liter nie ma znaczenia.
Na przykład pole ship_name może być reprezentowane jako NORWEGIAN Escape. |
| sail_duration | Required | integer | czas trwania rejsu lub liczba nocy spędzonych na morzu;
Na przykład w przypadku 5 nocy żeglugi wartość sail_duration jest reprezentowana jako 5. |
| itinerary_id | Required | string | Identyfikuje plan podróży. itinerary_id odróżnia od siebie różne plany podróży. Wszystkie przejazdy, które obejmują te same porty, mają ten sam itinerary_id, co umożliwia ich grupowanie i organizowanie.
Jeśli na przykład w przypadku 2 różnych planów podróży port zawijania jest w San Francisco, identyfikator planu podróży będzie taki sam w obu przypadkach. Jest on oznaczany symbolem |
| latitude | Optional | decimal | Szerokość geograficzna tego portu. Należy go podać w notacji
WGS84. Te informacje są przydatne do dokładnego zlokalizowania podmiotu portu połączenia. Na przykład współrzędne szerokości geograficznej Trieste we Włoszech to 45.64665541364354. Nie są obsługiwane te funkcje:
|
| longitude | Optional | decimal | Długość geograficzna tego portu. Należy go podać w notacji
WGS84. Te informacje są przydatne do dokładnego zlokalizowania podmiotu portu połączenia. Na przykład współrzędne długości geograficzne Triestu we Włoszech to 13.76188003458354. Nie są obsługiwane te funkcje:
|
| image_url | Optional | URL | Adres URL obrazu przedstawiającego port. Na przykład:https://partner.com/images/XXXXX.jpg |
| updated_at | Optional | datetime | Data i godzina ostatniej aktualizacji tego wpisu w uniwersalnym czasie koordynowanym(UTC). Te informacje są przydatne do identyfikowania nieaktualnych danych. Powinien on być w formacie
ISO 8601. Na przykład updated_at to 2025-01-22T00:00:00+00:00. |
Przykłady
Poniżej znajdziesz podstawowy przykład pliku danych z planem podróży dla 2 rejsów, z których jeden jest w jednym kierunku, a drugi w obie strony.
Przykłady pokazują formaty CSV i JSON. Pola sail_id i stop_index są łączone, aby utworzyć złożony klucz podstawowy, i muszą być unikalne w każdym wierszu.
CSV
Podróż w jedną stronę (wymagany)
Pierwsza podróż lub trasa to przejazd w jedną stronę z San Francisco do Kanady na 4 noce. W tym przykładzie uwzględniono tylko pola wymagane:
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
Podróż w jedną stronę (wszystkie)
Poniższy przykład pokazuje wszystkie dostępne pola w przypadku podróży w jednym kierunku:
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
W obie strony (wymagany)
Druga wyprawa to rejs w obie strony z San Francisco, obejmujący Alaskę i Kanadę, trwający 14 nocy. W tym przykładzie uwzględniono tylko pola wymagane:
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
W obie strony (wszystkie)
Ten przykład pokazuje wszystkie dostępne pola dla przejazdu w obie strony:
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 (informacje)
Podróż w jedną stronę (wymagany)
Pierwsza podróż lub trasa to przejazd w jedną stronę z San Francisco do Kanady na 4 noce. W tym przykładzie uwzględniono tylko pola wymagane:
[
{
"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"
}
]
Podróż w jedną stronę (wszystkie)
Poniższy przykład pokazuje wszystkie dostępne pola dla przejazdu w jedną stronę:
[
{
"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"
}
]
W obie strony (wymagany)
Druga wyprawa to rejs w obie strony z San Francisco, obejmujący Alaskę i Kanadę, trwający 14 nocy. W tym przykładzie uwzględniono tylko pola wymagane:
[
{
"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"
}
]
W obie strony (wszystkie)
Poniższy przykład pokazuje wszystkie dostępne pola dla przejazdu w obie strony:
[
{
"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"
}
]