API 데모! 서비스 데모!

지오코더 설명서

기민나인 지오코더는 한국 주소 지오코딩 솔루션입니다. 주소를 지리적 좌표(위도와 경도)로 변환할 수 있으며, 그 반대로 좌표를 주소로 변환할 수 있습니다.

특징

다양한 주소 형식 지원 (도로명 주소, 지번 주소)
지오코딩 및 리버스 지오코딩
간편한 API 사용
파일 지오코딩
매우 적은 리소스 사용
초고속 처리 속도
온프레미스 호스팅 가능(Enterprise 제품)
쉬운 설치와 데이터 업데이트

웹 서비스 사용법

계정 관리

회원가입

지오코더 서비스를 이용하기 위해 회원으로 가입하세요. 회원가입 시 자동으로 7일간의 Pro 회원 혜택이 제공됩니다.

회원가입 절차

1.

상단 네비게이션 바에서 "회원가입" 버튼을 클릭합니다.

2.

필수 정보(사용자명, 이메일, 비밀번호)를 입력합니다.

3.

"회원가입" 버튼을 클릭하여 가입을 완료합니다.

4.

가입 즉시 API 토큰이 자동으로 발급되고, 7일간의 Pro 혜택이 적용됩니다.

Pro 혜택 안내

회원가입 시 자동으로 7일간의 Pro 회원 혜택이 부여됩니다. 이 기간 동안:

일일 100만건 API 호출 가능
월간 1천만건 API 호출 가능
모든 Pro 기능 사용 가능

7일 후에는 자동으로 일반 회원으로 전환됩니다.

로그인 및 로그아웃

로그인 방법

상단 네비게이션 바에서 "로그인" 버튼을 클릭합니다.
사용자명과 비밀번호를 입력합니다.
"로그인" 버튼을 클릭하여 로그인을 완료합니다.

로그아웃 방법

상단 네비게이션 바에서 사용자명을 클릭합니다.
드롭다운 메뉴에서 "로그아웃"을 선택합니다.

비로그인 사용 제한 안내

비로그인 사용자는 데모 모드에서 한 번에 최대 100건까지만 지오코딩할 수 있습니다. 더 많은 주소를 처리하려면 로그인해주세요.

비밀번호 재설정

로그인 페이지에서 "비밀번호를 잊으셨나요?" 링크를 클릭합니다.
가입 시 사용한 이메일 주소를 입력합니다.
이메일로 받은 링크를 통해 새 비밀번호를 설정합니다.

프로필 관리

프로필 확인 및 수정

로그인 후 프로필 페이지에서 개인 정보를 확인하고 수정할 수 있습니다.

프로필 접근 방법

상단 네비게이션 바에서 사용자명을 클릭합니다.
드롭다운 메뉴에서 "프로필"을 선택합니다.

수정 가능한 정보

이름
이메일 주소
비밀번호

프로필 화면에서 확인 가능한 정보

API 사용 통계
일일/월간 쿼터 사용량
Pro 회원 상태 및 만료일
API 토큰 정보

API 토큰 관리

API 토큰은 지오코더 API를 프로그래밍 방식으로 호출할 때 필요한 인증 수단입니다.

또한, 웹 서비스 사용중에도 적용됩니다.

토큰 발급 및 재발급

프로필 페이지에서 "API 토큰 관리" 섹션으로 이동합니다.
토큰이 없는 경우 "토큰 생성" 버튼을 클릭합니다.
토큰을 재발급하려면 "토큰 재발급" 버튼을 클릭합니다.

토큰을 재발급하면 기존 토큰은 즉시 무효화됩니다. 신중하게 결정하세요.

토큰 보안 팁

토큰은 암호처럼 안전하게 보관하세요.
공개 저장소(GitHub 등)에 토큰을 포함하지 마세요.
토큰 유출이 의심되면 즉시 재발급 받으세요.

API 사용량 확인

