안녕하세요, 카카오입니다.
더 안정적인 서비스 운영을 위해 카카오내비 API 내 웹 길안내 서비스가 종료될 예정임을 알려드립니다.
종료 일정
- 2022년 3월 28일(월)
대상
- 카카오내비 > JavaScript/Android/iOS SDK > 길안내/목적지 공유 기능
변경사항
- 서비스 종료에 따라, 카카오내비 앱 미설치 시 길안내 기능의 동작이 변경됩니다.
- AS-IS: 웹 길안내 실행
- TO-BE: 설치 페이지로 이동
- Kakao SDK는 다음 버전부터 웹 길안내 서비스 종료에 따른 동작 변경에 대응합니다.
- JavaScript SDK: 2022년 1월 28일(금) 이후 배포 버전(배포 예정 버전: 1.41.0)
- Android SDK: 2.8.4
- iOS SDK: 2.8.4
필요한 조치
- 웹 길안내 서비스 종료에 따라 카카오내비 앱 미설치 환경에서 서비스 이용이 어려울 수 있으므로,
플랫폼별로 아래와 같이 조치하시기 바랍니다.
-
JavaScript SDK
- 2022년 1월 28일(금) 이후 배포 버전(배포 예정 버전: 1.41.0) 사용
- 아래와 같이 JavaScript SDK를 import한 경우, 최신 버전이 자동 적용되므로 별도 조치 불필요
<script src="https://developers.kakao.com/sdk/js/kakao.js"></script>
-
Android SDK
- 2.8.3 이하 버전
- 최신 버전 업데이트 권장
- 웹 길안내를 요청하는
v2-navi
모듈의navigateWebUrl()
메서드 호출 로직 제거 -
v2-navi
모듈의isKakaoNaviInstalled()
메서드를 통해 카카오내비 앱 설치 여부 확인 가능
- 2.8.3 이하 버전
-
iOS SDK
- 2.8.3 이하 버전
- 최신 버전 업데이트 권장
- 웹 길안내를 요청하는
KakaoSDKNavi
모듈의webNavigateUrl()
메서드 호출 로직 제거 -
KakaoSDKNavi
모듈의canOpenURL()
메서드를 통해 카카오내비 앱 설치 여부 확인 가능
- 2.8.3 이하 버전
참고 문서
위 변경사항에 대해 궁금하신 점은 데브톡으로 문의해 주시기 바랍니다.
언제나 더 좋은 서비스를 제공하기 위해 최선을 다 하겠습니다.
감사합니다.
Hello. It is Kakao.
We announce that Kakao Navi API will end support for the web version of navigation to provide more stable services as of March 28, 2022.
End of support date
- March 28, 2022
Target
- Kakao Navi > JavaScript, Android, iOS SDK > Navigation, Sharing location
Changes
-
The web version of navigation will be no longer available.
-
The flow to start navigation is changed if the Kakao Navi application is not installed on a user’s device.
- Before: the web version of Kakao Navi is open via a default browser.
- After: the page directing to download the Kakao Navi application is open.
-
For this change,
- In the JavaScript SDK released after January 28, 2022 (Expected version: 1.41.0), there are internal changes.
- In Android SDK 2.8.4, the
navigateWebUrl()
method is deleted. - In iOS SDK 2.8.4, the
webNavigateUrl()
method is deleted.
What to do
Before the end of support date, take the following actions according to the SDKs you are using. Otherwise, the use of the service may be restricted on the devices where the Kakao Navi application is not installed.
-
JavaScript SDK:
-
You MUST use the JavaScript SDK released after January 28, 2022 (Expected version: 1.41.0) as the Kakao Navi web version will be no longer available.
-
If you have imported the JavaScript SDK as follows, you do not have to change anything since the latest version of SDK is applied automatically.
<script src="https://developers.kakao.com/sdk/js/kakao.js"></script>
-
-
Android SDK:
- We recommend using the latest SDK.
- If you use the Android SDK 2.8.3 or lower, change your code not to use the
navigateWebUrl()
method. You can add a logic to check if the Kakao Navi application is installed by usingisKakaoNaviInstalled()
to guide to the download page if not installed.
-
iOS SDK:
- We recommend using the latest SDK.
- If you use the iOS SDK 2.8.3 or lower, change your code not to use the
webNavigateUrl()
method. You can add a logic to check if the Kakao Navi application is installed by usingcanOpenURL()
to guide to the download page if not installed.
Reference
If you have any questions about the new Kakao Navi APIs, ask us in the Kakao Navi category.
We will always do our best to provide you with better service. Thank you.
Kakao Developers