기존 KNTrip 재사용 시 /route 사용량 차감 기준 문의

카카오내비
1

반영했습니다 — 마지막 문단에 정석 패턴 문의를 추가한 전체본입니다.

안녕하세요. KNSDK(Android knsdk_ui 1.12.x / iOS KNSDK 1.10.x)로 주행 안내를 사용 중인 개발자입니다.

쿼터 관리 목적으로 /route, /safety 사용량이 정확히 어떤 SDK 호출에서 차감되는지 확인하고 싶습니다.

사용 패턴:

  1. KNSDK.makeTripWithStart(...)로 KNTrip을 생성한 뒤 KNDriveGuidance.startWithTrip(trip, priority, avoidOption)으로 경로 안내를 시작합니다.
  2. 앱 사정으로 가이던스를 stop() 했다가, 처음 받아둔 동일한 KNTrip 객체를 그대로 startWithTrip(...)으로 다시 시작하는 경우가 있습니다(목적지 변경 없음, makeTripWithStart 재호출 없음).

질문:

  1. 위 2번처럼 이미 생성된 KNTrip을 재사용해 startWithTrip을 호출하면, 그때마다 서버에 경로를 새로 요청해서 /route 사용량이 1건씩 차감되나요? 아니면 trip에 이미 담긴 경로를 재사용해서 서버 요청 없이 시작되나요?

  2. /route 차감 시점이 정확히 어디인가요? — makeTripWithStart 시점인지, trip.routeWithPriority(...) 시점인지, startWithTrip 시점인지 궁금합니다.

  3. 주행 중 guidanceRouteChanged 콜백이 오는 경우 중, KNGuideRouteChangeReason_SecondaryRouteSelected(대안 경로 선택) 로 경로가 바뀔 때도 서버 재탐색이 발생해 /route가 차감되나요? 아니면 최초 탐색 때 받은 다중 경로 내에서의 로컬 전환이라 차감이 없나요? (경로 이탈 OutOfRoute 재탐색은 차감으로 이해하고 있습니다 — 맞는지도 확인 부탁드립니다.)

  4. /safety 사용량은 어떤 기준으로 집계되나요? — 가이던스 세션 시작(startWithTrip/startWithoutTrip)당 1건인지, 주행 중 안전운행 데이터를 구간 단위로 받아올 때마다 차감인지 궁금합니다. 가이던스를 stop 후 재시작하면 /safety도 추가 차감되는지도 알려주시면 감사하겠습니다.

덧붙여, 저희처럼 주행 중 가이던스를 잠시 stop 했다가 같은 목적지로 이어서 재개해야 하는 경우에 권장하시는 정석적인 방법(불필요한 경로 재요청 없이 재개하는 공식 패턴)이 있다면 함께 알려주시면 감사하겠습니다.

가이던스 재시작 빈도를 설계할 때 쿼터 영향이 커서, 정확한 차감 기준을 알려주시면 큰 도움이 되겠습니다. 감사합니다.

2

안녕하세요, 카카오모빌리티 기술 제휴 담당자입니다.

아래와 같이 안내드립니다.

1. /route 차감 기준

  • 차감 (1건): KNTrip 생성 시 (최초 경로 탐색)

  • 미차감 (0건): 경로 이탈 재탐색, 이미 생성된 KNTrip 재사용

2. /safety 차감 기준

  • 차감 (1건): 안내 세션 시작 시점 (startWithTrip / startWithoutTrip)

  • 주의: stop() 후 다시 시작하면 세션이 재생성되어 1건 추가 차감

감사합니다.

3

빠른 답변 감사합니다

듣기로는 세션 몇분안에 다시 껏다 키면 차감 안되는 것도 있다던데 이런 정책도 있을까요?

4

아닙니다, 시간에 상관 없이 요청이 들어오면 차감됩니다.

참고 부탁드립니다. 감사합니다.