프로필 페이지에서 확인 가능한 통계

일일 API 호출 / 일일 쿼터
이번 달 API 호출 수
일일 쿼터 사용 현황 (프로그레스 바)
월별 쿼터 사용 현황 (프로그레스 바)

상세 사용 내역 보기

더 자세한 사용 내역을 보려면 프로필 페이지 하단의 "상세 사용 내역 보기" 버튼을 클릭하세요.

상세 내역에서 확인 가능한 정보:

날짜/시간별 API 호출 내역
엔드포인트별 사용량
성공/실패 건수

계정 삭제

더 이상 서비스를 이용하지 않으려면 계정을 삭제할 수 있습니다.

주의사항

계정 삭제는 되돌릴 수 없으며 모든 데이터가 영구적으로 삭제됩니다.

개인 계정 정보가 삭제됩니다.
API 토큰이 무효화됩니다.
모든 API 사용 기록이 삭제됩니다.

계정 삭제 방법

프로필 페이지에서 페이지 하단으로 스크롤합니다.
"계정 관리" 섹션에서 "회원 탈퇴" 버튼을 클릭합니다.
확인 대화상자에서 비밀번호를 입력하고 삭제 동의를 체크합니다.
"회원 탈퇴" 버튼을 클릭하여 계정 삭제를 완료합니다.

지오코딩 사용하기

주소 찾기

단일 또는 다수의 주소를 지오코딩하여 지도 위치와 좌표를 확인할 수 있습니다.

주소 찾기 사용 방법

데모 페이지에서 좌측 사이드바의 "주소 찾기" 버튼을 클릭합니다.
주소 입력창에 하나 이상의 주소를 입력합니다. (한 줄에 하나씩)
또는 샘플 주소를 선택하여 불러옵니다.
"지오코딩 실행" 버튼을 클릭합니다.

주소 입력 팁

한 번에 최대 3,000개의 주소를 입력할 수 있습니다.
비로그인 사용자는 최대 100건까지만 가능합니다.
가능한 한 상세한 주소를 입력하면 정확도가 높아집니다.

지도 사용하기

지도 기본 기능

확대/축소: 마우스 스크롤 또는 키보드의 +/- 버튼 사용
이동: 드래그하여 지도 이동 또는 키보드의 화살표 버튼 사용
클릭 정보: 지도를 클릭하면 해당 위치의 주소 정보가 팝업으로 표시됩니다.

지오코딩 결과 표시

성공한 주소는 지도 위에 마커로 표시됩니다.
마커를 클릭하면 상세 정보가 팝업으로 나타납니다.
결과 목록에서 항목을 클릭하면 지도에서 해당 위치로 이동합니다.
결과 목록에서 실패한 항목을 클릭하면 상세 정보가 팝업으로 나타납니다.

지도 레이어 변경

우측 상단의 레이어 아이콘을 클릭하여 다음 지도 유형으로 변경할 수 있습니다:

브이월드 일반 지도
브이월드 항공사진 하이브리드
오픈스트리트맵

결과 필터링 및 관리

결과 필터링

좌측 사이드바에서 다음 옵션으로 결과를 필터링할 수 있습니다:

성공: 성공적으로 지오코딩된 주소 표시/숨김
실패: 지오코딩에 실패한 주소 표시/숨김

결과 목록 탐색

목록에서 항목을 클릭하면 해당 위치로 지도가 이동합니다.
선택된 항목은 시각적으로 강조 표시됩니다.
실패한 항목을 클릭하면 실패 원인과 디버깅 정보를 확인할 수 있습니다.

결과 요약

사이드바 하단에서 지오코딩 결과에 대한 요약 통계를 확인할 수 있습니다:

전체 건수
처리 소요 시간

파일 지오코딩

지원 파일 형식

지원되는 파일 형식

CSV (쉼표 등의 문자로 구분된 값)
Excel (.xls, .xlsx)
TXT (텍스트 파일)
TSV (탭으로 구분된 값)

