고속도로어때 앱 개선 안내 - CCTV API 오류 대응

CCTV API 오류 대응과 ITS API 제한량 안내

고속도로 CCTV와 교통상황을 확인할 수 있는 고속도로어때 앱이 안정성 개선 중심으로 업데이트되었습니다.

이번 개선은 단순한 화면 변경이 아니라, 실제 앱 사용 중 발생할 수 있는 CCTV 조회 오류, API 사용량 초과, 인증 오류, 반복 조회 문제에 대응하기 위한 보완입니다.

특히 ITS OpenAPI를 이용하는 앱에서는 공공 API의 호출 제한량을 고려해야 합니다. 이번 업데이트에서는 API 제한량을 초과했을 때 앱이 종료되지 않고, 사용자에게 적절한 안내 메시지를 보여주도록 개선했습니다.

---

고속도로어때 앱이란?

고속도로어때는 고속도로 CCTV와 교통 정보를 확인할 수 있는 앱입니다.

현재 위치 또는 입력한 위치를 기준으로 주변 CCTV를 조회하고, 선택한 CCTV 영상을 통해 도로 상황을 확인할 수 있습니다.

주요 기능은 다음과 같습니다.

- 현재 위치 기준 가까운 CCTV 조회
- 입력한 위치 기준 CCTV 조회
- CCTV 영상 보기
- 지도에서 CCTV 위치 확인
- 교통정보 및 돌발정보 확인
- 자주 보는 CCTV 즐겨찾기 등록

 

운전 전 고속도로 흐름을 미리 확인하거나, 특정 구간의 정체 여부를 확인할 때 유용하게 사용할 수 있습니다.

---

이번 개선의 핵심

이번 버전의 핵심은 앱 안정성 향상입니다.

기존에는 CCTV API 호출 중 오류가 발생하면 앱이 예외로 종료될 수 있었습니다. 특히 API 인증 실패나 사용량 초과가 발생하면 401 오류 또는 resultCode: 4001 같은 응답이 발생할 수 있습니다.

이번 업데이트에서는 이런 상황에서도 앱이 종료되지 않고, 사용자에게 원인을 안내하도록 개선했습니다.

---

주요 개선 내용

1. CCTV API 오류 발생 시 앱 종료 방지

기존 방식에서는 API 호출 코드에서 바로 GetStringAsync()를 사용하고 있었습니다.

이 방식은 서버에서 401 Unauthorized 같은 오류를 반환하면 즉시 예외가 발생하고, 예외 처리가 충분하지 않으면 앱이 종료될 수 있습니다.

이번 개선에서는 API 응답을 먼저 확인하고, 상태 코드와 응답 내용을 분석한 뒤 처리하도록 변경했습니다.

개선 후에는 다음과 같은 오류가 발생해도 앱이 종료되지 않습니다.

- 401 인증 오류
- API Key 오류
- 개인 제한량 초과
- 네트워크 오류
- 응답 지연
- JSON 파싱 오류

 

---

2. ITS API 개인 제한량 초과 안내 개선

실제 발생한 오류 중 하나는 다음과 같은 내용이었습니다.

resultCode: 4001
resultMsg: 개인 제한량을 초과하였습니다.

 

이 오류는 API Key가 잘못된 것이 아니라, ITS OpenAPI의 개인 호출 제한량을 초과했다는 의미입니다.

즉, 앱 자체의 오류라기보다 공공 API 서버에서 허용한 호출 횟수를 초과한 상태입니다.

이번 개선에서는 이 경우를 별도로 구분해 사용자에게 다음과 같은 형태로 안내하도록 했습니다.

CCTV API 사용량이 초과되었습니다.
공공데이터 API의 개인 호출 제한량을 초과하여
현재 CCTV 정보를 조회할 수 없습니다.

잠시 후 다시 시도하거나
ITS OpenAPI 사용량을 확인해 주세요.

 

---

3. 인증 오류와 사용량 초과 오류 구분

API 오류는 원인이 다양합니다.

예를 들어 401 오류가 발생하면 일반적으로 인증 실패로 보일 수 있지만, 응답 내용에 따라 실제 원인은 다를 수 있습니다.

이번 개선에서는 오류를 단순히 “통신 오류”로 처리하지 않고, 가능한 범위에서 원인을 구분하도록 했습니다.

- 401: API 인증 실패 가능성
- 4001: 개인 제한량 초과
- Timeout: 서버 응답 지연
- Network Error: 인터넷 연결 문제
- JSON Error: 응답 형식 문제

 

이렇게 구분하면 개발자도 문제 원인을 빠르게 파악할 수 있고, 사용자도 상황을 이해하기 쉬워집니다.

---

ITS API 제한량이란?

고속도로어때 앱은 CCTV 정보와 교통 정보를 조회하기 위해 ITS OpenAPI를 사용합니다.

ITS OpenAPI는 공공 교통 데이터를 제공하는 유용한 서비스이지만, 무제한으로 호출할 수 있는 것은 아닙니다.

일반적으로 OpenAPI는 다음과 같은 이유로 호출 제한을 둡니다.

- 서버 과부하 방지
- 특정 사용자의 과도한 호출 방지
- 전체 사용자에게 안정적인 서비스 제공
- 비정상적인 반복 호출 차단

 

따라서 앱에서 API를 너무 자주 호출하면 제한량을 초과할 수 있습니다.

---

API 제한량 초과가 발생하는 경우

