Usage

Basic Example

using net3000.IpInfo;

// Initialize the service with default database path
using var ipService = new Service();

// Get complete location details
var location = ipService.GetLocationByIp("8.8.8.8");
if (location != null)
{
    Console.WriteLine($"Country: {location.CountryName} ({location.Country})");
    Console.WriteLine($"City: {location.City}");
    Console.WriteLine($"Coordinates: {location.Latitude}, {location.Longitude}");
}

// Get just country code
var country = ipService.GetCountryByIp("8.8.8.8");

// Get city and country info
var cityCountry = ipService.GetCityCountryByIp("8.8.8.8");

Custom Database Path

// Use a custom database file path
using var ipService = new Service("path/to/your/database.mmdb");

Check for Local IPs

// Check if an IP is local/private
bool isLocal = Service.IsLocalIp("192.168.1.1"); // Returns true
bool isPublic = Service.IsLocalIp("8.8.8.8");    // Returns false

Database

This library uses the IP2Location LITE database (MMDB format) which is provided free of charge. The database file (IP2LOCATION-LITE-DB9.MMDB) should be included in your project and copied to the output directory.

Note: The IP2Location LITE edition has accuracy up to Class C (192.168.1.X) only. For higher accuracy, you can acquire commercial editions from IP2Location.com.

Dependencies

• MaxMind.GeoIP2 (v5.4.1) - MaxMind GeoIP2 library for reading MMDB database files

License

This library is proprietary to Net3000. The IP2Location LITE database is provided under the IP2Location LITE license terms. See LICENSE.md for details.

IP2Location Attribution

This library uses the IP2Location LITE database for IP geolocation. All sites, advertising materials, and documentation mentioning features or the use of this database must display the following acknowledgment:

"[Your site name or product name] uses the IP2Location LITE database for IP geolocation."