파일 포맷

파일 포맷을 신경쓰지 마세요:

주소 컬럼이 포함된 파일을 업로드하세요. 이게 끝입니다.
주소 정보를 포함하는 컬럼을 자동으로 판단하여, 사용자가 직접 컬럼을 지정할 필요가 없습니다.
CSV 파일의 인코딩을 자동으로 판단하므로, 사용자가 직접 인코딩을 지정할 필요가 없습니다.
CSV 파일의 구분자는 쉼표, 탭, 세미콜론 등 다양하게 지정할 수 있습니다. 파일의 구분자를 자동으로 판단하여, 사용자가 직접 구분자를 지정할 필요가 없습니다.

샘플 파일

처음 사용하시는 경우, 샘플 파일을 다운로드하여 테스트해 보세요:

샘플 CSV 다운로드
샘플 Excel 다운로드

파일 업로드 및 처리

파일 지오코딩 단계

데모 페이지에서 좌측 사이드바의 "파일 지오코딩" 버튼을 클릭합니다.
"파일 선택" 버튼을 클릭하여 지오코딩할 파일을 선택합니다.
출력 좌표계를 선택합니다. (기본값: EPSG:4326)
"지오코딩 실행" 버튼을 클릭합니다.
처리가 완료될 때까지 기다립니다.

파일 처리 제한

일반 회원: 최대 1만건까지 처리 가능
Pro 회원: 대용량 파일 처리 가능
비로그인 사용자: 최대 100건까지만 가능

파일 크기는 10MB를 초과할 수 없습니다.

결과 다운로드

지원되는 다운로드 형식

CSV (UTF-8): 모든 데이터 포함
XLSX: 엑셀 형식으로 모든 데이터 포함
SHP: ESRI 쉐이프파일 (성공한 데이터만)
GeoJSON: 웹 매핑용 표준 형식
KML: Google Earth 등에서 사용 가능
JSON: 개발자용 데이터 형식

다운로드 방법

지오코딩 처리가 완료되면 결과 화면에 다운로드 버튼이 활성화됩니다.
원하는 형식의 다운로드 버튼을 클릭합니다.
또는 좌측 사이드바의 "다운로드" 드롭다운 메뉴에서 원하는 형식을 선택합니다.

SHP 파일은 성공적으로 지오코딩된 데이터만 포함합니다.

컬럼 구성

업로드한 파일의 컬럼이 모두 포함됩니다.
지오코딩 결과 컬럼이 추가됩니다.
추가 컬럼: 성공여부, X좌표, Y좌표, 행정표준 시도 코드, 행정표준 시군구코드, 통계청 시도코드, 통계청 시군구코드, 행정표준 행정동코드, 행정표준 행정동명

SHP 파일은 성공적으로 지오코딩된 데이터만 포함합니다.

Pro 회원 혜택

Pro 회원과 일반 회원 비교

기능	일반 회원	Pro 회원
일일 API 호출 한도	10,000건	1,000,000건
월간 API 호출 한도	100,000건	10,000,000건
파일 지오코딩 제한	최대 1만건	최대 백만건
기술 지원	게시판을 통한 지원	게시판, 이메일, 전화 지원

Pro 시험 기간 및 만료

무료 Pro 시험 기간

신규 회원 가입 시 자동으로 7일간의 Pro 회원 혜택이 제공됩니다.
시험 기간 동안 모든 Pro 기능을 제한 없이 사용할 수 있습니다.
시험 기간은 프로필 페이지에서 확인할 수 있습니다.

유료 Pro 구독 기간

결제일로부터 1년간 Pro 회원 혜택이 제공됩니다.
구독 기간 동안 모든 Pro 기능을 제한 없이 사용할 수 있습니다.
구독 기간은 프로필 페이지에서 확인할 수 있습니다.

만료 시 변경사항

