IP Geolocation Best Practices

Multi-Layer Geolocation Architecture

Implementation Code Example

// Production-ready IP geolocation implementation
class IpGeolocator {
  constructor(apiKey) {
    this.apiKey = apiKey;
    this.cache = new Map();
    this.rateLimit = new RateLimit(100, 60000); // 100 requests per minute
  }

  async geolocateIp(ipAddress, options = {}) {
    try {
      // Step 1: Basic IP format validation
      if (!this.isValidIpFormat(ipAddress)) {
        return { valid: false, reason: 'Invalid IP format', confidence: 1.0 };
      }

      // Step 2: Check cache
      const cached = this.cache.get(ipAddress);
      if (cached && !this.isCacheExpired(cached)) {
        return cached.result;
      }

      // Step 3: Rate limiting
      if (!this.rateLimit.check()) {
        throw new Error('Rate limit exceeded');
      }

      // Step 4: API geolocation with retry logic
      const result = await this.apiGeolocation(ipAddress, options);

      // Step 5: Cache result
      this.cache.set(ipAddress, {
        result,
        timestamp: Date.now(),
        ttl: options.cacheTTL || 3600000 // 1 hour default
      });

      return result;

    } catch (error) {
      return this.handleError(error, ipAddress);
    }
  }

  async apiGeolocation(ipAddress, options) {
    const response = await fetch(`https://api.ip-info.app/v1-get-ip-details?ip=${ipAddress}`, {
      method: 'GET',
      headers: {
        'accept': 'application/json',
        'x-api-key': this.apiKey
      }
    });

    if (!response.ok) {
      throw new Error(`API error: ${response.status}`);
    }

    return await response.json();
  }

  handleError(error, ipAddress) {
    console.error('IP geolocation error:', error);

    // Graceful degradation - fall back to basic location
    return {
      valid: this.isValidIpSyntax(ipAddress),
      reason: 'API unavailable - basic IP parsing only',
      confidence: 0.5,
      error: error.message
    };
  }
}