このページは Cloud Translation API によって翻訳されました。

旅行プランフィード

旅行プランフィードには、クルーズ船の運航情報が含まれています。各旅行プランには一連のルートがあります。各航海には、港、到着時刻と出発時刻、日付、航海の各フェーズの航海時間、各航海の説明などの詳細が含まれます。旅行プランのフィードを CSV 形式でアップロードできます。

主要コンポーネント

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

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

sail_id : 特定のルートの一意の航行識別子。
stop_index : 出発港ごとに一意の停留所 ID。

キーポイント: 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-night」で始まり、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` です。

例

次の例は、1 つの航海が片道で、もう 1 つの航海が往復である 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"
  }
]

旅行プラン フィード コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

主要コンポーネント

フィールド

例

CSV

片道（必須）

片道（すべて）

往復（必須）

往復（すべて）

JSON（参考情報）

片道（必須）

片道（すべて）

往復（必須）

往復（すべて）

旅行プランフィード