Pro 시험 기간이 종료되면 자동으로 일반 회원으로 전환됩니다.
일일/월간 API 호출 한도가 일반 회원 수준으로 조정됩니다.

Pro 혜택을 계속 이용하시려면 관리자에게 문의하세요.

API 사용법

소개

지오코더 API는 주소를 지리적 좌표로 변환하고, 좌표를 주소로 변환하는 기능을 제공합니다.

이 API를 통해 다음과 같은 기능을 사용할 수 있습니다:

주소 지오코딩 - 주소를 위도/경도 좌표로 변환
역 지오코딩 - 위도/경도 좌표를 주소로 변환
토큰 사용량 통계 확인
행정동 이력 조회

인증

모든 API 요청은 토큰 기반 인증을 사용합니다. 회원 가입시 토큰이 발급됩니다. 내 프로필에서 발급된 토큰을 확인하세요.

토큰은 비밀번호와 같이 안전하게 보관하세요.

토큰을 API 요청 시 전달해야 합니다. 인증되지 않은 요청은 거부됩니다.

예: ?token=YOUR_API_TOKEN

외부 노출 서비스에서 API를 호출할 때는 HTTP 헤더에 Authorization: YOUR_API_TOKEN 형식으로 전달할 수 있습니다.

주소 지오코딩

주소를 지리적 좌표(위도, 경도)로 변환합니다.

GET 지오코딩

GET /geocode

요청 파라미터

파라미터	타입	필수	설명
q	string	예	하나 이상의 주소를 포함하는 문자열. 각 주소는 줄바꿈(\n)으로 구분
token	string	예	API 인증 토큰

요청 예제

GET https://geocode-api.gimi9.com/geocode?q=서울특별시 송파구 송파대로8길 10%0A김제 온천길 37&token=YOUR_API_TOKEN

응답 예제

{
  "total_time": 0.15,
  "total_count": 2,
  "success_count": 2,
  "hd_success_count": 2,
  "fail_count": 0,
  "results": [
    {
      "x": 966445,
      "y": 1949518,
      "z": "05512",
      "hc": "1174064000",
      "lc": "1174010900",
      "rc": "117406103008",
      "bn": "10",
      "h1": "서울특별시",
      "rm": "송파대로8길",
      "bm": ["풍림아이원아파트"],
      "hd_cd": "1174064000",
      "hd_nm": "방이2동",
      "success": true,
      "errmsg": "",
      "h1_cd": "11",
      "h2_cd": "11740",
      "kostat_h1_cd": "11",
      "kostat_h2_cd": "11740",
      "hash": "e93a83cf",
      "address": "서울특별시 송파구 송파대로8길 10",
      "addressCls": "ROAD",
      "toksString": "서울특별시|송파구|송파대로8길|10",
      "x_axis": 127.1146829,
      "y_axis": 37.5138498,
      "inputaddr": "서울특별시 송파구 송파대로8길 10"
    },
    {
      "x": 933939,
      "y": 1769049,
      "z": "54332",
      "hc": "4521054000",
      "lc": "4521054000",
      "rc": "452105304150",
      "bn": "37",
      "h1": "전라북도",
      "rm": "온천길",
      "bm": [],
      "hd_cd": "4521054000",
      "hd_nm": "교월동",
      "success": true,
      "errmsg": "",
      "h1_cd": "45",
      "h2_cd": "45210",
      "kostat_h1_cd": "45",
      "kostat_h2_cd": "45210",
      "hash": "4e7a9e2a",
      "address": "전라북도 김제시 온천길 37",
      "addressCls": "ROAD",
      "toksString": "전라북도|김제시|온천길|37",
      "x_axis": 126.8632492,
      "y_axis": 35.8298487,
      "inputaddr": "김제 온천길 37"
    }
  ]
}

POST 지오코딩

여러 주소를 한 번에 지오코딩할 수 있는 POST 방식의 API입니다.