다음과 같은 상황에서 API 사용량이 빠르게 증가할 수 있습니다.

- 앱 실행 시마다 자동으로 CCTV 조회
- 현재위치 조회 버튼을 반복 클릭
- 입력위치 조회를 짧은 시간에 반복 실행
- 지도 이동 또는 탭 전환 시마다 API 재호출
- 테스트 중 앱을 반복 실행
- 개발 중 디버깅 과정에서 여러 번 조회

 

특히 개발 단계에서는 앱을 자주 실행하고 테스트하기 때문에 실제 사용자보다 API 호출량이 훨씬 많아질 수 있습니다.

---

이번 버전에서 적용한 제한량 대응

이번 업데이트에서는 API 제한량 문제를 줄이기 위해 다음과 같은 보완을 적용했습니다.

1. 동일 위치 반복 조회 캐시 적용

같은 위치에서 짧은 시간 내에 다시 CCTV를 조회하는 경우, API를 다시 호출하지 않고 기존 조회 결과를 재사용하도록 개선했습니다.

이를 통해 불필요한 API 호출을 줄일 수 있습니다.

같은 위치 반복 조회
→ 기존 결과 재사용
→ API 호출 감소

 

---

2. 사용량 초과 시 일정 시간 추가 호출 제한

API 서버에서 “개인 제한량 초과” 응답이 오면, 앱은 일정 시간 동안 추가 API 호출을 하지 않도록 처리했습니다.

이렇게 하면 제한량을 초과한 상태에서 계속 API를 호출하는 문제를 막을 수 있습니다.

사용량 초과 발생
→ 추가 호출 일시 중지
→ 사용자에게 안내 메시지 표시

 

---

3. 요청 URL과 API Key 화면 노출 제거

기존 오류 안내에서는 요청 URL이 함께 표시될 수 있었습니다.

하지만 요청 URL에는 API Key가 포함될 수 있기 때문에, 사용자 화면에 그대로 표시하는 것은 좋지 않습니다.

이번 개선에서는 사용자에게는 간단한 오류 원인만 보여주고, 상세 URL과 응답 내용은 개발자 확인용 로그에서만 볼 수 있도록 조정했습니다.

개선 후 사용자 화면에는 다음 정도만 표시됩니다.

resultCode: 4001
resultMsg: 개인 제한량을 초과하였습니다.

 

API Key가 포함될 수 있는 URL은 화면에 표시하지 않습니다.

---

사용자 입장에서 달라진 점

이번 개선으로 사용자는 다음과 같은 차이를 느낄 수 있습니다.

- API 오류가 발생해도 앱이 종료되지 않음
- CCTV 조회 실패 원인을 더 쉽게 알 수 있음
- 사용량 초과 시 불필요한 재시도가 줄어듦
- 즐겨찾기 CCTV는 더 빠르게 다시 확인 가능
- 큰 글씨 설정 환경에서도 화면이 더 안정적으로 표시됨

 

---

개발 관점에서의 개선 효과

개발자 입장에서는 이번 개선이 꽤 중요합니다.

공공 API를 사용하는 앱은 서버 응답 상태가 항상 정상일 수 없습니다. 따라서 앱 내부에서 다음 처리가 필요합니다.

- API 상태 코드 확인
- 오류 응답 본문 분석
- 예외 발생 시 앱 종료 방지
- 사용자 안내 메시지 분리
- 개발자용 로그 분리
- API Key 보안 처리
- 반복 호출 방지
- 캐시 처리

 

이번 업데이트는 이러한 요소들을 반영해 앱의 실사용 안정성을 높인 버전입니다.

---

업데이트 주요 내용 정리

- CCTV API 사용량 초과 오류 대응
- API 호출 실패 시 앱 종료 방지
- 401 인증 오류와 4001 제한량 초과 구분
- 개인 제한량 초과 안내 메시지 개선
- 요청 URL 및 API Key 화면 노출 제거
- 동일 위치 반복 조회 캐시 적용
- 사용량 초과 시 일정 시간 추가 호출 제한
- 입력필드 및 조회 버튼 높이 조정
- 큰 글씨 설정 환경 UI 개선
- CCTV 조회 안정성 개선

 

---

사용자가 알아두면 좋은 점

CCTV 정보는 ITS OpenAPI를 통해 제공되므로, API 서버 상황이나 호출 제한량에 따라 일시적으로 조회가 되지 않을 수 있습니다.

이 경우 앱을 반복해서 실행하거나 조회 버튼을 계속 누르기보다는 잠시 후 다시 시도하는 것이 좋습니다.

CCTV 조회가 안 될 때
1. 잠시 후 다시 시도
2. 인터넷 연결 확인
3. 앱 재실행
4. 계속 안 되면 API 사용량 제한 가능성 확인

 

---

마무리

이번 고속도로어때 업데이트는 기능 추가뿐만 아니라, 공공 API 기반 앱에서 꼭 필요한 안정성 개선을 포함하고 있습니다.

특히 ITS API 제한량 초과, 인증 오류, 네트워크 오류가 발생해도 앱이 종료되지 않고 사용자에게 원인을 안내하도록 개선했습니다.

앞으로도 고속도로어때 앱은 운전자가 필요한 교통 정보를 더 안정적으로 확인할 수 있도록 계속 개선해 나갈 예정입니다.

고속도로를 이용하기 전,
고속도로어때로 CCTV와 교통상황을 미리 확인해 보세요.