El feed de itinerarios contiene información sobre la navegación de los cruceros. Cada itinerario tiene un conjunto de viajes. Cada viaje contiene detalles como los puertos, las fechas y los horarios de llegada y salida, la duración de la navegación de cada fase del viaje y la descripción de cada viaje. Puedes subir feeds de itinerarios en formato CSV.
Componentes clave
El feed de itinerarios tiene campos obligatorios que no distinguen mayúsculas de minúsculas. Algunos campos son opcionales y se pueden dejar en blanco. Enviar datos opcionales mejora la calidad de los datos.
Tiene los siguientes campos obligatorios:
sail_id: Es un identificador de navegación único para un viaje específico.stop_index: Es un identificador de parada único para cada puerto de salida.port_of_call: Es el puerto de escala o la ubicación en la que se detiene el crucero.itinerary_desc: Es la descripción del itinerario.arrival_dt: Es la fecha y hora de llegada en el horario universal coordinado(UTC) del puerto.departure_dt: Fecha y hora de salida en el horario universal coordinado (UTC) del puertoship_name: Es el nombre del barco.sail_duration: Es la duración o la cantidad de días de navegación.
Campos
En la siguiente tabla, se describen todos los campos disponibles en el feed de itinerarios:
| Nombre del campo | ¿Obligatorio? | Tipo | Descripción |
|---|---|---|---|
| sail_id | Required | string | Es el identificador único de la navegación para un viaje en particular del itinerario con fecha de inicio y de finalización.
Por ejemplo, para un itinerario de 5 noches con 3 paradas, el Nota: |
| stop_index | Required | integer | Es el identificador de índice único para cada parada del itinerario del crucero. Comienza con el índice cero para la primera parada. Cero representa el primer puerto de partida. Por ejemplo, stop_index se representa como 0.
Nota: |
| port_of_call | Required | string | Ubicación con el nombre de la ciudad y el país donde se detiene el crucero.
Por ejemplo, el port_of_call se puede representar como Venice,Italy.
No se requieren comillas ( |
| itinerary_desc | Required | string | Descripción del itinerario Comienza con “X noches”, donde X es la cantidad de noches del itinerario. No distingue mayúsculas de minúsculas.
Por ejemplo, itinerary_desc puede ser 7-night greek isles & eastern med. |
| arrival_dt | Required | datetime | Fecha y hora de llegada en la hora universal coordinada(UTC) del puerto
El arrival_dt del primer puerto debe estar vacío y el stop_index debe ser cero.
Por ejemplo, arrival_dt se representa como 2025-01-22T06:00:00+01:00. |
| departure_dt | Required | datetime | Fecha y hora de salida en la hora universal coordinada(UTC) del puerto
El departure_dt del último puerto debe estar vacío. El stop_index debe ser la última noche del itinerario.
Por ejemplo, departure_dt se representa como 2025-01-23T18:00:00+01:00. |
| ship_name | Required | string | Es el nombre del barco. No distingue mayúsculas de minúsculas.
Por ejemplo, el ship_name se puede representar como NORWEGIAN Escape. |
| sail_duration | Required | integer | La duración del viaje o la cantidad de noches de navegación.
Por ejemplo, para 5 noches de navegación, el sail_duration se representa como 5. |
| itinerary_id | Required | string | Identifica el itinerario. El itinerary_id distingue los itinerarios entre sí. Todos los viajes que visitan los mismos puertos de escala comparten el mismo itinerary_id, lo que permite agrupar y organizar los viajes.
Por ejemplo, si el puerto de escala es San Francisco para dos itinerarios diferentes, el ID del itinerario es el mismo para ambos itinerarios. Se representa como |
| latitude | Optional | decimal | Es la latitud de este puerto de escala. Debe especificarse en la notación
WGS84. Esta información es útil para ubicar con precisión la entidad del puerto de escala. Por ejemplo, las coordenadas de latitud de Trieste, Italia, son 45.64665541364354. No se admite lo siguiente:
|
| longitude | Optional | decimal | Es la longitud de este puerto de escala. Se debe especificar en la notación
WGS84. Esta información es útil para ubicar con precisión la entidad del puerto de escala. Por ejemplo, las coordenadas de longitud de Trieste, Italia, son 13.76188003458354. No se admite lo siguiente:
|
| image_url | Optional | URL | Es la URL de una imagen que representa el puerto de escala. Por ejemplo: https://partner.com/images/XXXXX.jpg. |
| updated_at | Optional | datetime | Es la fecha y hora de la última actualización de esta entrada en la hora universal coordinada(UTC). Esta información es útil para identificar datos inactivos. Debe seguir el formato
ISO 8601. Por ejemplo, updated_at es 2025-01-22T00:00:00+00:00. |
Ejemplos
El siguiente es un ejemplo básico de un feed de itinerario para dos viajes, en el que uno es de ida y el otro es de ida y vuelta.
En los ejemplos, se muestran los formatos CSV y JSON. Los campos sail_id y stop_index se concatenan para formar la clave primaria compuesta y deben ser únicos para cada fila.
CSV
Viaje de ida solo (obligatorio)
La primera navegación o itinerario es de ida desde San Francisco a Canadá por 4 noches. En el siguiente ejemplo, solo se ilustran los campos obligatorios:
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
Viaje de ida (todos)
En el siguiente ejemplo, se muestran todos los campos disponibles para un viaje de ida:
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
Ida y vuelta (obligatorio)
La segunda navegación es un viaje de ida y vuelta desde San Francisco que abarca Alaska y Canadá durante 14 noches. En el siguiente ejemplo, solo se ilustran los campos obligatorios:
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
Ida y vuelta (todos)
En el siguiente ejemplo, se muestran todos los campos disponibles para el recorrido de ida y vuelta:
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 (solo con fines informativos)
Viaje de ida solo (obligatorio)
La primera navegación o itinerario es de ida desde San Francisco a Canadá por 4 noches. En el siguiente ejemplo, solo se ilustran los campos obligatorios:
[
{
"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"
}
]
Viaje de ida (todos)
En el siguiente ejemplo, se ilustran todos los campos disponibles para un viaje de ida:
[
{
"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"
}
]
Ida y vuelta (obligatorio)
La segunda navegación es un viaje de ida y vuelta desde San Francisco que abarca Alaska y Canadá durante 14 noches. En el siguiente ejemplo, solo se ilustran los campos obligatorios:
[
{
"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"
}
]
Ida y vuelta (todos)
En el siguiente ejemplo, se muestran todos los campos disponibles para el recorrido de ida y vuelta:
[
{
"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"
}
]