Plik danych z trasami zawiera informacje o rejsach. Każdy plan podróży obejmuje zestaw podróży. Każda podróż zawiera szczegóły, takie jak porty, godziny i daty przybycia i wypłynięcia, czas trwania rejsu w każdym etapie podróży oraz opis każdej podróży. Pliki danych z trasami możesz przesyłać w formacie CSV.
Kluczowe komponenty
Plik danych z trasami zawiera pola wymagane, w których wielkość liter nie jest rozróżniana. Niektóre pola są opcjonalne i można je pozostawić puste. Przesyłanie danych opcjonalnych poprawia jakość danych.
Zawiera te pola obowiązkowe:
sail_id: unikalny identyfikator rejsu w przypadku konkretnej podróży.stop_index: unikalny identyfikator przystanku w każdym porcie wypłynięcia.port_of_call: port zawinięcia lub miejsce, w którym zatrzymuje się statek.itinerary_desc: opis planu podróży.arrival_dt: data i godzina przybycia w uniwersalnym czasie koordynowanym portu(UTC).departure_dt: data i godzina wypłynięcia w uniwersalnym czasie koordynowanym (UTC) portu.ship_name: nazwa statku.sail_duration: czas trwania rejsu lub liczba dni rejsu.
Pola
W tabeli poniżej opisujemy wszystkie dostępne pola w pliku danych z trasami:
| Nazwa pola | Wymagany? | Typ | Opis |
|---|---|---|---|
| sail_id | Required | string | Unikalny identyfikator rejsu w przypadku konkretnej podróży w planie podróży z datą rozpoczęcia i zakończenia.
Jeśli na przykład trasa obejmuje 5 nocy i 3 przystanki, pole
Uwaga: |
| stop_index | Required | integer | Unikalny identyfikator indeksu każdego przystanku na trasie rejsu. Zaczyna się od indeksu 0 w przypadku pierwszego przystanku. Zero oznacza pierwszy
port wypłynięcia. Na przykład pole stop_index jest
reprezentowane jako 0.
Uwaga: |
| port_of_call | Required | string | Lokalizacja z nazwą miasta i kraju, w którym zatrzymuje się statek.
Na przykład 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 jest rozróżniana.
Na przykład itinerary_desc może mieć wartość
7-night greek isles & eastern med. |
| arrival_dt | Required | datetime | Data i godzina przybycia w uniwersalnym czasie koordynowanym(UTC) portu.
Pole arrival_dt w przypadku pierwszego portu musi być puste, a pole
stop_index musi mieć wartość 0.
Na przykład pole arrival_dt jest reprezentowane jako
2025-01-22T06:00:00+01:00. |
| departure_dt | Required | datetime | Data i godzina wypłynięcia w uniwersalnym czasie koordynowanym(UTC) portu.
Pole departure_dt w przypadku ostatniego portu musi być puste. Pole
stop_index musi mieć wartość ostatniej nocy na trasie.
Na przykład pole departure_dt jest reprezentowane jako
2025-01-23T18:00:00+01:00. |
| ship_name | Required | string | Nazwa statku. Wielkość liter nie jest rozróżniana.
Na przykład pole ship_name może być reprezentowane jako
NORWEGIAN Escape. |
| sail_duration | Required | integer | Czas trwania rejsu lub liczba nocy rejsu.
Jeśli na przykład rejs trwa 5 nocy, pole sail_duration jest
reprezentowane jako 5. |
| itinerary_id | Required | string | Identyfikuje plan podróży. Pole itinerary_id odróżnia
od siebie trasy. Wszystkie podróże, które obejmują te same porty zawinięcia
mają ten sam itinerary_id, co umożliwia grupowanie i
porządkowanie podróży.
Jeśli na przykład port zawinięcia to San Francisco w przypadku 2 różnych tras, identyfikator trasy jest taki sam w obu przypadkach. Jest on reprezentowany jako |
| latitude | Optional | decimal | Szerokość geograficzna tego portu zawinięcia. Należy ją podać w
WGS84 notacji. Te informacje są przydatne do dokładnego
zlokalizowania portu zawinięcia. Na przykład współrzędne szerokości geograficznej
dla Triestu we Włoszech to 45.64665541364354. Następujące funkcje nie są obsługiwane:
|
| longitude | Optional | decimal | Długość geograficzna tego portu zawinięcia. Należy ją podać w
WGS84 notacji. Te informacje są przydatne do dokładnego
zlokalizowania portu zawinięcia. Na przykład współrzędne długości geograficznej
dla Triestu we Włoszech to 13.76188003458354. Następujące funkcje nie są obsługiwane:
|
| image_url | Optional | URL | Adres URL obrazu przedstawiającego port zawinięcia. 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. Powinny być zgodne z formatem
ISO 8601. Na przykład pole updated_at ma wartość
2025-01-22T00:00:00+00:00. |
Przykłady
Poniżej znajdziesz podstawowy przykład pliku danych z trasami dla 2 rejsów, z których jeden jest podróżą w jedną stronę, a drugi – w obie strony.
Przykłady pokazują formaty CSV i JSON. Pola sail_id i stop_index są łączone w celu utworzenia złożonego klucza podstawowego i muszą być unikalne w każdym wierszu.
CSV
Podróż w jedną stronę (wymagana)
Pierwszy rejs lub plan podróży to podróż w jedną stronę z San Francisco do Kanady na 4 noce. Poniższy przykład ilustruje tylko pola obowiązkowe:
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 ilustruje wszystkie dostępne pola w przypadku podróży w jedną stronę:
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
Podróż w obie strony (wymagana)
Drugi rejs to podróż w obie strony z San Francisco, obejmująca Alaskę i Kanadę, na 14 nocy. Poniższy przykład ilustruje tylko pola obowiązkowe:
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
Podróż w obie strony (wszystkie)
Poniższy przykład ilustruje wszystkie dostępne pola w przypadku podróży 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 (w celach informacyjnych)
Podróż w jedną stronę (wymagana)
Pierwszy rejs lub plan podróży to podróż w jedną stronę z San Francisco do Kanady na 4 noce. Poniższy przykład ilustruje tylko pola obowiązkowe:
[
{
"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 ilustruje wszystkie dostępne pola w przypadku podróży 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"
}
]
Podróż w obie strony (wymagana)
Drugi rejs to podróż w obie strony z San Francisco, obejmująca Alaskę i Kanadę, na 14 nocy. Poniższy przykład ilustruje tylko pola obowiązkowe:
[
{
"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"
}
]
Podróż w obie strony (wszystkie)
Poniższy przykład ilustruje wszystkie dostępne pola w przypadku podróży 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"
}
]