GET 방식과 동일한 기능을 제공하지만, 요청 본문에 JSON 형식으로 주소 목록을 전달합니다. GET 방식에 비해 더 많은 주소를 한 번에 처리할 수 있습니다.

POST /geocode

요청 파라미터

파라미터	타입	필수	설명
data	object	예	지오코딩할 주소 목록
token	string	예	API 인증 토큰

요청 본문 예제

{
  "q": [
    "서울특별시 송파구 송파대로8길 10",
    "김제 온천길 37",
    "강원 춘천시 남산면 서천리 산111"
  ]
}

응답 형식

GET 지오코딩과 동일한 응답 형식입니다.

응답 필드 설명

필드	타입	설명
total_time	float	총 처리 시간 (초)
total_count	integer	총 요청 주소 개수
success_count	integer	성공한 주소 개수
hd_success_count	integer	성공한 행정동 개수
fail_count	integer	실패한 주소 개수
results	array	지오코딩 결과 목록

결과 객체 필드

필드	타입	설명
x	integer	원본 X 좌표 (EPSG:5179)
y	integer	원본 Y 좌표 (EPSG:5179)
z	string	우편번호
hc	string	행정동 코드
lc	string	법정동 코드
rc	string	도로명 코드
bn	string	건물 번호
h1	string	광역시도명
rm	string	도로명
bm	array	건물명 목록
hd_cd	string	행정동 코드
hd_nm	string	행정동 이름
success	boolean	지오코딩 성공 여부
errmsg	string	오류 메시지
h1_cd	string	광역시도 코드
h2_cd	string	시군구 코드
kostat_h1_cd	string	통계청 광역시도 코드
kostat_h2_cd	string	통계청 시군구 코드
hash	string	해시 값
address	string	전체 주소
addressCls	string	주소 유형
toksString	string	토큰화된 주소
x_axis	float	경도 (EPSG:4326)
y_axis	float	위도 (EPSG:4326)
inputaddr	string	입력 주소

역 지오코딩

지리적 좌표(위도, 경도)를 주소로 변환합니다.

GET /reverse_geocode

요청 파라미터

파라미터	타입	필수	설명
x	float	예	경도 좌표 (EPSG:4326)
y	float	예	위도 좌표 (EPSG:4326)
token	string	예	API 인증 토큰

요청 예제

GET https://geocode-api.gimi9.com/reverse_geocode?x=127.1146829&y=37.5138498&token=YOUR_API_TOKEN

응답 예제

{
  "ADR_MNG_NO": "1174010900110040000",
  "yyyymm": "202306",
  "address": "서울특별시 송파구 송파대로8길 10",
  "success": true,
  "geom": "POINT(127.1146829 37.5138498)",
  "errmsg": ""
}

응답 필드 설명

필드	타입	설명
ADR_MNG_NO	string	주소 관리 번호
yyyymm	string	데이터 기준 년월 (YYYYMM 형식, 예: 202306)
address	string	전체 주소 (도로명 또는 지번)
success	boolean	리버스 지오코딩 성공 여부
geom	string	WKT 형식의 지오메트리 정보 (예: POINT(X Y))
errmsg	string	오류 발생 시 오류 메시지

토큰 통계

API 토큰의 사용량 통계를 조회합니다.

GET /token/stats

요청 파라미터

파라미터	타입	필수	설명
token	string	예	통계를 조회할 API 토큰

요청 예제

GET https://geocode-api.gimi9.com/token/stats?token=YOUR_API_TOKEN

응답 예제

