Kakao Maps JavaScript SDK 오류 문의

Kakao Maps JavaScript SDK 사용 중 아래와 같은 장애가 발생하여 문의드립니다.

■ 앱ID
1269951

■ 대상 서비스
Kakao Maps JavaScript SDK

■ 장애 개요
new kakao.maps.LatLng() 객체의 내부 필드명이 사전 공지 없이 변경되어, 위·경도 좌표값을 직접 참조하던 일부 기능에 장애가 발생하였습니다.

■ 변경 내용

  • 변경 전 : La (위도), Ma (경도)

  • 변경 후 : Ca (위도), Da (경도)

■ 장애 발생 시간대

  • 감지 시각 : 2025년 5월 26일 15:33 ~ 16:05 (KST)

  • 해당 시간대에 SDK 배포 또는 업데이트가 이루어진 것으로 추정됩니다.

■ 영향 범위

  • LatLng 객체의 내부 프로퍼티(La, Ma)를 직접 참조하는 코드에서 좌표값이 undefined로 반환

  • 지도 상 좌표 표시 및 관련 기능 일부 비정상 동작

■ 문의 사항

  1. 이번 필드명 변경이 의도된 배포인지 확인 부탁드립니다.

  2. 향후 내부 프로퍼티 변경 시 사전 공지 또는 Deprecation 안내를 제공해 주실 수 있는지 문의드립니다.

  3. 공식적으로 안정적인 좌표 취득 방법(예: getLat(), getLng() 메서드 사용 권장 여부)을 재확인하고 싶습니다.

내부 프로퍼티인 점은 인지하고 있으나, 필드명이 빈번하게 변경될 경우 서비스 안정성에 직접적인 영향을 미치므로 공식 입장을 확인 부탁드리겠습니다.

1개의 좋아요

@티머니모빌리티0529

안녕하세요,
LatLng 객체 사용 시 가이드에 명시된 방법대로 사용하셔야 합니다.
https://apis.map.kakao.com/web/documentation/#LatLng

내부 속성에 대해서는 고정을 보장하지 않으므로 임의로 사용하시면 안됩니다.
이점 참고하셔서 사용 부탁드립니다.

감사합니다.

cc. @Maps