숙박 일정 피드

숙박 일정 피드에는 크루즈 운항 정보가 포함됩니다. 각 숙박 일정에는 여러 경로가 있습니다. 각 이동에는 항구, 도착 및 출발 시간 및 날짜, 여정의 각 단계의 항해 시간, 각 이동에 대한 설명과 같은 이동 세부정보가 포함됩니다. 숙박 일정 피드는 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-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를 공유하므로 이동을 그룹화하고 정리할 수 있습니다.

예를 들어 두 가지 다른 숙박 일정에서 경유지가 샌프란시스코를 통과하는 경우 두 숙박 일정의 숙박 일정 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

왕복 (필수)

두 번째 항해는 샌프란시스코에서 출발하여 알래스카와 캐나다를 거치는 왕복 항해로 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"
  }
]

왕복 (필수)

두 번째 항해는 샌프란시스코에서 출발하여 알래스카와 캐나다를 거치는 왕복 항해로 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"
  }
]