[지도 웹(JS) SDK] Kakao 인증 버전 마이그레이션 가이드

2018년 3월 31일부터	developers.daum.net 사이트 접속 불가
2018년 12월 31일부터	apis.daum.net로 API 요청 불가

기존에 다음 개발자 콘솔 사이트 공지, 지도 개발자 사이트 뉴스 및 개별 메일로 전달해 드린 바 있는 Daum Developers 종료로 인해, (구)지도 JS API를 사용하시는 개발자분들께서는 Kakao 인증 버전으로 이관해 주셔야 합니다.

이에 도움이 될 만한 가이드를 아래와 같이 전달해 드립니다.


앱키 발급, 도메인 등록 방식이 변경되었습니다.

아래 가이드를 보시고 진행해 주시면 됩니다.

http://apis.map.daum.net/web/guide/


Services 라이브러리가 변경되었습니다.

Kakao 인증 버전의 Services 라이브러리는 IE8 이상에서만 정상 동작합니다.

(구) API의 문서는
http://apis.map.daum.net/web/news/#oldServicesLibDocs
여기에 남아있습니다.

변경점은 아래와 같이 정리할 수 있습니다.

daum.maps.services 네임스페이스에 존재하는 선택 가능한 검색 옵션들이 몇가지 사라졌습니다.

daum.maps.services.ImageFilter
daum.maps.services.Format

이 두 가지는 이제 사용할 수 없습니다.

기존에 존재했던 아래 다섯 가지의 좌표계 변환은 이제 지원하지 않습니다.

daum.maps.services.Coords.KTM
daum.maps.services.Coords.UTM
daum.maps.services.Coords.BESSEL
daum.maps.services.Coords.WKTM
daum.maps.services.Coords.WUTM

모든 검색의 결과 콜백으로 받는 인자의 순서가 변경되었습니다.
이 변경사항은
Places의 keywordSearch, categorySearch
Geocoder의 addressSearch, coord2Address, coord2RegionCode, transCoord
모두에 해당됩니다.
키워드 검색을 예로 들면

var places = new daum.maps.services.Places();

// 기존에는 status가 첫 번째였습니다.
var callback = function(result, status) {
    if (status === daum.maps.services.Status.OK) {
        console.log(result);
    }
};

places.keywordSearch('판교 치킨', callback);

모든 검색의 응답 결과 포멧이 변경되었습니다.
응답 결과에 대한 내용은
https://developers.kakao.com/docs/restapi/local
이 문서를 참조해 주세요. [Response] 부분을 보시면 됩니다.

Geocoder의 함수가 변경되었습니다.

  • addr2coord => addressSearch

  • coord2addr => coord2Address
    같이 변경된 사항이 있는데
    기존에는 coord2addr(coord, callback) 으로 daum.maps.LatLng 객체를 첫 번째 파라메터로 받았지만
    변경 후에는 coord2Address(x, y, callback, options) 으로 x, y 따로 받게 되었습니다.
    이것은 options로 검색할 좌표계를 설정할 수 있는 기능이 추가되면서 불가피하게 변경하게 되었습니다.

  • coord2detailaddr 은 삭제
    대신 위에 변경되었다고 알려드린 coord2Address의 결과로 지번/도로명 모두를 얻을 수 있습니다.

  • coord2RegionCode 은 새로이 추가

  • transCoord는 parameter의 구성이 변경되었습니다.
    기존에는 transCoord(x, y, fromCoord, toCoord, callback)
    변경 후에는 transCoord(x, y, callback, options)
    새로운 transCoord는 기본으로 받는 파라메터가 사라진 대신 options으로 좌표계 변환 값들을 설정할 수 있습니다.

Pagination 객체는 기능 변경 없습니다.

5개의 좋아요