旅行プラン フィード

クルーズの旅程フィードには、クルーズの運航情報が含まれています。各旅程には、一連のルートが含まれています。各ルートには、寄港地、到着時刻と出発時刻、各区間の航海時間、各ルートの説明など、ルートの詳細が含まれています。旅程フィードは CSV 形式でアップロードできます。

主要コンポーネント

旅程フィードには、大文字と小文字が区別されない必須フィールドがあります。一部のフィールドは省略可能で、空白のままにできます。省略可能なデータを送信すると、データ品質が向上します。

次の必須フィールドがあります。

  • sail_id : 特定のルートの一意の運航識別子。

  • stop_index : 各出発港の一意の寄港地識別子。

  • port_of_call: 寄港地またはクルーズが停泊する場所。

  • itinerary_desc: 旅程の説明。

  • arrival_dt: 港の協定世界時（UTC）での到着日時。

  • departure_dt: 港の協定世界時（UTC）での出発日時。

  • ship_name: 船の名前。

  • sail_duration: 航海日数。

フィールド

次の表に、旅程フィードで使用できるすべてのフィールドを示します。

フィールド名 必須かどうか 種類 説明
sail_id Required string 開始日と終了日を含む旅程の特定のルートの一意の運航識別子。

たとえば、3 つの寄港地がある 5 泊の旅程の場合、 sail_id は一意であり、3 つの寄港地すべてで同じです。 の例は sail_id です ABC12345。

注: sail_id と stop_index は連結されて複合主キーを形成するため、一意である必要があります。
stop_index Required integer クルーズの旅程の各寄港地の一意のインデックス識別子。最初の寄港地はインデックス 0 から始まります。0 は最初の 出発港を表します。たとえば、stop_index は 0 で表されます。

注: sail_id と stop_index は連結されて複合主キーを形成するため、 一意である必要があります。
port_of_call Required string クルーズが停泊する都市名と国名を含む場所。 たとえば、port_of_call は Venice,Italy で表すことができます。

引用符（"）は明示的に必要ありません。

itinerary_desc Required string 旅程の説明。「X 泊」で始まり、X は旅程の泊数です。大文字と小文字は区別されません。 たとえば、itinerary_desc は 7-night greek isles & eastern med になります。
arrival_dt Required datetime 港の協定世界時（UTC）での到着日時。最初の港の arrival_dt は空にする必要があり、 stop_index は 0 にする必要があります。 たとえば、arrival_dt は 2025-01-22T06:00:00+01:00 で表されます。
departure_dt Required datetime 港の協定世界時（UTC）での出発日時。最後の港の departure_dt は空にする必要があります。 stop_index は旅程の最終夜にする必要があります。 たとえば、departure_dt は 2025-01-23T18:00:00+01:00 で表されます。
ship_name Required string 船の名前。大文字と小文字は区別されません。 たとえば、ship_name は NORWEGIAN Escape で表すことができます。
sail_duration Required integer 航海日数。 たとえば、5 泊の航海の場合、sail_duration は 5 で表されます。
itinerary_id Required string 旅程を識別します。itinerary_id は旅程を区別します。同じ寄港地に立ち寄るすべてのルートは同じ itinerary_id を共有するため、ルートをグループ化して整理できます。

たとえば、2 つの異なる旅程でサンフランシスコを経由する場合、両方の旅程で旅程 ID は同じになります。XYZ12345 で表されます。
latitude Optional decimal この寄港地の緯度。 WGS84 表記で指定する必要があります。この情報は、寄港地エンティティを正確に 特定するのに役立ちます。たとえば、イタリアのトリエステの緯度座標は 45.64665541364354 です。以下は サポートされていません:
  • 東京
  • GCJ-02
longitude Optional decimal この寄港地の経度。 WGS84 表記で指定する必要があります。この情報は、寄港地エンティティを正確に 特定するのに役立ちます。たとえば、イタリアのトリエステの経度座標は 13.76188003458354です。以下は サポートされていません:
  • 東京
  • GCJ-02
image_url Optional URL 寄港地を表す画像の URL。例: https://partner.com/images/XXXXX.jpg
updated_at Optional datetime このエントリが最後に更新された日時（ 協定世界時（UTC））。この情報は、 （現在地が）最新でないデータを特定するのに役立ちます。 ISO 8601 形式に準拠する必要があります。たとえば、updated_at は 2025-01-22T00:00:00+00:00 です。

例

次は、2 つの航海（片道と往復）の旅程フィードの基本的な例です。

この例では、CSV 形式と JSON 形式の両方を示しています。sail_id フィールドと stop_index フィールドは連結されて複合主キーを形成するため、各行で一意である必要があります。

CSV

片道（必須）

最初の航海または旅程は、サンフランシスコからカナダまでの 4 泊の片道です。次の例は、必須フィールドのみを示しています。

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

片道（すべて）

次の例は、片道で利用可能なすべてのフィールドを示しています。

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

往復（必須）

2 回目の航海は、サンフランシスコからアラスカとカナダを巡る 14 泊の往復です。次の例は、必須フィールドのみを示しています。

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

往復（すべて）

次の例は、往復で利用可能なすべてのフィールドを示しています。

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（情報提供用）

片道（必須）

最初の航海または旅程は、サンフランシスコからカナダまでの 4 泊の片道です。次の例は、必須フィールドのみを示しています。

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

片道（すべて）

次の例は、片道で利用可能なすべてのフィールドを示しています。

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

往復（必須）

2 回目の航海は、サンフランシスコからアラスカとカナダを巡る 14 泊の往復です。次の例は、必須フィールドのみを示しています。

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

往復（すべて）

次の例は、往復で利用可能なすべてのフィールドを示しています。

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