Flux de séjours

Le flux d'itinéraire contient des informations sur les croisières. Chaque itinéraire comprend un ensemble de trajets. Chaque voyage contient des informations sur le voyage, telles que les ports, les dates et heures d'arrivée et de départ, la durée de la navigation de chaque phase du voyage et la description de chaque voyage. 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 contient 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.

  Important :sail_id et stop_index sont concatenatés pour former une clé primaire composite et doivent être uniques.

• port_of_call: port d'escale ou lieu d'escale du croisiériste.

• itinerary_desc: description de l'itinéraire.

• arrival_dt: date et heure d'arrivée au port au format UTC(temps universel coordonné).

• departure_dt: date et heure de départ au format 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 traversée pour un trajet particulier de l'itinéraire, avec date de début et de fin. Par exemple, pour un itinéraire de cinq nuits avec trois arrêts, sail_id est unique et reste le même pour les trois arrêts. Exemple de sail_id : ABC12345 Remarque:sail_id et stop_index sont concatenatés pour former une clé primaire composite et doivent être uniques.
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. Le zéro représente le premier port de départ. Par exemple, stop_index est représenté par 0. Remarque:sail_id et stop_index sont concatenatés pour former une clé primaire composite et doivent être uniques.
port_of_call	Required	string	Emplacement avec le nom de la ville et du pays où le croisiériste s'arrête. Par exemple, port_of_call peut être représenté par Venice,Italy. Les guillemets (") ne sont pas explicitement obligatoires.
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 en temps universel coordonné(UTC) du port. 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 au format UTC(temps universel coordonné) du port. Le departure_dt du dernier port doit être vide. stop_index doit être 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. itinerary_id permet de distinguer les itinéraires les uns des autres. Tous les trajets qui visitent les mêmes ports de escale partagent le même itinerary_id, ce qui permet de regrouper et d'organiser les trajets. Par exemple, si le port d'escale est San Francisco pour deux itinéraires différents, l'ID de l'itinéraire est le même pour les deux. Elle est représentée par XYZ12345.
latitude	Optional	decimal	Latitude de ce port de 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 de Trieste, en Italie, sont 45.64665541364354. Les éléments suivants ne sont pas compatibles : TOKYO GCJ-02
longitude	Optional	decimal	Longitude de ce port de 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 de Trieste, en Italie, sont 13.76188003458354. Les éléments suivants ne sont pas compatibles : TOKYO GCJ-02
image_url	Optional	URL	URL d'une image représentant le port d'escale. Exemple : https://partner.com/images/XXXXX.jpg
updated_at	Optional	datetime	Date et heure de la dernière mise à jour de cette entrée en temps universel coordonné(UTC). Ces informations sont utiles pour identifier les données obsolètes. Elle doit suivre le format ISO 8601. Par exemple, updated_at est 2025-01-22T00:00:00+00:00.

Exemples

Voici un exemple de flux d'itinéraire de base pour deux croisières, l'une à sens unique et l'autre 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.

Point clé :N'utilisez pas le format JSON. Il est fourni à titre informatif uniquement. Tous les flux doivent être au format CSV.

CSV

Aller simple (obligatoire)

Le premier voyage ou 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 (toutes)

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)

Le deuxième voyage est un aller-retour au départ de San Francisco, qui couvre l'Alaska et le Canada sur 14 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
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 (toutes)

L'exemple suivant illustre tous les champs disponibles pour l'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 (à des fins d'information)

Aller simple (obligatoire)

Le premier voyage ou 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"
  }
]

Remarque :Tous les flux doivent être au format CSV. N'utilisez pas le format JSON.

Aller simple (toutes)

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"
  }
]

Remarque :Tous les flux doivent être au format CSV. N'utilisez pas le format JSON.

Aller-retour (obligatoire)

Le deuxième voyage est un aller-retour au départ de San Francisco, qui couvre l'Alaska et le Canada sur 14 nuits. 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"
  }
]

Remarque :Tous les flux doivent être au format CSV. N'utilisez pas le format JSON.

Aller-retour (toutes)

L'exemple suivant illustre tous les champs disponibles pour l'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"
  }
]

Remarque :Tous les flux doivent être au format CSV. N'utilisez pas le format JSON.