Google は AI 技術を使用して、コンテンツをご希望の言語に翻訳しています。AI 翻訳には誤りが含まれる場合があります。

旅行プランフィード

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

主要コンポーネント

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

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

sail_id : 特定のルートの一意の運航識別子。
stop_index : 各出発港の一意の寄港地識別子。

重要なポイント: 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"
  }
]

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

主要コンポーネント

フィールド

例

CSV

片道（必須）

片道（すべて）

往復（必須）

往復（すべて）

JSON（情報提供用）

片道（必須）

片道（すべて）

往復（必須）

往復（すべて）

旅行プランフィード