IP 주소 기반 위치 조회 라이브러리 (geoip-lite)
KUKJIN LEE • 2주 전 작성
geoip-lite
를 사용하면 IP 주소로부터 국가, 도시, 위도, 경도 등 위치 정보를 빠르게 조회할 수 있습니다.
설치 방법
npm install geoip-lite
사용법
// 모듈 불러오기
const geoip = require('geoip-lite');
// IP 주소로 위치 정보 조회
const ip = '207.97.227.239';
const geo = geoip.lookup(ip);
// 조회 결과 출력
if (geo) {
console.log('Country:', geo.country); // 국가 코드 (예: 'US')
console.log('Region:', geo.region); // 지역 코드 (예: 'CA')
console.log('City:', geo.city); // 도시 이름 (예: 'San Francisco')
console.log('Latitude:', geo.ll[0]); // 위도
console.log('Longitude:', geo.ll[1]); // 경도
}
주요 함수
geoip-lite
모듈의 주요 함수는 다음과 같습니다:
-
lookup(ip)
: 주어진 IP 주소로부터 위치 데이터를 조회합니다.-
매개변수:
ip
(문자열 형식의 IP 주소) -
반환 값: 객체 형식의 위치 데이터 또는
null
-
반환 데이터 예시
lookup()
함수가 반환하는 위치 데이터는 다음과 같은 구조입니다.
{
"range": [3479299040, 3479299071],
"country": "US",
"region": "CA",
"eu": "0",
"timezone": "America/Los_Angeles",
"city": "San Francisco",
"ll": [37.7697, -122.3933],
"metro": 807,
"area": 1000
}
-
range
: IP 주소 범위 -
country
: 국가 코드 (ISO 3166-1 alpha-2 형식) -
region
: 지역 코드 -
timezone
: 타임존 정보 -
city
: 도시 이름 -
ll
: [위도, 경도] 배열 -
metro
: 대도시 코드 (미국만 해당) -
area
: 지역 번호
주의사항
-
geoip-lite
는 정적 데이터베이스를 사용하므로 최신 IP 위치 정보로 업데이트되지 않을 수 있습니다. -
이 모듈은 IP 주소만을 기반으로 위치를 추정하므로 100% 정확한 위치 정보를 제공하지 않을 수 있습니다.
요약
-
geoip-lite
는 IP 주소 기반의 간단한 위치 조회 기능을 제공합니다. -
설치 후
lookup(ip)
메서드를 사용하여 국가, 지역, 도시 등의 위치 데이터를 조회할 수 있습니다. -
데이터는 정적이며 주기적으로 업데이트할 필요가 있습니다.
이와 같이 geoip-lite
를 사용하여 간편하게 IP 주소로 위치 정보를 조회할 수 있습니다.