브이월드 오픈API를 쓰려면 인증키부터 받아야 합니다. 인증키는 개발키와 운영키 두 가지인데, 어느 쪽을 쓰느냐에 따라 기간·심사·반려 여부가 갈립니다. 아래에서 두 키의 차이와 자주 나는 오류를 정리했습니다.
브이월드 오픈API를 쓰려면 인증키부터 받아야 합니다. 인증키는 개발키와 운영키 두 가지인데, 어느 쪽을 쓰느냐에 따라 기간·심사·반려 여부가 갈립니다. 아래에서 두 키의 차이와 자주 나는 오류를 정리했습니다.
브이월드 개발키
브이월드 개발키는 서비스를 열기 전 개발·테스트에 쓰는 키입니다. 회원가입과 로그인 뒤 오픈API 인증키 발급 메뉴에서 신청하면 따로 메일이나 연락이 오지 않고, 인증키 관리 화면에 상태가 ‘개발’로 뜨면 바로 쓸 수 있습니다. 6개월마다 갱신해 최대 2년까지 쓰고, 그 뒤에는 새로 발급받거나 운영키로 전환합니다. QGIS·ArcGIS·엑셀 같은 프로그램에 붙이거나 연구·개인용으로 쓸 때도 개발키입니다.
브이월드 운영키
운영키는 실제로 운영 중인 서비스용입니다.
| 구분 | 내용 |
|---|---|
| 대상 | 운영 중인 웹사이트·앱·솔루션 |
| 신청 | 인증키 관리에서 개발키를 운영키로 전환 신청 |
| 심사 | 운영·관리 기관 심사 최대 10일 |
| 반려 시 | 서비스 내용 보완 후 재제출 |
| 갱신 | 2년마다 |
| 만료 임시 연장 | 운영키만, 1661-0115 전화 |
브이월드 인증키 오류 해결
가장 흔한 오류는 ‘인증키 정보가 올바르지 않습니다’입니다. 발급 때 서비스 유형을 웹사이트로 골랐다면 그때 등록한 URL을 domain 파라미터에 똑같이 넣어야 풀립니다. 브라우저에서 CORS 오류가 나면 http와 https를 맞추고 JSONP로 부르거나 백엔드에서 호출합니다. 사무실에서 지도가 아예 안 열린다면 과부하 의심으로 공인 IP가 막혔을 수 있으니 고객센터에 전화해 방화벽 차단 해제를 신청합니다.
브이월드 호출 제한
오픈API는 대부분 호출 건수 제한이 없지만 예외가 있습니다. 주소와 좌표를 바꾸는 지오코더 API는 하루 40,000건까지이고, 더 필요하면 초과신청서를 냅니다. 지오코딩 결과는 별도 저장장치나 데이터베이스에 저장할 수 없습니다. WMS 레이어는 5개 이상 한꺼번에 올릴 수 없고, 무리하게 많이 부르면 일시 차단될 수 있습니다.
브이월드는 국가 공간정보를 지도와 파일, 오픈API로 무료 제공하는 곳입니다. 지도는 가입 없이 볼 수 있지만 파일 다운로드와 일부 메뉴는 로그인해야 하고, 2026년 9월 29일에는 주소만 넣으면 지하시설물 유무를 알려 주는 조회 서비스가 생겼습니다. Bessel 좌표계 연속지적도·용도지역지구 등 185건은 12월 31일까지만 받을 수 있으니 필요하면 미리 챙기세요. 오픈API는 개발키를 신청 즉시 쓰고, 실제 운영 서비스라면 최대 10일 심사를 거쳐 운영키를 받습니다. QGIS나 엑셀에 붙이는 용도는 개발키입니다. 이용약관 개정 의견은 10월 29일까지 이메일로 낼 수 있고 아무 의사표시가 없으면 동의로 봅니다. 2년 동안 로그인하지 않으면 자동 탈퇴되니 키를 쓰는 계정은 주기적으로 로그인하고, 문의는 1661-0115로 합니다.
