Il feed itinerario contiene informazioni sulle partenze delle crociere. Ogni itinerario ha un insieme di viaggi. Ogni viaggio contiene i dettagli del viaggio, come porti, date e ore di arrivo e partenza, durata della navigazione di ogni fase del viaggio e descrizione di ogni viaggio. Puoi caricare i feed di itinerari in formato CSV.
Componenti chiave
Il feed itinerario 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.
Contiene i seguenti campi obbligatori:
sail_id: un identificatore univoco della navigazione per una gita specifica.stop_index: un identificatore di fermata univoco per ogni porta di partenza.port_of_call: la porta di scalo o la località in cui si ferma la crociera.itinerary_desc: descrizione dell'itinerario.arrival_dt: data e ora di arrivo nel fuso orario UTC(Coordinated Universal Time) della porta.departure_dt: data e ora di partenza nel fuso orario UTC (Coordinated Universal Time) della porta.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 di itinerari:
| Nome campo | Obbligatorio? | Tipo | Descrizione |
|---|---|---|---|
| sail_id | Required | string | Identificatore univoco della navigazione per una determinata corsa nell'itinerario con
data di inizio e di fine.
Ad esempio, per un itinerario di 5 notti con 3 fermate, il valore Nota: |
| stop_index | Required | integer | Identificatore di indice univoco per ogni fermata nell'itinerario della crociera. Inizia con l'indice zero per la prima fermata. Lo zero rappresenta la prima
porta di partenza. Ad esempio, stop_index viene rappresentato come 0.
Nota: |
| port_of_call | Required | string | Posizione con il nome della città e del 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 nell'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(tempo universale coordinato) della porta.
arrival_dt per la prima porta deve essere vuoto e stop_index deve essere pari a zero.
Ad esempio, arrival_dt viene 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) della porta.
Il campo departure_dt per l'ultima porta deve essere vuoto. stop_index deve essere l'ultima notte dell'itinerario.
Ad esempio, departure_dt viene 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 della navigazione o il numero di notti di navigazione.
Ad esempio, per 5 notti di navigazione, 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 le stesse città di scalo condividono lo stesso itinerary_id, il che consente di raggruppare e organizzare i viaggi.
Ad esempio, se la porta di scalo è San Francisco per due
itinerari diversi, l'ID itinerario è lo stesso per entrambi. È rappresentato come |
| latitude | Optional | decimal | La latitudine di questa porta di scalo. Deve essere specificato in
notazione
WGS84. Queste informazioni sono utili per localizzare con precisione
l'entità del porto di scalo. Ad esempio, le coordinate di latitudine
per Trieste, in Italia, sono 45.64665541364354. I seguenti elementi non sono supportati:
|
| longitude | Optional | decimal | La longitudine di questo porto di scalo. Deve essere specificato nella
notazione
WGS84. Queste informazioni sono utili per localizzare con precisione
l'entità del porto di scalo. Ad esempio, le coordinate di longitudine
per Trieste, in Italia, sono 13.76188003458354. I seguenti elementi non sono supportati:
|
| image_url | Optional | URL | L'URL di un'immagine che rappresenta la porta di scalo. Ad esempio:
https://partner.com/images/XXXXX.jpg |
| updated_at | Optional | datetime | La data e l'ora dell'ultimo aggiornamento di questa voce nel
tempo universale coordinato(UTC). Queste informazioni sono utili per identificare i dati obsoleti. Deve essere nel 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 di itinerario per due tratte, di cui una sola andata e l'altra andata e ritorno.
Gli esempi mostrano entrambi i formati CSV e JSON. I campi sail_id, stop_index
vengono concatenati per formare la chiave primaria composta e devono essere univoci per
ogni riga.
CSV
Viaggio di sola andata (obbligatorio)
La prima navigazione 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 il viaggio di andata e 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 navigazione 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 la corsa singola:
[
{
"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 il viaggio di andata e 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"
}
]