Mina Choi
951e451ef8
_to_unit_facts() 가 업종을 안 가리고 room_type·weekday_price/weekend_price 로만 냈다. 그 key 는 숙박 스키마에만 있어서, 음식점·카페·클리닉은 메뉴/프로그램 요금표가 FACT_INVALID_KEY 로 전량 거부됐다(실측: "도플로" fact 19건 중 19건 반려). - naver_place_adapter.py: _UNIT_NAME_KEY·_UNIT_PRICE_KEY 로 업종별 key 매핑 (숙박 room_type/weekday·weekend_price, 카페·음식점 menu_name/menu_price, 클리닉 program_name/price_adult) - SourceAdapter.fetch() 계약에 category 파라미터 추가, 어댑터 5개 시그니처 반영 - collect_service.py: fetch_one() 에 place.category 전달 검증: 재수집 후 stored 0 → 35(음식점), test_collector·test_category_schema· test_fact_api·test_tour_api_adapter 173 passed
427 lines
23 KiB
Python
427 lines
23 KiB
Python
"""한국관광공사 TourAPI(KorService2) 어댑터 — 숙박·음식점.
|
|
|
|
★ 왜 이 어댑터가 다른 어댑터보다 우선인가 (docs/DATA_SOURCE_RESEARCH.md)
|
|
네이버·카카오·OTA 에서 긁어온 값은 **출처를 밝힐 수 없다**. robots 를 어겼거나 재게시 근거가 없어서다.
|
|
출처를 못 밝히는 사실은 `llms.txt`·`AnswerBlock` 의 "출처와 검증 시각" 신호를 채우지 못하고,
|
|
AI 검색이 인용할 이유도 없다(GEO 연구: 인용률을 올리는 요인 1위가 '출처 인용'이다).
|
|
|
|
TourAPI 는 반대다 — **무료·이용허락범위 제한없음**이라 재게시에 제약이 없고, 출처를 당당히 밝힐 수 있다.
|
|
같은 사실이라도 여기서 온 것이 값이 더 크다.
|
|
(단 '대한민국구석구석' 에 contentId 로 열리는 공개 페이지는 **없다** — 아래 SOURCE_URL 주석 참고.)
|
|
|
|
★ 수집 경로
|
|
detailCommon2 개요·홈페이지·좌표·대표사진
|
|
detailIntro2 업종별 소개정보(체크인·주차·취사 / 영업시간·대표메뉴 …)
|
|
detailInfo2 숙박은 **객실 단위** 정보(인원·요금·면적·객실사진), 음식점은 반복정보
|
|
detailImage2 추가 사진
|
|
|
|
★ 이미지 저작권 — 여기서 끝낸다 (docs/DECISIONS.md 1-2)
|
|
TourAPI 는 사진마다 공공누리 유형(`cpyrhtDivCd`)을 준다.
|
|
Type1 출처표시 상업적 이용 O · 변형 O
|
|
Type2 출처표시 + 상업적이용금지 상업적 이용 X ← 버린다
|
|
Type3 출처표시 + 변경금지 상업적 이용 O · 변형 X
|
|
Type4 출처표시 + 상업적이용금지 + 변경금지 ← 버린다
|
|
사장님 홈페이지는 **상업적 이용**이므로 Type2·Type4 는 수집 단계에서 통째로 버린다.
|
|
Type3 는 담되 `license` 에 표시해 둔다 — 뒤에서 크롭·리사이즈하면 '변경금지' 를 어긴다.
|
|
|
|
**금지 (docs/DECISIONS.md 1-1, 결론과 무관하게 영구)**
|
|
캡차 우회 · 봇 탐지 우회 · IP 회전. 여기는 공식 API 라 해당 사항이 없고, 앞으로도 만들지 않는다.
|
|
"""
|
|
import re
|
|
from typing import Optional
|
|
from urllib.parse import unquote, urlencode
|
|
|
|
import httpx
|
|
|
|
from common.enums import LinkChannel, PlaceCategory
|
|
from common.logger import LOG
|
|
from config.server_configs import external_api_config
|
|
from services.collector.base import CollectedFact, CollectedMedia, RawSource
|
|
|
|
BASE_URL = "https://apis.data.go.kr/B551011/KorService2"
|
|
|
|
# fact 의 출처로 남기는 주소. **인증키를 뺀** 해당 레코드의 API 주소다.
|
|
#
|
|
# ★ 왜 '대한민국구석구석' 페이지가 아닌가 (2026-08-31 실측)
|
|
# 처음엔 korean.visitkorea.or.kr/detail/ms_detail.do?cotid={contentId} 를 썼는데 **틀렸다.**
|
|
# 구석구석의 `cotid` 는 TourAPI 의 `contentid` 와 다른 체계(GUID)라, 어떤 contentId 를 넣어도
|
|
# 같은 크기(7,702B)의 "안내 페이지" 가 돌아온다. 검색 결과 페이지도 전부 JS 렌더라
|
|
# contentId 로 바로 열리는 공개 URL 이 존재하지 않는다.
|
|
#
|
|
# 그래서 **그 레코드를 정확히 가리키면서 재현 가능한 주소**를 쓴다. 키가 없으면 데이터 대신
|
|
# 인증 오류가 오지만, 자기 키를 가진 사람은 같은 값을 그대로 받아볼 수 있다 —
|
|
# 출처의 목적(어디서 왔고 어떻게 확인하는가)은 이것으로 충족된다.
|
|
# ★ 인증키는 절대 넣지 않는다. 이 주소는 DB 에 저장되고 발행본에도 나간다.
|
|
SOURCE_URL = (
|
|
"https://apis.data.go.kr/B551011/KorService2/detailCommon2"
|
|
"?contentId={content_id}&MobileOS=ETC&MobileApp=o2o-web4ai&_type=json"
|
|
)
|
|
# 화면에 적을 출처 이름. URL 만으로는 무엇인지 알 수 없어서 함께 남긴다.
|
|
SOURCE_LABEL = "한국관광공사 TourAPI"
|
|
|
|
REQUEST_TIMEOUT = 25
|
|
MAX_MEDIA = 30
|
|
|
|
CONTENT_TYPE_LODGING = "32"
|
|
CONTENT_TYPE_RESTAURANT = "39"
|
|
_SUPPORTED = (CONTENT_TYPE_LODGING, CONTENT_TYPE_RESTAURANT)
|
|
|
|
# ★ 상업적 이용이 허용된 공공누리 유형만 담는다. 목록에 없는 코드는 '모른다' 로 보고 버린다 —
|
|
# 새 코드가 생겼을 때 조용히 통과시키는 것보다 빠뜨리는 쪽이 안전하다.
|
|
COMMERCIAL_OK_LICENSES = frozenset({"type1", "type3"})
|
|
# 변형(크롭·리사이즈)까지 금지된 유형. 뒤 단계가 이걸 보고 원본 그대로 써야 한다.
|
|
NO_DERIVATIVE_LICENSES = frozenset({"type3", "type4"})
|
|
|
|
# 이 어댑터가 받는 주소. 사장님이 붙여넣는 것은 구석구석 주소이고,
|
|
# tour:// 는 내부에서 콘텐츠 id 를 바로 지정할 때 쓴다(채널 발견·재수집).
|
|
_COTID = re.compile(r"[?&]cotid=([0-9a-zA-Z\-]+)", re.I)
|
|
_TOUR_SCHEME = re.compile(r"^tour://(\d+)/(\d+)$", re.I)
|
|
_HOSTS = ("visitkorea.or.kr",)
|
|
|
|
_BR = re.compile(r"<br\s*/?>", re.I)
|
|
_TAGS = re.compile(r"<[^>]+>")
|
|
_HREF = re.compile(r'href=["\']([^"\']+)["\']', re.I)
|
|
# "13실", "16명", "대지 면적 11,570㎡" 처럼 숫자에 단위가 붙어 온다. number 필드는 숫자만 남긴다.
|
|
_LEADING_NUM = re.compile(r"^\s*([\d,]+(?:\.\d+)?)")
|
|
|
|
# ★ "가능 / 불가" 로 시작하는 필드들. 뒤에 괄호 설명이 붙는다:
|
|
# parkinglodging = "가능 (객실당 1대 무료 주차)"
|
|
# parkingfood = "불가 (인근 주차장 이용)" ← 뒤에 '이용' 이 있다고 true 로 읽으면 안 된다
|
|
# 그래서 **맨 앞 토큰**으로만 부호를 판정한다. 문자열 전체를 훑으면 뒤집힌다(실측).
|
|
_NEG_HEAD = ("불가", "없음", "미제공", "불가능", "없슴")
|
|
_POS_HEAD = ("가능", "있음", "제공", "무료", "부분")
|
|
|
|
|
|
class TourApiAdapter:
|
|
"""TourAPI 콘텐츠 → fact·사진 후보."""
|
|
|
|
id = "tour_api"
|
|
|
|
# ---- 계약 ----------------------------------------------------------
|
|
def can_handle(self, url: str) -> bool:
|
|
u = (url or "").strip().lower()
|
|
if _TOUR_SCHEME.match(u):
|
|
return True
|
|
return any(h in u for h in _HOSTS) and bool(_COTID.search(u))
|
|
|
|
async def fetch(self, url: str, category: Optional[PlaceCategory] = None) -> RawSource:
|
|
channel = LinkChannel.ETC
|
|
key = (external_api_config.tour_api_key or "").strip()
|
|
if not key:
|
|
return RawSource.failure(url, self.id, "TOUR_API_KEY 가 설정되지 않았다", channel)
|
|
|
|
parsed = self._parse_url(url)
|
|
if not parsed:
|
|
return RawSource.failure(url, self.id, f"콘텐츠 id 를 찾지 못했다: {url}", channel)
|
|
content_id, content_type = parsed
|
|
|
|
try:
|
|
async with httpx.AsyncClient(timeout=REQUEST_TIMEOUT) as client:
|
|
common = await self._call(client, key, "detailCommon2", contentId=content_id)
|
|
if not common:
|
|
return RawSource.failure(url, self.id, f"detailCommon2 결과 없음(contentId={content_id})", channel)
|
|
common = common[0]
|
|
|
|
# URL 에 타입이 없으면 공통정보가 알려준다.
|
|
content_type = content_type or str(common.get("contenttypeid") or "")
|
|
if content_type not in _SUPPORTED:
|
|
return RawSource.failure(
|
|
url, self.id,
|
|
f"지원하지 않는 콘텐츠 타입: {content_type} (숙박 32 · 음식점 39 만 받는다)",
|
|
channel,
|
|
)
|
|
|
|
intro = await self._call(client, key, "detailIntro2", contentId=content_id, contentTypeId=content_type)
|
|
info = await self._call(client, key, "detailInfo2", contentId=content_id, contentTypeId=content_type)
|
|
images = await self._call(client, key, "detailImage2", contentId=content_id, imageYN="Y")
|
|
except httpx.TimeoutException:
|
|
return RawSource.failure(url, self.id, f"{REQUEST_TIMEOUT}s 안에 응답이 없다", channel)
|
|
except httpx.HTTPError as ex:
|
|
return RawSource.failure(url, self.id, f"네트워크 오류: {ex}", channel)
|
|
except RuntimeError as ex:
|
|
return RawSource.failure(url, self.id, str(ex), channel)
|
|
|
|
source_url = SOURCE_URL.format(content_id=content_id)
|
|
intro_row = intro[0] if intro else {}
|
|
|
|
facts = self._common_facts(common)
|
|
if content_type == CONTENT_TYPE_LODGING:
|
|
facts += self._lodging_facts(intro_row)
|
|
facts += self._room_facts(info)
|
|
else:
|
|
facts += self._restaurant_facts(intro_row)
|
|
|
|
media = self._media(common, images, info if content_type == CONTENT_TYPE_LODGING else [])
|
|
|
|
LOG.i(
|
|
f"[tour_api] {common.get('title')} — fact {len(facts)}건 · 사진 {len(media)}장 "
|
|
f"(contentId={content_id} type={content_type})"
|
|
)
|
|
return RawSource(
|
|
url=source_url,
|
|
adapter_id=self.id,
|
|
channel=channel,
|
|
text=self._plain(common.get("overview")),
|
|
facts=facts,
|
|
media=media,
|
|
)
|
|
|
|
# ---- HTTP ----------------------------------------------------------
|
|
async def _call(self, client: httpx.AsyncClient, key: str, op: str, **params) -> list[dict]:
|
|
"""오퍼레이션 1회. 결과가 없으면 빈 목록 — 없는 것과 실패를 구분한다.
|
|
|
|
★ 포털의 'Encoding' 키를 그대로 넣어도 이중 인코딩되지 않도록 원문으로 되돌린다
|
|
(services/external/tour_api.py 와 같은 처리다).
|
|
"""
|
|
query = urlencode(
|
|
{"serviceKey": unquote(key), "MobileOS": "ETC", "MobileApp": "o2o-web4ai",
|
|
"_type": "json", "numOfRows": "50", "pageNo": "1", **params},
|
|
safe="",
|
|
)
|
|
res = await client.get(f"{BASE_URL}/{op}?{query}")
|
|
if res.status_code != 200:
|
|
raise RuntimeError(f"{op} HTTP {res.status_code}")
|
|
|
|
try:
|
|
payload = res.json()
|
|
except ValueError:
|
|
# 인증 실패·쿼터 초과는 XML 로 온다. 본문 앞부분을 그대로 올려 원인을 감추지 않는다.
|
|
raise RuntimeError(f"{op} 응답이 JSON 이 아니다: {res.text[:160]}")
|
|
|
|
header = payload.get("response", {}).get("header", {})
|
|
code = str(header.get("resultCode") or "")
|
|
if code not in ("0000", "00"):
|
|
raise RuntimeError(f"{op} 실패 [{code}] {header.get('resultMsg')}")
|
|
|
|
items = (payload.get("response", {}).get("body", {}).get("items") or {}).get("item")
|
|
if isinstance(items, dict):
|
|
return [items]
|
|
return items or []
|
|
|
|
@staticmethod
|
|
def _parse_url(url: str) -> Optional[tuple[str, str]]:
|
|
"""(contentId, contentTypeId) — 타입을 모르면 빈 문자열."""
|
|
m = _TOUR_SCHEME.match((url or "").strip())
|
|
if m:
|
|
return m.group(2), m.group(1)
|
|
m = _COTID.search(url or "")
|
|
return (m.group(1), "") if m else None
|
|
|
|
# ---- 값 다듬기 -------------------------------------------------------
|
|
@classmethod
|
|
def _plain(cls, value) -> str:
|
|
"""<br> 은 줄바꿈으로, 나머지 태그는 제거. ★ 글자는 지우지 않는다 — '불가' 가 사라지면 부호가 뒤집힌다."""
|
|
if value is None:
|
|
return ""
|
|
text = _TAGS.sub("", _BR.sub("\n", str(value)))
|
|
return re.sub(r"[ \t]+", " ", text).strip()
|
|
|
|
@classmethod
|
|
def _yn(cls, value) -> Optional[bool]:
|
|
"""'Y'/'N' 또는 '1'/'0'. 그 외에는 판단하지 않는다(None)."""
|
|
v = str(value or "").strip().upper()
|
|
if v in ("Y", "1"):
|
|
return True
|
|
if v in ("N", "0"):
|
|
return False
|
|
return None
|
|
|
|
@classmethod
|
|
def _head_bool(cls, value) -> Optional[bool]:
|
|
"""'가능 (…)' / '불가 (…)' 처럼 **맨 앞 토큰**이 부호인 필드.
|
|
|
|
★ 문자열 전체를 훑으면 "불가 (인근 주차장 이용)" 이 true 로 뒤집힌다(실측).
|
|
"""
|
|
text = cls._plain(value)
|
|
if not text:
|
|
return None
|
|
head = text[:6]
|
|
if any(neg in head for neg in _NEG_HEAD):
|
|
return False
|
|
if any(pos in head for pos in _POS_HEAD):
|
|
return True
|
|
return None
|
|
|
|
@classmethod
|
|
def _number(cls, value) -> Optional[str]:
|
|
"""'13실' · '11,570㎡' → '13' · '11570'. 숫자로 시작하지 않으면 담지 않는다."""
|
|
m = _LEADING_NUM.match(cls._plain(value))
|
|
if not m:
|
|
return None
|
|
num = m.group(1).replace(",", "")
|
|
return num if num not in ("", "0") else None
|
|
|
|
@staticmethod
|
|
def _fact(key: str, value: Optional[str], *, unit: Optional[str] = None) -> Optional[CollectedFact]:
|
|
if value is None or not str(value).strip():
|
|
return None
|
|
return CollectedFact(
|
|
key=key, value=str(value).strip(),
|
|
scope="unit" if unit else "place", unit_name=unit,
|
|
)
|
|
|
|
@classmethod
|
|
def _collect(cls, pairs) -> list[CollectedFact]:
|
|
return [f for f in (cls._fact(*p[:2], unit=p[2] if len(p) > 2 else None) for p in pairs) if f]
|
|
|
|
# ---- 업종별 매핑 -----------------------------------------------------
|
|
def _common_facts(self, common: dict) -> list[CollectedFact]:
|
|
"""모든 업종 공통.
|
|
|
|
★ overview 를 `intro` fact 로 만들지 않는다 (2026-08-31 수정).
|
|
`intro` 는 스키마에서 allow_llm=True — **LLM 이 쓰는 칸**이지 수집하는 사실이 아니다
|
|
(절대규칙 7, tests/test_collector.py::test_adapters_do_not_collect_llm_written_fields).
|
|
|
|
한 번 어겼더니 이렇게 됐다: TourAPI overview 457자가 그대로 VERIFIED 로 들어가
|
|
사장님 사이트의 '숙소 소개' 를 차지하고, 정작 Gemini 가 쓴 162자 소개문은
|
|
PENDING_OWNER 로 뒤에 밀렸다. 원문을 그대로 싣는 것은 GEO 관점에서도 복제 콘텐츠다.
|
|
|
|
원문은 버리지 않는다 — RawSource.text 로 나가 place_channels.raw 에 박제되고,
|
|
소개문·FAQ 생성 시점에만 근거로 쓰인다(services/copy_service.py).
|
|
"""
|
|
return []
|
|
|
|
def _lodging_facts(self, intro: dict) -> list[CollectedFact]:
|
|
"""숙박 detailIntro2 → 사업장 단위 fact.
|
|
|
|
★ 스키마에 없는 값은 만들지 않는다. foodplace('식음료장 있음')는 lodging 스키마에
|
|
자리가 없어서 **일부러 버린다** — 억지로 breakfast 에 넣으면 '조식 제공' 으로 둔갑한다.
|
|
★ roomcount·scalelodging·accomcountlodging·subfacility 는 2026-09-07 에 자리를 만들었다
|
|
(total_rooms·building_scale·accommodation_capacity·facilities). 실측(오블로모프 3103191)에서
|
|
TourAPI 가 준 값의 절반이 자리가 없어 버려지고 있었다.
|
|
"""
|
|
return self._collect([
|
|
("check_in_time", self._plain(intro.get("checkintime"))[:40]),
|
|
("check_out_time", self._plain(intro.get("checkouttime"))[:40]),
|
|
("cancel_policy", self._plain(intro.get("refundregulation"))[:1000]),
|
|
("cooking_allowed", self._bool_str(self._head_bool(intro.get("chkcooking")))),
|
|
("parking", self._bool_str(self._head_bool(intro.get("parkinglodging")))),
|
|
("pickup_service", self._bool_str(self._head_bool(intro.get("pickup")))),
|
|
("bbq_available", self._bool_str(self._yn(intro.get("barbecue")))),
|
|
("facilities", self._plain(intro.get("subfacility"))[:500]),
|
|
("total_rooms", self._number(intro.get("roomcount"))),
|
|
("accommodation_capacity", self._number(intro.get("accomcountlodging"))),
|
|
# "약 23평" · "대지 면적 11,570㎡" 처럼 단위가 제각각이라 숫자로 뽑지 않고 원문을 싣는다.
|
|
("building_scale", self._plain(intro.get("scalelodging"))[:200]),
|
|
])
|
|
|
|
def _restaurant_facts(self, intro: dict) -> list[CollectedFact]:
|
|
"""음식점 detailIntro2 → 사업장 단위 fact.
|
|
|
|
★ 일부러 매핑하지 않는 필드 — 뜻이 미묘하게 다른 것들이다.
|
|
kidsfacility '어린이놀이방 유무' 이지 '아이 동반 가능' 이 아니다.
|
|
놀이방이 없다고 kids_allowed=false 로 올리면 아이를 데려올 수 있는 가게를
|
|
'아이 동반 불가' 로 만든다(실측: 가문 → kids_allowed=false 로 잘못 나왔다).
|
|
chkcreditcardfood '가능/없음' 이라 payment_methods(결제수단 **목록**)에 넣을 수 없다.
|
|
smoking '모두 금연석' 은 restaurant 스키마에 자리가 없다.
|
|
infocenterfood 문의 전화일 뿐 예약 채널이라는 근거가 없다.
|
|
"""
|
|
facts = self._collect([
|
|
("business_hours", self._plain(intro.get("opentimefood"))[:500]),
|
|
("closed_days", self._plain(intro.get("restdatefood"))[:200]),
|
|
("signature_menu", self._plain(intro.get("firstmenu"))[:200]),
|
|
("parking", self._bool_str(self._head_bool(intro.get("parkingfood")))),
|
|
("takeout", self._bool_str(self._head_bool(intro.get("packing")))),
|
|
("reservation_required", self._bool_str(self._head_bool(intro.get("reservationfood")))),
|
|
])
|
|
# treatmenu 는 "돔베고기 / 멸치국수 / 물만두 등" 처럼 취급 메뉴를 이어 붙여 준다.
|
|
# ★ 가격이 없으므로 이름만 단위로 만든다. 이름 없는 단위는 base 계약이 막는다.
|
|
for name in self._split_menu(intro.get("treatmenu")):
|
|
facts.append(CollectedFact(key="menu_name", value=name, scope="unit", unit_name=name))
|
|
return facts
|
|
|
|
@classmethod
|
|
def _split_menu(cls, value) -> list[str]:
|
|
"""'게살해물요리 / 난자완스 / 특색냉채 등' → 3건. 꼬리의 '등' 은 메뉴가 아니다."""
|
|
text = cls._plain(value)
|
|
if not text:
|
|
return []
|
|
out: list[str] = []
|
|
for token in re.split(r"[/,·]", text):
|
|
name = re.sub(r"\s*등\s*$", "", token).strip()
|
|
if len(name) >= 2 and name not in out:
|
|
out.append(name)
|
|
return out[:20]
|
|
|
|
def _room_facts(self, rooms: list[dict]) -> list[CollectedFact]:
|
|
"""숙박 detailInfo2 → **객실 단위** fact.
|
|
|
|
★ 이 자리가 비어 있어서 place.units 가 전 사업장 0건이었다(naver_place_adapter 주석 참조).
|
|
TourAPI 는 객실을 행으로 주므로 여기서 가장 깨끗하게 채워진다.
|
|
★ 면적은 roomsize2(㎡)를 쓴다 — 스키마의 room_size 단위가 ㎡ 다. roomsize1 은 평이라 섞으면 3배 틀린다.
|
|
★ 요금은 비수기 최소요금(offseason)을 주중·주말로, 성수기(peak) 주중값을 peak_price 로 담는다.
|
|
'최소요금' 이라는 것을 사장님이 확인 화면에서 보고 고칠 수 있게 후보로만 올린다.
|
|
"""
|
|
facts: list[CollectedFact] = []
|
|
seen: list[str] = []
|
|
for row in rooms:
|
|
name = self._plain(row.get("roomtitle"))
|
|
if not name or name in seen:
|
|
continue
|
|
seen.append(name)
|
|
facts += self._collect([
|
|
("room_type", name, name),
|
|
("standard_capacity", self._number(row.get("roombasecount")), name),
|
|
("max_capacity", self._number(row.get("roommaxcount")), name),
|
|
("room_size", self._number(row.get("roomsize2")), name),
|
|
("weekday_price", self._number(row.get("roomoffseasonminfee1")), name),
|
|
("weekend_price", self._number(row.get("roomoffseasonminfee2")), name),
|
|
("peak_price", self._number(row.get("roompeakseasonminfee1")), name),
|
|
("has_kitchen", self._bool_str(self._yn(row.get("roomcook"))), name),
|
|
("has_aircon", self._bool_str(self._yn(row.get("roomaircondition"))), name),
|
|
# 객실 편의시설 Y/N. ★ 빈 값은 '없음'이 아니라 '모름'이다 — _yn 이 None 을 주면 fact 를 만들지 않는다.
|
|
("has_bathroom", self._bool_str(self._yn(row.get("roombathfacility"))), name),
|
|
("has_tv", self._bool_str(self._yn(row.get("roomtv"))), name),
|
|
("has_internet", self._bool_str(self._yn(row.get("roominternet"))), name),
|
|
("has_refrigerator", self._bool_str(self._yn(row.get("roomrefrigerator"))), name),
|
|
("has_hairdryer", self._bool_str(self._yn(row.get("roomhairdryer"))), name),
|
|
("has_toiletries", self._bool_str(self._yn(row.get("roomtoiletries"))), name),
|
|
("has_table", self._bool_str(self._yn(row.get("roomtable"))), name),
|
|
("has_sofa", self._bool_str(self._yn(row.get("roomsofa"))), name),
|
|
("has_home_theater", self._bool_str(self._yn(row.get("roomhometheater"))), name),
|
|
])
|
|
return facts
|
|
|
|
@staticmethod
|
|
def _bool_str(value: Optional[bool]) -> Optional[str]:
|
|
"""★ None(모름)과 False(아니오)를 구분한다. 모르는 것을 '아니오' 로 만들지 않는다."""
|
|
return None if value is None else ("true" if value else "false")
|
|
|
|
# ---- 사진 -----------------------------------------------------------
|
|
def _media(self, common: dict, images: list[dict], rooms: list[dict]) -> list[CollectedMedia]:
|
|
"""대표사진 + 추가사진 + 객실사진. 상업적 이용이 막힌 유형은 여기서 버린다."""
|
|
out: list[CollectedMedia] = []
|
|
seen: set[str] = set()
|
|
dropped = 0
|
|
|
|
def add(url, license_code, label=None, unit=None) -> None:
|
|
nonlocal dropped
|
|
url = (url or "").strip()
|
|
if not url or url in seen:
|
|
return
|
|
code = str(license_code or "").strip().lower()
|
|
# ★ 라이선스를 모르면 담지 않는다. 상업 사이트에 실을 사진이라 '모름' 은 위험 쪽이다.
|
|
if code not in COMMERCIAL_OK_LICENSES:
|
|
dropped += 1
|
|
return
|
|
seen.add(url)
|
|
out.append(CollectedMedia(
|
|
origin_url=url, label=label or None, unit_name=unit,
|
|
license=code,
|
|
))
|
|
|
|
add(common.get("firstimage"), common.get("cpyrhtDivCd"), label=self._plain(common.get("title")))
|
|
for img in images:
|
|
add(img.get("originimgurl"), img.get("cpyrhtDivCd"), label=self._plain(img.get("imgname")))
|
|
for row in rooms:
|
|
unit = self._plain(row.get("roomtitle")) or None
|
|
for i in range(1, 6):
|
|
add(row.get(f"roomimg{i}"), row.get(f"cpyrhtDivCd{i}"),
|
|
label=self._plain(row.get(f"roomimg{i}alt")), unit=unit)
|
|
if len(out) >= MAX_MEDIA:
|
|
break
|
|
|
|
if dropped:
|
|
LOG.i(f"[tour_api] 상업적 이용이 허용되지 않은 사진 {dropped}장 제외(공공누리 유형)")
|
|
return out[:MAX_MEDIA]
|