[C#]행안부 주소 검색 API 활용하기

📮 주소검색 API 라이브러리 - Address_Finder

주소검색 API를 좀 더 쉽게 쓰기 위해 C#용 라이브러리로 만들어봤습니다.
도로명주소 API를 사용할 때 매번 파라미터 세팅, JSON 파싱, 페이지 이동 로직 등을 직접 짜는 게 귀찮아서
단 한 줄로 결과를 받아올 수 있도록 구성했습니다. 😊

 

github에 예제코드가 포함되어 있습니다.

https://github.com/idleh4021/lib-address-finder

GitHub - idleh4021/lib-address-finder: 행정안정부에서 제공하는 주소찾기 API를 사용한 주소검색 기능 라

 

---

💡 주요 기능

기능설명관련 메서드 / 코드 예시

⚙️ 간단한 초기화	API Key만 등록하면 바로 사용 가능합니다.	var finder = new Address_Finder.Address_Finder("your_api_key");
🔍 주소 검색	키워드(도로명, 지번 등)를 이용해 주소를 검색합니다.	var list = finder.GetAddress("서울시 강남구");
📑 페이지 이동	검색 결과가 여러 페이지일 경우, 페이지 간 이동을 지원합니다.	var list = finder.MovePage(2);
🧭 검색 결과 바인딩	검색 결과(List<juso>)를 DataGridView 등에 바로 표시할 수 있습니다.	dataGridView1.DataSource = list;
🏷️ 선택된 주소 반환	DataGridView 등에서 선택한 주소를 모델로 가져옵니다.	juso sel = (juso)dataGridView1.CurrentRow.DataBoundItem;
📋 DataTable 결과 지원 (추가 기능)	List<juso> 대신 DataTable 형태로도 결과를 받을 수 있습니다. 데이터바인딩 시 유용합니다.	var dt = finder.GetAddressToDataTable("서울시 강남구"); // 주소검색 결과를 DataTable로 반환 var dt2 = finder.MovePageToDataTable(2); // 다음 페이지 결과를 DataTable로 반환

---

⚙️ 설치 및 사용법

1️⃣ 프로젝트에 라이브러리 추가

• 배포된 Address_Finder.dll 파일을 프로젝트에 참조 추가(Reference) 해주세요.
• Visual Studio 기준으로는
  [프로젝트] → [참조 추가] → [찾아보기] → Address_Finder.dll 선택
  후 확인하시면 됩니다.

2️⃣ 필수 패키지 설치 (JSON 파싱용)

• Newtonsoft.Json이 필요합니다.

Install-Package Newtonsoft.Json

 

3️⃣ API Key 발급

• 행안부 주소검색 API 사이트 접속
• 검색용 API KEY 발급

4️⃣ 초기화 및 코드 작성

//1.초기화
Address_Finder.Address_Finder address_finder; = new Address_Finder.Address_Finder(api_key); 

//2.검색
var result = address_finder.GetAddress(textBox1.Text); //List<juso> 모델 return
//또는
var result = address_finder.GetAddressToDataTable("서울 강남구"); //DataTable

//3.페이지 이동
var result = address_finder.MovePage(address_finder.CURRENT_PAGE + 1); //List<juso> 모델 return 
//또는
var result = address_finder.MovePageToDataTable(address_finder.CURRENT_PAGE + 1); //DataTable

//4.Winform DataGridView 바인딩
dataGridView1.DataSource = result;

 

🪄 예제 화면

 

🏁 마무리

이 라이브러리는 도로명주소 API를 사용하는 과정에서
매번 JSON 파싱, 페이지 처리, 리스트 변환을 반복하는 불편함을 줄이기 위해 제작했습니다.
필요하신 분들은 자유롭게 가져다 쓰시고, 개선 제안이나 PR도 환영합니다. 

 

https://github.com/idleh4021/lib-address-finder

GitHub - idleh4021/lib-address-finder: 행정안정부에서 제공하는 주소찾기 API를 사용한 주소검색 기능 라