IP 주소 기반 위치 조회 라이브러리 (geoip-lite)

KUKJIN LEE's profile picture

KUKJIN LEE1개월 전 작성

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 주소로 위치 정보를 조회할 수 있습니다.

geoip lite

 

New Tech Posts