Reiseplanfeed

Der Reiseplanfeed enthält Informationen zu Kreuzfahrten. Jeder Reiseplan enthält eine Reihe von Fahrten. Jede Fahrt enthält Details zur Fahrt, z. B. Häfen, Ankunfts- und Abfahrtszeiten und -daten, die Dauer der einzelnen Fahrtabschnitte und eine Beschreibung der einzelnen Fahrten. Sie können Reiseplanfeeds im CSV-Format hochladen.

Schlüsselkomponenten

Der Reiseplanfeed enthält Pflichtfelder, bei denen die Groß- und Kleinschreibung nicht beachtet wird. Einige Felder sind optional und können leer gelassen werden. Durch das Senden optionaler Daten wird die Datenqualität verbessert.

Sie enthält die folgenden Pflichtfelder:

  • sail_id : Eine eindeutige Kennung für eine bestimmte Fahrt.

  • stop_index : Eine eindeutige Haltestelleneid für jeden Abfahrtsort.

  • port_of_call: Der Anlegehafen oder der Ort, an dem die Kreuzfahrt anhält.

  • itinerary_desc: Beschreibung des Reiseplans.

  • arrival_dt: Datum und Uhrzeit der Ankunft in der koordinierten Weltzeit(UTC) des Hafens.

  • departure_dt: Abreisedatum und ‑uhrzeit in der koordinierten Weltzeit (UTC) des Hafens.

  • ship_name: Der Name des Schiffs.

  • sail_duration: Dauer oder Anzahl der Segeltage.

Felder

In der folgenden Tabelle werden alle verfügbaren Felder im Reiseplanfeed beschrieben:

Feldname Erforderlich? Typ Beschreibung
sail_id Required string Eindeutige ID für eine bestimmte Fahrt im Reiseplan mit Start- und Enddatum.

Bei einem Reiseplan mit 5 Übernachtungen und 3 Stopps ist sail_id beispielsweise eindeutig und bleibt für alle 3 Stopps gleich. Ein Beispiel für sail_id ist ABC12345.

Hinweis:sail_id und stop_index werden zu einem zusammengesetzten Primärschlüssel zusammengefügt und müssen eindeutig sein.
stop_index Required integer Eindeutige Index-ID für jede Haltestelle im Kreuzfahrtprogramm. Die Nummerierung beginnt mit dem Index 0 für die erste Haltestelle. Die Null steht für den ersten Abfahrtsort. Beispiel: stop_index wird als 0 dargestellt.

Hinweis:sail_id und stop_index werden zu einem zusammengesetzten Primärschlüssel zusammengefügt und müssen eindeutig sein.
port_of_call Required string Ort mit dem Namen der Stadt und dem Land, an dem die Kreuzfahrt anhält. port_of_call kann beispielsweise als Venice,Italy dargestellt werden.

Anführungszeichen (") sind ausdrücklich nicht erforderlich.

itinerary_desc Required string Beschreibung des Reiseplans. Sie beginnt mit „X-Übernachtung“, wobei X die Anzahl der Übernachtungen im Reiseplan ist. Groß- und Kleinschreibung wird nicht berücksichtigt. itinerary_desc kann beispielsweise 7-night greek isles & eastern med sein.
arrival_dt Required datetime Ankunftsdatum und -uhrzeit in der koordinierten Weltzeit(UTC) des Hafens. Die arrival_dt für den ersten Anschluss muss leer sein und die stop_index muss null sein. arrival_dt wird beispielsweise als 2025-01-22T06:00:00+01:00 dargestellt.
departure_dt Required datetime Abreisedatum und -zeit in der koordinierten Weltzeit(UTC) des Hafens. Der departure_dt für den letzten Anschluss muss leer sein. Der stop_index muss die letzte Nacht des Reiseplans sein. departure_dt wird beispielsweise als 2025-01-23T18:00:00+01:00 dargestellt.
ship_name Required string Der Name des Schiffs. Groß- und Kleinschreibung wird nicht berücksichtigt. ship_name kann beispielsweise als NORWEGIAN Escape dargestellt werden.
sail_duration Required integer Die Dauer der Reise oder die Anzahl der Übernachtungen an Bord. Bei 5 Übernachtungen auf See wird sail_duration beispielsweise als 5 dargestellt.
itinerary_id Required string Identifiziert den Reiseplan. Mit dem itinerary_id werden Reisepläne voneinander unterschieden. Alle Fahrten, die dieselben Anlaufhäfen anlaufen, haben dieselbe itinerary_id. So können Fahrten gruppiert und organisiert werden.

Wenn der Anlaufhafen für zwei verschiedene Reisepläne San Francisco ist, ist die Reiseplan-ID für beide Reisepläne identisch. Sie wird als XYZ12345 dargestellt.
latitude Optional decimal Der Breitengrad dieses Anlaufhafens. Sie sollte in WGS84-Notation angegeben werden. Diese Informationen sind nützlich, um die Anlegestelle genau zu lokalisieren. Die Breitengradkoordinaten für Triest, Italien, sind beispielsweise 45.64665541364354. Folgendes wird nicht unterstützt:
  • TOKIO
  • GCJ-02
longitude Optional decimal Der Längengrad dieses Anlaufhafens. Sie sollte in der WGS84-Notation angegeben werden. Diese Informationen sind nützlich, um den Anlaufhafen genau zu lokalisieren. Die Längengradkoordinaten für Triest, Italien, sind beispielsweise 13.76188003458354. Folgendes wird nicht unterstützt:
  • TOKIO
  • GCJ-02
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 hilfreich, um veraltete Daten zu identifizieren. Sie muss dem ISO 8601-Format entsprechen. Angenommen, updated_at ist 2025-01-22T00:00:00+00:00.

Beispiele

Im Folgenden finden Sie ein einfaches Beispiel für einen Reiseplanfeed für zwei Fahrten, wobei eine Fahrt eine einfache Fahrt und die andere eine Hin- und Rückfahrt ist.

Die Beispiele zeigen sowohl CSV- als auch JSON-Formate. Die Felder sail_id und stop_index werden zusammengeführt, um den zusammengesetzten Primärschlüssel zu bilden. Sie müssen für jede Zeile eindeutig sein.

CSV

Nur Hinflug (erforderlich)

Die erste Fahrt oder Reiseroute ist eine einfache Fahrt von San Francisco nach Kanada mit einer Dauer von 4 Übernachtungen. Im folgenden Beispiel sind nur die Pflichtfelder zu sehen:

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 sind alle verfügbaren Felder für eine einfache Fahrt zu sehen:

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 14-tägige Rundreise von San Francisco nach Alaska und Kanada. Im folgenden Beispiel sind nur die Pflichtfelder zu sehen:

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 sind alle verfügbaren Felder für die Rückgabe dargestellt:

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 (nur zu Informationszwecken)

Nur Hinflug (erforderlich)

Die erste Fahrt oder Reiseroute ist eine einfache Fahrt von San Francisco nach Kanada mit einer Dauer von 4 Übernachtungen. Im folgenden Beispiel sind nur die Pflichtfelder zu sehen:

[
  {
    "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)

Das folgende Beispiel zeigt alle verfügbaren Felder für eine einfache Fahrt:

[
  {
    "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 14-tägige Rundreise von San Francisco nach Alaska und Kanada. Im folgenden Beispiel sind nur die Pflichtfelder zu sehen:

[
  {
    "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 sind alle verfügbaren Felder für die Rückgabe dargestellt:

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