kindie

주소검색

행정안전부 JUSO API를 사용한 주소검색 기능의 설정 방법을 안내합니다.

개요

kindie는 행정안전부 주소정보 누리집(JUSO) API를 사용하여 한국 주소검색 기능을 제공합니다. 배송 주소 입력, 사업장 주소 등록 등에 사용됩니다.

API 키 발급

  1. 도로명주소 API 센터에 접속
  2. 주소검색 API 신청 (무료)
  3. 승인 후 API 키 발급

환경변수 설정

JUSO_API_KEY="your-api-key"

사용 방법

주소검색은 API 라우트를 통해 동작합니다:

GET /api/address/search?query=강남대로

응답 예시:

{
  "results": [
    {
      "roadAddr": "서울특별시 강남구 강남대로 396",
      "jibunAddr": "서울특별시 강남구 역삼동 858",
      "zipNo": "06253"
    }
  ]
}

관련 파일

lib/korean/
└── address.ts           JUSO API 클라이언트

app/api/address/
└── search/route.ts      주소검색 API 라우트

기능 비활성화

// config.ts
export const features = {
  // ...
  addressSearch: false,
};