{
{
  "total_requests": 288945,
  "last_month_requests": 949,
  "monthly_quota": 100000000,
  "remaining_quota": 99999051,
  "daily_quota": 10000000,
  "daily_requests": 3,
  "remaining_daily_quota": 9999997,
  "last_request_date": "2025-06-03T09:54:20.450054+09:00"
}

응답 필드 설명

필드	타입	설명
total_requests	integer	총 요청 수
last_month_requests	integer	지난 달 요청 수
monthly_quota	integer	월간 할당량
remaining_quota	integer	남은 월간 할당량
daily_quota	integer	일일 할당량
daily_requests	integer	오늘 요청 수
remaining_daily_quota	integer	남은 일일 할당량
last_request_date	string	마지막 요청 날짜 (ISO 8601 형식)

행정동 이력

좌표 기준으로 행정동 이력 정보를 조회합니다.

GET /hd_history

요청 파라미터

파라미터	타입	필수	설명
x	float	예	경도 좌표 (EPSG:4326)
y	float	예	위도 좌표 (EPSG:4326)
yyyymm	string	아니오	조회할 년월 (YYYYMM 형식, 예: 202306). 지정하지 않으면 전체 이력 조회
token	string	예	API 인증 토큰

요청 예제

GET https://geocode-api.gimi9.com/hd_history?x=127.075074&y=37.143834&token=YOUR_API_TOKEN

응답 예제

[
  {
    "EMD_CD": "4137052300",
    "EMD_KOR_NM": "대원1동",
    "EMD_ENG_NM": "Daewon1(il)-dong",
    "from_yyyymm": "202312",
    "to_yyyymm": "202504"
  },
  {
    "EMD_CD": "4137057000",
    "EMD_KOR_NM": "대원동",
    "EMD_ENG_NM": "Daewon-dong",
    "from_yyyymm": "202305",
    "to_yyyymm": "202311"
  }
]

응답 필드 설명

필드	타입	설명
EMD_CD	string	행정동 코드 (10자리 행정표준 코드)
EMD_KOR_NM	string	행정동 한글 이름 (예: 대원1동)
EMD_ENG_NM	string	행정동 영어 이름 (예: Daewon1(il)-dong)
from_yyyymm	string	시작 년월 (YYYYMM 형식, 예: 202312)
to_yyyymm	string	종료 년월 (YYYYMM 형식, 예: 202504)

API Swagger 문서(온라인 테스트)

RESTful API를 설계, 문서화, 테스트하기 위한 Swagger 기반의 도구를 제공합니다.

온라인 문서 보기

Pandas와 함께 사용하기

2005년 여름에 제공될 예정입니다.

설치 방법

pip를 사용하여 Gimi9 Geocoder를 설치할 수 있습니다:

pip install gimi9-geocoder

기본 라이브러리 사용법

Pandas를 사용하지 않는 기본 사용법은 다음과 같습니다:

import asyncio
from gimi9_geocoder.client import GeocoderClient

async def main():
    # GeocoderClient 초기화
    geocoder = GeocoderClient(token="YOUR_API_TOKEN")
    
    # 주소를 좌표로 변환 (지오코딩)
    result = await geocoder.geocode("서울특별시 강남구 테헤란로 123")
    print(f"지오코딩 결과: {result}")
    
    # 좌표를 주소로 변환 (역지오코딩)
    reverse_result = await geocoder.reverse_geocode(126.98, 37.56)
    print(f"역지오코딩 결과: {reverse_result}")
    
    # 여러 주소 동시에 지오코딩
    addresses = ["서울특별시 강남구 테헤란로 123", 
                "부산광역시 해운대구 해운대해변로 456"]
    batch_result = await geocoder.batch_geocode(addresses)
    print(f"배치 지오코딩 결과: {batch_result}")

# 비동기 함수 실행
asyncio.run(main())

Pandas 통합

Gimi9 Geocoder는 Pandas DataFrame과 쉽게 통합할 수 있습니다:

# Sample DataFrame with addresses
data = {
    "address": [
        "서울특별시 강남구 테헤란로 123",
        "부산광역시 해운대구 해운대해변로 456",
        "대구광역시 중구 동성로 789",
    ]
}

df = pd.DataFrame(data)

# Initialize the Geocoder
geocoder = GeocoderClient(token="DEMO_TOKEN")  # 실제 토큰으로 대체하세요

# Function to geocode addresses in the DataFrame
async def geocode_addresses(df):
    results = []
    for address in df["address"]:
        result = await geocoder.geocode(address)
        results.append(result)
    return results

# Main function to execute the geocoding
async def main():
    # Geocode the addresses and add results to the DataFrame
    df["geocode_results"] = await geocode_addresses(df)
    
    # Display the DataFrame with geocoding results
    print(df)

# Run the main function
asyncio.run(main())

GeocoderClient 클래스

메서드	설명	매개변수	반환 값
`__init__(base_url, token)`	GeocoderClient 인스턴스 초기화	`base_url`: API 기본 URL (기본값: "https://geocode-api.gimi9.com") `token`: API 토큰 (옵션)	GeocoderClient 인스턴스
`async geocode(address)`	주소를 좌표로 변환	`address`: 변환할 주소 문자열	좌표 정보가 포함된 JSON 객체
`async reverse_geocode(x, y)`	좌표를 주소로 변환	`x`: 경도 좌표 `y`: 위도 좌표	주소 정보가 포함된 JSON 객체
`async batch_geocode(addresses)`	여러 주소를 한 번에 좌표로 변환	`addresses`: 주소 문자열 리스트	각 주소의 좌표 정보가 포함된 JSON 객체 리스트

주의: API 호출 시 실제 API 토큰을 사용하세요. 샘플 코드의 "DEMO_TOKEN"은 실제로 작동하지 않습니다.

자주 묻는 질문

API 토큰을 재발급받으면 기존 토큰은 즉시 무효화됩니다. 따라서 기존 토큰을 사용하던 모든 애플리케이션이나 서비스에서 새 토큰으로 업데이트해야 합니다. 토큰 재발급은 토큰이 유출됐을 때 보안을 위해 실시하는 것이 좋습니다.

일일 할당량을 초과하면 해당 날짜에는 더 이상 API 요청이 처리되지 않습니다. "할당량 초과" 오류 메시지가 반환됩니다. 할당량은 매일 자정(한국 시간 기준)에 초기화됩니다. Pro 회원으로 업그레이드하면 더 많은 일일 할당량을 이용할 수 있습니다.

주소 지오코딩이 실패하는 주요 원인:

주소가 불완전하거나 모호함 (예: "서울시 강남구"처럼 상세 주소 없음)
오타나 띄어쓰기 오류
데이터베이스에 없는 최신 건물이나 도로명
비표준 주소 형식 사용
존재하지 않는 주소 입력

정확도를 높이려면 상세한 주소를 입력하고 공식 도로명주소 형식을 사용하세요.

Pro 회원 신청은 현재 관리자를 통해서만 가능합니다. 문의하기 페이지나 이메일을 통해 Pro 회원 신청을 요청하세요. 요청 시 예상 사용량과 용도를 함께 알려주시면 빠른 처리에 도움이 됩니다. 관리자 검토 후 Pro 상태로 업그레이드해 드립니다.

지오코더는 다양한 좌표계를 지원합니다:

EPSG:4326 (WGS84, GPS 경위도)
EPSG:5174 (한국 중부원점)
EPSG:5178 (UTM-K/Bessel)
EPSG:5179 (UTM-K/GRS80)
EPSG:5181 (카카오맵 좌표계)
EPSG:5186 (한국 2000 중부원점)
KATECH (국가교통DB 좌표계)

파일 지오코딩 시 원하는 좌표계를 선택할 수 있습니다.

하루에 1만건까지 사용할 수 있습니다. 그 이상 필요하면 프로버전(유료)을 사용하세요. 구입 문의: gisman@gmail.com

매일 데이터를 업데이트 합니다. 리버스 지오코딩과 행정동 이력은 월 1회 업데이트합니다.
오픈소스용 다운로드 파일은 1년에 한 번 배포합니다.

지오코딩은 주소정보 누리집의 여러 공공데이터를 사용합니다.

리버스 지오코딩은 브이월드의 연속지적도와 건물도형 공공데이터를 사용합니다.

지오코딩은 초당 5천 건, 시간당 1천5백만 건 이상을 처리하며, 리버스 지오코딩 속도 또한 유사합니다.

엔터프라이즈 서버는 여러개의 노드를 구성하여 처리 속도를 더 높일 수 있습니다.

최저 사양: AWS EC2 t2.micro (1 vCPU, 1GiB 메모리)

저장 공간: 약 25GB 필요합니다. 무중단 업데이트를 위해서는 두 배인 50GB의 저장 공간이 필요합니다.

오픈소스 기여

기여를 환영합니다! GitHub 저장소를 포크하고 풀 리퀘스트를 보내주세요. 버그 리포트, 기능 제안, 문서 개선 등 모든 종류의 기여를 환영합니다.

지오코딩이 안 되는 주소가 있으면 알려주세요.

다음과 같은 경우 오픈소스 버전을 자유롭게 사용할 수 있습니다:

개인적 사용: 개인이 비영리 목적으로 소프트웨어를 사용하는 경우
교육 목적: 학교, 대학 등 교육 기관에서 학습 및 연구 목적으로 사용하는 경우
비영리 단체: 자선 단체나 NGO 등이 그들의 미션을 수행하기 위해 사용하는 경우
오픈소스 프로젝트: 다른 비상업적 오픈소스 프로젝트에서 해당 솔루션을 활용하는 경우
정부 기관: 공공 서비스 제공을 위해 정부 기관에서 사용하는 경우
학술 연구: 대학이나 연구소에서 순수 학술 목적으로 사용하는 경우

지원 및 문의

문제가 발생하거나 질문이 있으시면 GitHub Discussions를 통해 문의해 주세요.

빠르게 답을 얻으려면 카톡 오픈채팅으로 문의해주세요.

목차

지오코더 설명서

특징

웹 서비스 사용법

계정 관리

회원가입

회원가입 절차

Pro 혜택 안내

로그인 및 로그아웃

로그인 방법

로그아웃 방법

비로그인 사용 제한 안내

비밀번호 재설정

프로필 관리

프로필 확인 및 수정

프로필 접근 방법

수정 가능한 정보

프로필 화면에서 확인 가능한 정보

API 토큰 관리

토큰 발급 및 재발급

토큰 보안 팁

API 사용량 확인

프로필 페이지에서 확인 가능한 통계

상세 사용 내역 보기

계정 삭제

주의사항

계정 삭제 방법

지오코딩 사용하기

주소 찾기

주소 찾기 사용 방법

주소 입력 팁

지도 사용하기

지도 기본 기능

지오코딩 결과 표시

지도 레이어 변경

결과 필터링 및 관리

결과 필터링

결과 목록 탐색

결과 요약

파일 지오코딩

지원 파일 형식

지원되는 파일 형식

파일 포맷

샘플 파일

파일 업로드 및 처리

파일 지오코딩 단계

파일 처리 제한

결과 다운로드

지원되는 다운로드 형식

다운로드 방법

컬럼 구성

Pro 회원 혜택

Pro 회원과 일반 회원 비교

Pro 시험 기간 및 만료

무료 Pro 시험 기간

유료 Pro 구독 기간

만료 시 변경사항

API 사용법

소개

인증

주소 지오코딩

GET 지오코딩

요청 파라미터

요청 예제

응답 예제

POST 지오코딩

요청 파라미터

요청 본문 예제

응답 형식

응답 필드 설명

결과 객체 필드

역 지오코딩

요청 파라미터

요청 예제

응답 예제

응답 필드 설명

토큰 통계

요청 파라미터

요청 예제

응답 예제