SplatDev.GeoLocation 1.0.2

SplatDev.GeoLocation

IP geolocation for .NET applications — resolves IP addresses to city, region, country, coordinates, ISP organization, postal code, and timezone via the ipinfo.io API.

Compatibility

Installation

dotnet add package SplatDev.GeoLocation

Configuration

Basic usage

using SplatDev.GeoLocation;

// Resolve the caller's IP (or provide a specific one)
var result = await GeoLocator.GetIpInfoGeoLocation();
Console.WriteLine($"City: {result.City}, Country: {result.Country}");

Usage

Look up a specific IP address

using SplatDev.GeoLocation;

var result = await GeoLocator.GetIpInfoGeoLocation("8.8.8.8");

Console.WriteLine($"IP:        {result.Ip}");
Console.WriteLine($"Hostname:  {result.Hostname}");
Console.WriteLine($"City:      {result.City}");
Console.WriteLine($"Region:    {result.Region}");
Console.WriteLine($"Country:   {result.Country}");
Console.WriteLine($"Location:  {result.Loc}");
Console.WriteLine($"Org:       {result.Org}");
Console.WriteLine($"Postal:    {result.Postal}");
Console.WriteLine($"Timezone:  {result.Timezone}");

With an API token

using SplatDev.GeoLocation;

// For higher rate limits (50k req/month with free tier token)
var result = await GeoLocator.GetIpInfoGeoLocation(
    ip: "1.1.1.1",
    apiToken: "your-ipinfo-token");

Console.WriteLine($"ISP: {result.Org}");

Register as a service

// Program.cs
builder.Services.AddSingleton<GeoLocator>();

// In a controller
public class LocationController : Controller
{
    private readonly GeoLocator _geoLocator;

    public LocationController(GeoLocator geoLocator)
    {
        _geoLocator = geoLocator;
    }

    public async Task<IActionResult> Index()
    {
        var location = await _geoLocator.GetIpInfoGeoLocation();
        return Json(location);
    }
}

Batch IP resolution

using SplatDev.GeoLocation;

var ips = new[] { "8.8.8.8", "1.1.1.1", "208.67.222.222" };

foreach (var ip in ips)
{
    var result = await GeoLocator.GetIpInfoGeoLocation(ip);
    Console.WriteLine($"{ip} → {result.City}, {result.Country} ({result.Org})");
}

Features

• Resolve IP addresses to city, region, country, geographic coordinates, organization, postal code, and timezone
• Auto-detects the caller's public IP when no IP is specified
• Optional ipinfo.io API token for higher rate limits (free tier: 50k requests/month)
• Uses RestSharp for reliable HTTP communication
• Structured response via GeoLocationResult with strongly-typed properties
• Loc field returns "latitude,longitude" format ready for mapping or distance calculations
• Lightweight — single dependency on RestSharp
• No database or local file required — pure API-based resolution

GeoLocationResult Properties

Dependencies

No other NuGet dependencies.

SplatDev.GeoLocation — part of the SplatDev.Umbraco.Plugins suite. Licensed under MIT. © SplatDev Ltda.

Changelog

1.0.2 — 2026-08-24

Removes a dashboard screenshot that showed an error toast. It was captured against a site where this plugin's API was unreachable, so it advertised a broken dashboard. No screenshot is better than a misleading one; a replacement will be taken against a working install.

1.0.1 — 2026-08-24

Package metadata only: the listing now carries an icon and search tags, and the project and repository links point at the organisation that actually hosts this code. No code changes.

1.0.0 — 2026-08-24

This package now keeps a changelog. Earlier releases predate it and are not reconstructed here — consult the repository history for those. From this version on, every release records what changed for someone using it.