Il feed itinerario contiene informazioni sulle crociere. Ogni itinerario ha un insieme di viaggi. Ogni viaggio contiene dettagli come porti, orari e date di arrivo e partenza, durata della navigazione di ogni fase del viaggio e descrizione di ogni viaggio. Puoi caricare i feed degli itinerari in formato CSV.
Componenti chiave
Il feed itinerari contiene campi obbligatori che non fanno distinzione tra maiuscole e minuscole. Alcuni campi sono facoltativi e possono essere lasciati vuoti. L'invio di dati facoltativi migliora la qualità dei dati.
Ha i seguenti campi obbligatori:
sail_id: un identificatore univoco della navigazione per un viaggio specifico.stop_index: un identificatore univoco della fermata per ogni porto di partenza.port_of_call: il porto di scalo o la località in cui si ferma la crociera.itinerary_desc: descrizione dell'itinerario.arrival_dt: data e ora di arrivo nel Tempo Coordinato Universale(UTC) del porto.departure_dt: data e ora di partenza nel fuso orario UTC (Coordinated Universal Time) del porto.ship_name: il nome della nave.sail_duration: la durata o il numero di giorni di navigazione.
Campi
La tabella seguente descrive tutti i campi disponibili nel feed itinerario:
| Nome campo | Obbligatorio? | Tipo | Descrizione |
|---|---|---|---|
| sail_id | Required | string | Identificatore univoco della navigazione per un determinato viaggio nell'itinerario con
data di inizio e di fine.
Ad esempio, per un itinerario di 5 notti con 3 tappe, il
Nota: |
| stop_index | Required | integer | Identificatore univoco dell'indice per ogni fermata dell'itinerario della crociera. Inizia
con l'indice zero per la prima fermata. Zero rappresenta il primo
porto di partenza. Ad esempio, stop_index è
rappresentato come 0.
Nota: |
| port_of_call | Required | string | Località con il nome della città e il paese in cui si ferma la crociera.
Ad esempio, port_of_call può essere rappresentato come
Venice,Italy.
Le virgolette ( |
| itinerary_desc | Required | string | Descrizione dell'itinerario. Inizia con "X-night", dove X è il
numero di notti dell'itinerario. Non è sensibile alle maiuscole.
Ad esempio, itinerary_desc può essere
7-night greek isles & eastern med. |
| arrival_dt | Required | datetime | Data e ora di arrivo nel fuso orario UTC(Coordinated Universal Time) del porto.
Il arrival_dt per la prima porta deve essere vuoto e il
stop_index deve essere zero.
Ad esempio, arrival_dt è rappresentato come
2025-01-22T06:00:00+01:00. |
| departure_dt | Required | datetime | Data e ora di partenza nel fuso orario UTC(Coordinated Universal Time) del porto.
Il campo departure_dt per l'ultima porta deve essere vuoto. Il
stop_index deve essere l'ultima notte dell'itinerario.
Ad esempio, departure_dt è rappresentato come
2025-01-23T18:00:00+01:00. |
| ship_name | Required | string | Il nome della nave. Non è sensibile alle maiuscole.
Ad esempio, ship_name può essere rappresentato come
NORWEGIAN Escape. |
| sail_duration | Required | integer | La durata del viaggio o il numero di notti di navigazione.
Ad esempio, per 5 notti in crociera, il sail_duration è
rappresentato come 5. |
| itinerary_id | Required | string | Identifica l'itinerario. Il itinerary_id distingue
gli itinerari tra loro. Tutti i viaggi che visitano gli stessi porti di scalo
condividono lo stesso itinerary_id, consentendo il raggruppamento e
l'organizzazione dei viaggi.
Ad esempio, se lo scalo è a San Francisco per due itinerari diversi, l'ID itinerario è lo stesso per entrambi gli itinerari. È rappresentato come |
| latitude | Optional | decimal | La latitudine di questo porto di scalo. Deve essere specificato nella notazione
WGS84. Queste informazioni sono utili per individuare con precisione
l'entità porto di scalo. Ad esempio, le coordinate di latitudine
per Trieste, Italia, sono 45.64665541364354. Le seguenti funzionalità non sono supportate:
|
| longitude | Optional | decimal | La longitudine di questo porto di scalo. Deve essere specificato nella
notazione
WGS84. Queste informazioni sono utili per individuare con precisione
l'entità porto di scalo. Ad esempio, le coordinate di longitudine
per Trieste, Italia sono 13.76188003458354. Le seguenti funzionalità non sono supportate:
|
| image_url | Optional | URL | L'URL di un'immagine che rappresenta il porto di scalo. Ad esempio,
https://partner.com/images/XXXXX.jpg |
| updated_at | Optional | datetime | La data e l'ora in cui questa voce è stata aggiornata l'ultima volta in
UTC(Coordinated Universal Time). Queste informazioni sono utili per
identificare i dati obsoleti. Deve seguire il formato
ISO 8601. Ad esempio, updated_at è
2025-01-22T00:00:00+00:00. |
Esempi
Di seguito è riportato un esempio di base di un feed itinerario per due crociere, una di sola andata e l'altra di andata e ritorno.
Gli esempi mostrano i formati CSV e JSON. I campi sail_id, stop_index
vengono concatenati per formare la chiave primaria composita e devono essere univoci per
ogni riga.
CSV
Viaggio di sola andata (obbligatorio)
La prima crociera o itinerario è di sola andata da San Francisco al Canada per 4 notti. L'esempio seguente illustra solo i campi obbligatori:
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
Viaggio di sola andata (tutti)
L'esempio seguente illustra tutti i campi disponibili per un viaggio di sola andata:
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
Andata e ritorno (obbligatorio)
La seconda crociera è un viaggio di andata e ritorno da San Francisco che copre l'Alaska e il Canada per 14 notti. L'esempio seguente illustra solo i campi obbligatori:
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
Andata e ritorno (tutti)
L'esempio seguente illustra tutti i campi disponibili per l'andata e il ritorno:
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 (a scopo informativo)
Viaggio di sola andata (obbligatorio)
La prima crociera o itinerario è di sola andata da San Francisco al Canada per 4 notti. L'esempio seguente illustra solo i campi obbligatori:
[
{
"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"
}
]
Viaggio di sola andata (tutti)
L'esempio seguente illustra tutti i campi disponibili per un viaggio di sola andata:
[
{
"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"
}
]
Andata e ritorno (obbligatorio)
La seconda crociera è un viaggio di andata e ritorno da San Francisco che copre l'Alaska e il Canada per 14 notti. L'esempio seguente illustra solo i campi obbligatori:
[
{
"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"
}
]
Andata e ritorno (tutti)
L'esempio seguente illustra tutti i campi disponibili per l'andata e il ritorno:
[
{
"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"
}
]