[FAQ] 지도/로컬 API 문의 전 꼭 읽어 주세요.
안녕하세요.
카카오맵 Web(JavaScript) SDK의 로드뷰를 사용하는 웹 서비스를 개발 중입니다.
사업화 가능성을 검토하는 단계에서 쿼터 집계 기준과 이용 범위를 정확히 확인하고자
문의드립니다.
■ 사용 환경
- 카카오맵 Web(JavaScript) SDK (dapi.kakao.com/v2/maps/sdk.js)
- 주요 사용 객체: kakao.maps.Roadview, kakao.maps.RoadviewClient
- 배포 형태: HTTPS 정적 웹 호스팅
■ 구현 방식
사용자가 로드뷰 상에서 연속적으로 위치를 이동하는 형태입니다.
한 번의 이동은 다음 3단계로 구성됩니다.
-
현재 시점(pan) 방향으로 약 8m 앞의 좌표를 계산
-
RoadviewClient.getNearestPanoId(좌표, 반경 20m, callback) 호출
-
반환된 panoId로 Roadview.setPanoId() 실행
사용자가 이동 입력을 유지하는 동안 위 1~3을 약 600ms 간격으로 반복합니다.
따라서 이동이 지속되는 동안 초당 약 1.7회의 getNearestPanoId 호출이 발생하며,
사용자가 30분간 연속으로 이동할 경우 누적 약 3,000회 수준이 됩니다.
이 호출 패턴 때문에 쿼터 산정이 서비스 설계에 결정적이라 아래와 같이 문의드립니다.
■ 문의 사항
1. 쿼터 집계 단위
지도 Web(JavaScript) SDK의 무료 쿼터 300,000건/일 기준으로, 아래 항목이
각각 어떻게 집계되는지 구분해서 알려주시면 감사하겠습니다.
(1) RoadviewClient.getNearestPanoId() 호출 1회 = 1건으로 집계되는지
(2) Roadview.setPanoId() 실행으로 발생하는 파노라마 이미지/타일 로드가
(1)과 별도로 추가 집계되는지, 아니면 포함되는지
(별도라면 파노라마 1개 로드가 몇 건으로 계산되는지)
(3) Roadview.setViewpoint()로 시점(pan/tilt/zoom)만 변경하고
위치 이동이 없는 경우에도 쿼터가 차감되는지
(4) 직전과 동일한 panoId를 다시 로드하는 경우에도 매번 차감되는지
(5) getNearestPanoId가 panoId를 찾지 못하고 null을 반환한 경우에도
1건으로 집계되는지
2. 호출 빈도 제한 (rate limit)
(1) 일일 쿼터와 별개로 초당 또는 분당 호출 빈도 제한이 있는지,
있다면 그 기준이 어떻게 되는지
(2) 위와 같이 600ms 간격으로 반복 호출하는 패턴이 비정상 트래픽이나
어뷰징으로 판단될 소지가 있는지
(3) 만약 권장되지 않는 패턴이라면, 로드뷰에서 연속 이동을 구현할 때
권장하시는 호출 방식이 따로 있는지
3. 상업적 이용 범위
카카오 개발자 운영정책 제5조 11항에 승인 없는 상업적 목적의 판매·거래·재판매를
금지하는 조항이 있어 사전에 확인이 필요합니다.
(1) 로드뷰를 포함한 카카오맵 Web SDK를 유료 구독 또는 광고 기반의
영리 서비스에 사용하는 것이 허용되는지
(2) 허용된다면 별도의 사전 승인, 제휴, 계약 절차가 필요한지
필요하다면 어느 창구로 신청해야 하는지
(3) 개인 사용자 대상(B2C)과 기업·기관 대상 유료 공급(B2B)의
조건이 다른지
4. 무료 쿼터 및 유료 전환
(1) "개발자 계정 기준 첫 번째로 활성화한 앱에만 무료 쿼터 제공"이 맞는지,
즉 동일 계정의 두 번째 앱부터는 무료 쿼터 없이 전량 과금인지
(2) 유료 전환(비즈월렛 연결 및 유료 API 사용 설정)의 구체적 절차
(3) 일일 쿼터 소진 시의 동작 — 즉시 호출이 차단되는지,
아니면 유료 설정이 되어 있으면 자동 과금되며 계속 제공되는지
(4) 일 300,000건을 크게 초과하는 사용량이 예상되는 경우
별도 협의나 쿼터 증설 절차가 있는지, 대량 사용 시 단가 협의가 가능한지
5. 저작권 및 표기 의무
로드뷰 화면 위에 자체 UI(정보 표시, 조작 버튼 등)를 오버레이하여 사용할 예정입니다.
(1) 반드시 가리지 않고 노출해야 하는 요소(카카오 로고, 저작권 표기,
기본 컨트롤 등)의 기준이 있는지
(2) 관련하여 준수해야 할 디자인 가이드 문서가 있다면 안내 부탁드립니다.
답변 주시는 내용에 맞춰 설계와 사업성 검토를 진행하려 합니다.
확인 부탁드립니다. 감사합니다.