В ленте маршрутов содержится информация о круизах. Каждый маршрут включает в себя набор рейсов. Каждый рейс содержит подробную информацию о путешествии, такую как порты, время и даты прибытия и отправления, продолжительность каждого этапа путешествия и описание каждого рейса. Вы можете загружать ленты маршрутов в формате CSV.
Ключевые компоненты
В ленте маршрута есть обязательные поля, которые нечувствительны к регистру. Некоторые поля являются необязательными и могут быть оставлены пустыми. Отправка необязательных данных повышает качество данных.
В нем содержатся следующие обязательные поля:
-
sail_id: Уникальный идентификатор рейса. stop_index: Уникальный идентификатор остановки для каждого порта отправления.port_of_call: Порт захода или место, где останавливается круизный лайнер.itinerary_desc: Описание маршрута.arrival_dt: Дата и время прибытия в скоординированном всемирном времени (UTC) порта.departure_dt: Дата и время отправления в скоординированном всемирном времени (UTC) порта.ship_name: Название корабля.sail_duration: Продолжительность или количество дней плавания.
Поля
В следующей таблице описаны все доступные поля в ленте маршрута:
| Название поля | Необходимый? | Тип | Описание |
|---|---|---|---|
| sail_id | Required | string | Уникальный идентификатор рейса для конкретного путешествия в маршруте с указанием дат начала и окончания. Например, для маршрута на 5 ночей с 3 остановками, Примечание: |
| stop_index | Required | integer | Для каждой остановки в маршруте круиза используется уникальный индекс. Он начинается с индекса ноль для первой остановки. Ноль обозначает первый порт отправления. Например, stop_index обозначается как 0 . Примечание: |
| port_of_call | Required | string | Укажите местоположение, название города и страну, где совершается остановка круизного судна. Например, port_of_call можно обозначить как Venice,Italy . Кавычки ( |
| itinerary_desc | Required | string | Описание маршрута. Оно начинается с "X-ночей", где X — количество ночей в маршруте. Регистр не имеет значения. Например, itinerary_desc может выглядеть так: 7-night greek isles & eastern med . |
| arrival_dt | Required | datetime | Дата и время прибытия указаны в скоординированном универсальном времени (UTC) порта. Поле arrival_dt для первого порта должно быть пустым, а stop_index — равным нулю. Например, arrival_dt представляется как 2025-01-22T06:00:00+01:00 . |
| departure_dt | Required | datetime | Дата и время отправления в скоординированном универсальном времени (UTC) порта. Поле departure_dt для последнего порта должно быть пустым. stop_index должно указывать на последнюю ночь маршрута. Например, departure_dt представляется как 2025-01-23T18:00:00+01:00 . |
| ship_name | Required | string | Название корабля. Регистр не имеет значения. Например, ship_name можно представить как NORWEGIAN Escape . |
| sail_duration | Required | integer | Продолжительность плавания или количество ночей в пути. Например, для 5 ночей в пути sail_duration обозначается как 5 . |
| itinerary_id | Required | string | Определяет маршрут. itinerary_id позволяет различать маршруты. Все поездки, посещающие одни и те же порты, имеют один и тот же itinerary_id , что позволяет группировать и организовывать поездки. Например, если портом захода является Сан-Франциско для двух разных маршрутов, то идентификатор маршрута одинаков для обоих. Он обозначается как |
| latitude | Optional | decimal | Широта этого порта захода. Она должна быть указана в системе координат WGS84 . Эта информация полезна для точного определения местоположения объекта порта захода. Например, координаты широты Триеста, Италия, составляют 45.64665541364354 . Следующие значения не поддерживаются:
|
| longitude | Optional | decimal | Долгота этого порта захода. Она должна быть указана в системе координат WGS84 . Эта информация полезна для точного определения местоположения объекта порта захода. Например, координаты долготы Триеста, Италия, составляют 13.76188003458354 . Следующие значения не поддерживаются:
|
| image_url | Optional | URL | URL изображения, представляющего порт захода. Например, https://partner.com/images/XXXXX.jpg |
| updated_at | Optional | datetime | Дата и время последнего обновления данной записи в скоординированном всемирном времени (UTC). Эта информация полезна для выявления устаревших данных. Она должна соответствовать формату ISO 8601. Например, updated_at — это 2025-01-22T00:00:00+00:00 . |
Примеры
Ниже приведён базовый пример ввода маршрута для двух круизов, где один круиз — в одну сторону, а другой — туда и обратно.
В примерах показаны форматы CSV и JSON . Поля sail_id и stop_index объединяются для формирования составного первичного ключа и должны быть уникальными для каждой строки.
CSV
Поездка в один конец (обязательно)
Первый рейс или маршрут — это путешествие в один конец из Сан-Франциско в Канаду на 4 ночи. В следующем примере показаны только обязательные поля:
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
Поездка в один конец (все варианты)
Следующий пример иллюстрирует все доступные поля для поездки в один конец:
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
Поездка туда и обратно (обязательно)
Второй вариант — круговое путешествие из Сан-Франциско, включающее Аляску и Канаду, продолжительностью 14 ночей. В следующем примере показаны только обязательные поля:
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
Поездка туда и обратно (все варианты)
Следующий пример иллюстрирует все доступные поля для расчета времени поездки туда и обратно:
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 (в информационных целях)
Поездка в один конец (обязательно)
Первый рейс или маршрут — это путешествие в один конец из Сан-Франциско в Канаду на 4 ночи. В следующем примере показаны только обязательные поля:
[
{
"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"
}
]
Поездка в один конец (все варианты)
Следующий пример иллюстрирует все доступные поля для поездки в один конец:
[
{
"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"
}
]
Поездка туда и обратно (обязательно)
Второй вариант — круговое путешествие из Сан-Франциско, включающее Аляску и Канаду, продолжительностью 14 ночей. В следующем примере показаны только обязательные поля:
[
{
"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"
}
]
Поездка туда и обратно (все варианты)
Следующий пример иллюстрирует все доступные поля для расчета времени поездки туда и обратно:
[
{
"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"
}
]