Лента маршрута содержит информацию о круизных рейсах. Каждый маршрут имеет набор поездок. Каждая поездка содержит подробную информацию о поездке, такую как порты, время и даты прибытия и отправления, продолжительность плавания на каждом этапе путешествия и описание каждой поездки. Вы можете загрузить фиды маршрутов в формате 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"
}
]