Der Reiseplan-Feed enthält Informationen zu Kreuzfahrten. Jeder Reiseplan besteht aus einer Reihe von Reisen. Jede Reise enthält Details wie Häfen, Ankunfts- und Abfahrtszeiten und ‑daten, die Dauer der einzelnen Reiseabschnitte und eine Beschreibung der Reise. Sie können Reiseplan-Feeds im CSV-Format hochladen.
Schlüsselkomponenten
Der Reiseplan-Feed enthält Pflichtfelder, bei denen die Groß-/Kleinschreibung nicht berücksichtigt wird. Einige Felder sind optional und können leer gelassen werden. Wenn Sie optionale Daten senden, wird die Datenqualität verbessert.
Er enthält die folgenden Pflichtfelder:
sail_id: Eine eindeutige Kennung für eine bestimmte Reise.stop_index: Eine eindeutige Kennung für jeden Abfahrtshafen.port_of_call: Der Anlaufhafen oder der Ort, an dem die Kreuzfahrt hält.itinerary_desc: Beschreibung des Reiseplans.arrival_dt: Ankunftsdatum und ‑zeit in koordinierter Weltzeit(UTC) des Hafens.departure_dt: Abfahrtsdatum und ‑zeit in koordinierter Weltzeit (UTC) des Hafens.ship_name: Der Name des Schiffs.sail_duration: Die Dauer oder Anzahl der Reisetage.
Felder
In der folgenden Tabelle werden alle verfügbaren Felder im Reiseplan-Feed beschrieben:
| Feldname | Erforderlich? | Typ | Beschreibung |
|---|---|---|---|
| sail_id | Required | string | Eindeutige Kennung für eine bestimmte Reise im Reiseplan mit
Start- und Enddatum.
Bei einem Reiseplan von fünf Nächten mit drei Aufenthalten ist die
Hinweis: |
| stop_index | Required | integer | Eindeutige Index-Kennung für jeden Aufenthalt im Reiseplan. Der Index beginnt mit 0 für den ersten Aufenthalt. 0 steht für den ersten
Abfahrtshafen. Beispiel: stop_index wird
dargestellt als 0.
Hinweis: |
| port_of_call | Required | string | Ort mit dem Namen der Stadt und des Landes, in dem die Kreuzfahrt hält.
Beispiel: port_of_call kann als
Venice,Italy dargestellt werden.
Anführungszeichen ( |
| itinerary_desc | Required | string | Beschreibung des Reiseplans. Sie beginnt mit "X-night", wobei X die
Anzahl der Nächte im Reiseplan ist. Die Groß-/Kleinschreibung wird nicht berücksichtigt.
Beispiel: itinerary_desc kann
7-night greek isles & eastern med sein. |
| arrival_dt | Required | datetime | Ankunftsdatum und ‑zeit in koordinierter Weltzeit(UTC) des Hafens.
Die arrival_dt für den ersten Hafen muss leer sein und die
stop_index muss 0 sein.
Beispiel: arrival_dt wird als
2025-01-22T06:00:00+01:00 dargestellt. |
| departure_dt | Required | datetime | Abfahrtsdatum und ‑zeit in koordinierter Weltzeit(UTC) des Hafens.
Die departure_dt für den letzten Hafen muss leer sein. Die
stop_index muss die letzte Nacht des Reiseplans sein.
Beispiel: departure_dt wird als
2025-01-23T18:00:00+01:00 dargestellt. |
| ship_name | Required | string | Der Name des Schiffs. Die Groß-/Kleinschreibung wird nicht berücksichtigt.
Beispiel: ship_name kann als
NORWEGIAN Escape dargestellt werden. |
| sail_duration | Required | integer | Die Dauer der Reise oder die Anzahl der Reisetage.
Beispiel: Bei fünf Reisetagen wird sail_duration als 5 dargestellt. |
| itinerary_id | Required | string | Kennzeichnet den Reiseplan. Die itinerary_id unterscheidet
die Reisepläne voneinander. Alle Reisen, die dieselben Anlaufhäfen anlaufen
haben dieselbe itinerary_id. So können Reisen gruppiert und
organisiert werden.
Beispiel: Wenn der Anlaufhafen für zwei
verschiedene Reisepläne San Francisco ist, ist die Reiseplan-ID für beide
Reisepläne gleich. Sie wird als |
| latitude | Optional | decimal | Der Breitengrad dieses Anlaufhafens. Er sollte in
WGS84 Notation angegeben werden. Diese Informationen sind nützlich, um die Anlaufhafen-Entität genau
zu lokalisieren. Beispiel: Die Breitengradkoordinaten
für Triest, Italien, sind 45.64665541364354. Folgendes wird
nicht unterstützt:
|
| longitude | Optional | decimal | Der Längengrad dieses Anlaufhafens. Er sollte in der
WGS84 Notation angegeben werden. Diese Informationen sind nützlich, um die Anlaufhafen-Entität genau
zu lokalisieren. Beispiel: Die Längengradkoordinaten
für Triest, Italien, sind 13.76188003458354. Folgendes wird
nicht unterstützt:
|
| image_url | Optional | URL | Die URL eines Bildes, das den Anlaufhafen darstellt. Beispiel:
https://partner.com/images/XXXXX.jpg |
| updated_at | Optional | datetime | Datum und Uhrzeit der letzten Aktualisierung dieses Eintrags in
koordinierter Weltzeit(UTC). Diese Informationen sind nützlich, um
veraltete Daten zu identifizieren. Sie sollten dem
ISO 8601-Format entsprechen. Beispiel: updated_at ist
2025-01-22T00:00:00+00:00. |
Beispiele
Das folgende Beispiel zeigt einen einfachen Reiseplan-Feed für zwei Reisen, wobei eine Reise eine einfache Fahrt und die andere eine Hin- und Rückfahrt ist.
In den Beispielen werden sowohl das CSV- als auch das JSON-Format verwendet. Die Felder sail_id und stop_index werden verkettet, um den zusammengesetzten Primärschlüssel zu bilden. Sie müssen für jede Zeile eindeutig sein.
CSV
Nur Hinflug (erforderlich)
Die erste Reise oder der erste Reiseplan ist eine einfache Fahrt von San Francisco nach Kanada für vier Nächte. Im folgenden Beispiel werden nur die Pflichtfelder veranschaulicht:
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
Nur Hinflug (alle)
Im folgenden Beispiel werden alle verfügbaren Felder für eine einfache Fahrt veranschaulicht:
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
Hin- und Rückflug (erforderlich)
Die zweite Reise ist eine Hin- und Rückfahrt von San Francisco nach Alaska und Kanada für 14 Nächte. Im folgenden Beispiel werden nur die Pflichtfelder veranschaulicht:
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
Hin- und Rückflug (alle)
Im folgenden Beispiel werden alle verfügbaren Felder für eine Hin- und Rückfahrt veranschaulicht:
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 (zu Informationszwecken)
Nur Hinflug (erforderlich)
Die erste Reise oder der erste Reiseplan ist eine einfache Fahrt von San Francisco nach Kanada für vier Nächte. Im folgenden Beispiel werden nur die Pflichtfelder veranschaulicht:
[
{
"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"
}
]
Nur Hinflug (alle)
Im folgenden Beispiel werden alle verfügbaren Felder für eine einfache Fahrt veranschaulicht:
[
{
"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"
}
]
Hin- und Rückflug (erforderlich)
Die zweite Reise ist eine Hin- und Rückfahrt von San Francisco nach Alaska und Kanada für 14 Nächte. Im folgenden Beispiel werden nur die Pflichtfelder veranschaulicht:
[
{
"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"
}
]
Hin- und Rückflug (alle)
Im folgenden Beispiel werden alle verfügbaren Felder für eine Hin- und Rückfahrt veranschaulicht:
[
{
"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"
}
]