Loading...
Loading...
Compare original and translation side by side
문장부호: 출력에(em-dash)를 쓰지 않는다. 쉼표나 마침표로 끊는다.—
标点符号:输出时请勿使用(破折号),请用逗号或句号分隔。—
context.md팀원context.mdcontext.md成员context.mdcontext.md주제경로topic-selectbootcamp-start../bootcamp-start/references/guides/api-setup.mdcontext.md主题路径topic-selectbootcamp-start../bootcamp-start/references/guides/api-setup.md"우리 가설이 '외국인은 오는데 지방 정보가 없다'였잖아요. 그럼 장소가 실제로 얼마나 있는지(공급)랑 외국인이 어느 나라에서 오는지(다양성)를 보면 되겠는데, 이 셋이면 될까요, 빠진 게 있을까요?"
| API (data.go.kr 검색어) | 서비스 | 무엇을 주나 |
|---|---|---|
국문 관광정보 서비스_GW | | 거의 모든 팀이 쓴다. 장소 개수·이름·좌표·운영시간. 프로토타입에 박을 실제 장소가 여기서 나온다 |
빅데이터_지역별 방문자수_GW | | 얼마나 오나. 월별 추이로 계절 편차 |
지역별 관광 수요 강도 | | 자고 가나(체류)·돈 쓰나(소비) |
지역별 관광 자원 수요 | | 관광서비스·문화자원을 찾는 수요. 공급과 비교하면 갭이 보인다 |
지역별 관광 다양성 | | 연령·소비·국적이 고른가. 낮으면 쏠렸다는 뜻 |
관광지별 연관 관광지 정보 | | 동선. 보고 나서 어디로 넘어가나 |
| 관광지 집중률 방문자 추이 예측 정보 | | 30일 혼잡 예보. 검증에도 쓰고 프로토타입 실시간 기능으로도 쓴다 |
| 무장애 여행 정보 | | 휠체어·유아차 접근 가능 장소 |
| 반려동물 동반여행 서비스 | | 반려동물 동반 가능 장소 |
| 웰니스관광정보 | | 치유·명상·스파. 전국 174건뿐이라 0이 곧 공백 |
| 고캠핑 정보 조회서비스_GW | | 야영장·캠핑장 |
| 의료관광정보 | | 의료관광 기관. 서울 65% 편중이라 지역 비교엔 부적합 |
| 두루누비 정보 서비스_GW | | 걷기여행길 코스 144개. 거리·소요시간·난이도·교통편이 숫자로 있다 |
| 기초지자체 중심 관광지 | | 시군구별 연계 방문 많은 관광지 100위 + 좌표. 프로토타입 출발점 |
⚠ 필요한 것만 고른다. 활용신청은 건마다 활용목적을 적는 폼이라 14개를 다 하면 20분이 녹는다.
"我们的假设是‘外国人想来,但地方旅游信息不足’,对吧?那我们需要查看实际有多少景点(供给)以及外国人来自哪些国家(多样性),这三个API应该够了吧,有没有遗漏的呢?"
| API(data.go.kr搜索词) | 服务 | 提供内容 |
|---|---|---|
韩文旅游信息服务_GW | | 几乎所有团队都会使用。提供景点数量、名称、坐标、营业时间。原型中使用的实际景点数据均来自此API |
大数据_地区访客数_GW | | 访客数量。通过月度变化查看季节差异 |
地区旅游需求强度 | | 是否停留(逗留)·是否消费(支出) |
地区旅游资源需求 | | 旅游服务·文化资源的搜索需求。与供给数据对比可发现缺口 |
地区旅游多样性 | | 年龄·消费·国籍是否均衡。数值低表示集中化 |
景点关联景点信息 | | 游览路线。看完当前景点后可前往哪些景点 |
| 景点集中度访客趋势预测信息 | | 30天拥挤预测。可用于验证,也可作为原型的实时功能 |
| 无障碍旅游信息 | | 轮椅·婴儿车可进入的景点 |
| 宠物陪同旅游服务 | | 可携带宠物的景点 |
| 康养旅游信息 | | 疗愈·冥想·SPA。全国仅174条数据,返回0条即表示空白 |
| 露营信息查询服务_GW | | 露营地·野营地 |
| 医疗旅游信息 | | 医疗旅游机构。65%集中在首尔,不适用于地区对比 |
| 漫步旅游信息服务_GW | | 徒步旅行路线144条。包含距离·所需时间·难度·交通方式的数值信息 |
| 以基层自治体为中心的景点 | | 市郡区访问量Top100关联景点+坐标。可作为原型的起点 |
⚠ 只选择需要的API。每次申请都需要填写使用目的表单,若申请全部14个API会花费20分钟。
data.go.kr/data/{번호}/openapi.do⚠ 신청 직후엔 안 된다. 승인돼도 게이트웨이 반영까지 최대 1시간(때로 수 시간). 이때 호출하면 XML 에러가 아니라 평문가 온다 = 아직 미반영. 시간이 지나면 자동으로 풀린다.Unauthorized
data.go.kr/data/{编号}/openapi.do⚠ 申请后无法立即使用。即使获得批准,网关同步需要最多1小时(有时甚至数小时)。此时调用API不会返回XML错误,而是返回明文,表示尚未同步。等待一段时间后会自动恢复正常。Unauthorized
$deep-dive$deep-diveundefinedundefined
나머지 서비스의 최소 호출은 `api-setup.md` **§3.5~§3.9에 14종 전부 완전한 형태로 있다**. 키만 넣어
그대로 실행하면 된다. 값이 0건이어도 `resultCode:0000`이면 **활성**이다(웰니스·의료관광은 전국 건수가
적어 특정 시군구 0건이 정상, 수요지수 3종은 지표코드를 안 넣으면 0건이 정상).
실패하면 경로 문제가 아니라 **활용신청이 빠진 것**이다.
**판정과 안내**
| 응답 | 뜻 | 안내 |
|---|---|---|
| `resultCode:0000` | 활성 | 통과 |
| 평문 `Unauthorized` | 키 또는 신청이 아직 미반영 | 잠시 후 재시도 |
| `SERVICE_ACCESS_DENIED` / `Forbidden` | **그 서비스만 활용신청이 빠졌다** | **어느 API인지 이름을 대고** 신청하게 한다 |
| `INVALID_REQUEST_PARAMETER` | 파라미터 문제 (키는 정상) | `api-setup.md`의 필수 파라미터 확인 |
| `NO_OPENAPI_SERVICE_ERROR` | **엔드포인트 경로가 틀렸다** (활용신청 문제 아님) | §1.5 표의 경로를 그대로 복사 |
> 실패했을 때 "안 되네요"로 끝내지 않는다. **어느 활용신청이 빠졌는지 이름을 말해준다.**
> 4단계에서 이걸 발견하면 1시간을 다시 기다려야 한다.
---
其他服务的最小调用示例可在`api-setup.md`**§3.5~§3.9中找到完整的14种API调用方式**。只需填入密钥即可直接运行。即使返回数据为0条,只要`resultCode:0000`就表示**已激活**(康养·医疗旅游的全国数据量较少,特定市郡区返回0条属于正常情况;3种需求指数API若未填入指标代码,返回0条也属于正常)。如果调用失败,不是路径问题,而是**未完成该API的使用申请**。
**判定与指引**
| 响应 | 含义 | 指引 |
|---|---|---|
| `resultCode:0000` | 已激活 | 通过 |
| 明文`Unauthorized` | 密钥或申请尚未同步 | 稍后重试 |
| `SERVICE_ACCESS_DENIED` / `Forbidden` | **仅该服务未完成使用申请** | **明确告知API名称**,引导完成申请 |
| `INVALID_REQUEST_PARAMETER` | 参数问题(密钥正常) | 检查`api-setup.md`中的必填参数 |
| `NO_OPENAPI_SERVICE_ERROR` | **端点路径错误**(与使用申请无关) | 直接复制§1.5表格中的路径 |
> 调用失败时不要只说‘不行’,要**明确告知是哪个API未完成申请**。如果到第4阶段才发现,需要再等待1小时。
---context.md.envDATA_GO_KR_SERVICE_KEY=....gitignoreexport.envcontext.md.envDATA_GO_KR_SERVICE_KEY=....env.gitignoreexport.env활용신청활성확인단계: 2使用申请激活验证阶段: 2$region-selectUnauthorized$region-selectUnauthorized