Le flux d'itinéraires contient des informations sur les croisières. Chaque itinéraire comporte un ensemble de trajets. Chaque trajet contient des informations telles que les ports, les heures et dates d'arrivée et de départ, la durée de navigation de chaque phase du trajet et la description de chaque trajet. Vous pouvez importer des flux d'itinéraires au format CSV.
Composants clés
Le flux d'itinéraires comporte des champs obligatoires qui ne sont pas sensibles à la casse. Certains champs sont facultatifs et peuvent être laissés vides. L'envoi de données facultatives améliore la qualité des données.
Il comporte les champs obligatoires suivants :
sail_id: identifiant unique de la navigation pour un voyage spécifique.stop_index: identifiant unique de l'arrêt pour chaque port de départ.port_of_call: port d'escale ou lieu où la croisière s'arrête.itinerary_desc: description de l'itinéraire.arrival_dt: date et heure d'arrivée dans le port, en temps universel coordonné(UTC).departure_dt: date et heure de départ dans le fuseau horaire UTC (temps universel coordonné) du port.ship_name: nom du navire.sail_duration: durée ou nombre de jours de navigation.
Champs
Le tableau suivant décrit tous les champs disponibles dans le flux d'itinéraires :
| Nom du champ | Obligatoire ? | Type | Description |
|---|---|---|---|
| sail_id | Required | string | Identifiant unique de la navigation pour un trajet spécifique de l'itinéraire avec une date de début et une date de fin.
Par exemple, pour un itinéraire de cinq nuits avec trois arrêts, Remarque : |
| stop_index | Required | integer | Identifiant d'index unique pour chaque escale de l'itinéraire de la croisière. Il commence par l'index 0 pour le premier arrêt. Zéro représente le premier port de départ. Par exemple, stop_index est représenté par 0.
Remarque : |
| port_of_call | Required | string | Lieu avec le nom de la ville et du pays où la croisière fait escale.
Par exemple, port_of_call peut être représenté par Venice,Italy.
Les guillemets ( |
| itinerary_desc | Required | string | Description de l'itinéraire. Il commence par "X-night", où X correspond au nombre de nuits du séjour. Il n'est pas sensible à la casse.
Par exemple, itinerary_desc peut être 7-night greek isles & eastern med. |
| arrival_dt | Required | datetime | Date et heure d'arrivée au port en temps universel coordonné(UTC).
Le arrival_dt du premier port doit être vide et le stop_index doit être nul.
Par exemple, arrival_dt est représenté par 2025-01-22T06:00:00+01:00. |
| departure_dt | Required | datetime | Date et heure de départ dans le fuseau horaire UTC(temps universel coordonné) du port.
Le departure_dt du dernier port doit être vide. La stop_index doit correspondre à la dernière nuit de l'itinéraire.
Par exemple, departure_dt est représenté par 2025-01-23T18:00:00+01:00. |
| ship_name | Required | string | Nom du navire. Il n'est pas sensible à la casse.
Par exemple, ship_name peut être représenté par NORWEGIAN Escape. |
| sail_duration | Required | integer | Durée du voyage ou nombre de nuits en mer.
Par exemple, pour cinq nuits de navigation, sail_duration est représenté par 5. |
| itinerary_id | Required | string | Identifie l'itinéraire. Le itinerary_id permet de distinguer les itinéraires les uns des autres. Tous les trajets qui desservent les mêmes escales partagent le même itinerary_id, ce qui permet de regrouper et d'organiser les trajets.
Par exemple, si l'escale se fait à San Francisco pour deux itinéraires différents, l'ID d'itinéraire est le même pour les deux itinéraires. Elle est représentée par |
| latitude | Optional | decimal | Latitude de cette escale. Il doit être spécifié dans la notation
WGS84. Ces informations sont utiles pour localiser précisément l'entité du port d'escale. Par exemple, les coordonnées de latitude pour Trieste, en Italie, sont 45.64665541364354. Les éléments suivants ne sont pas acceptés :
|
| longitude | Optional | decimal | Longitude de cette escale. Il doit être spécifié dans la notation
WGS84. Ces informations sont utiles pour localiser précisément l'entité du port d'escale. Par exemple, les coordonnées de longitude pour Trieste, en Italie, sont 13.76188003458354. Les éléments suivants ne sont pas acceptés :
|
| image_url | Optional | URL | URL d'une image représentant l'escale. Exemple : https://partner.com/images/XXXXX.jpg |
| updated_at | Optional | datetime | Date et heure auxquelles cette entrée a été mise à jour pour la dernière fois en temps universel coordonné(UTC). Ces informations sont utiles pour identifier les données obsolètes. Elle doit être au format
ISO 8601. Par exemple, updated_at est 2025-01-22T00:00:00+00:00. |
Exemples
Voici un exemple de base de flux de séjours pour deux traversées, dont l'une est un aller simple et l'autre un aller-retour.
Les exemples montrent les formats CSV et JSON. Les champs sail_id et stop_index sont concaténés pour former la clé primaire composite et doivent être uniques pour chaque ligne.
CSV
Aller simple (obligatoire)
La première croisière ou le premier itinéraire est un aller simple de San Francisco au Canada pour quatre nuits. L'exemple suivant n'illustre que les champs obligatoires :
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
Aller simple (tous)
L'exemple suivant illustre tous les champs disponibles pour un aller simple :
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
Aller-retour (obligatoire)
La deuxième croisière est un aller-retour de 14 nuits au départ de San Francisco, qui couvre l'Alaska et le Canada. L'exemple suivant n'illustre que les champs obligatoires :
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
Aller-retour (tous)
L'exemple suivant illustre tous les champs disponibles pour un aller-retour :
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 (à titre informatif)
Aller simple (obligatoire)
La première croisière ou le premier itinéraire est un aller simple de San Francisco au Canada pour quatre nuits. L'exemple suivant n'illustre que les champs obligatoires :
[
{
"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"
}
]
Aller simple (tous)
L'exemple suivant illustre tous les champs disponibles pour un aller simple :
[
{
"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"
}
]
Aller-retour (obligatoire)
La deuxième croisière est un aller-retour de 14 nuits au départ de San Francisco, qui couvre l'Alaska et le Canada. L'exemple suivant n'illustre que les champs obligatoires :
[
{
"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"
}
]
Aller-retour (tous)
L'exemple suivant illustre tous les champs disponibles pour un aller-retour :
[
{
"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"
}
]