Geolocate an IP address using Web Services

// Install via NuGet
Install-Package MaxMind.GeoIP2

// Install via Maven, recommended
<dependency>
  <groupId>com.maxmind.geoip2</groupId>
  <artifactId>geoip2</artifactId>
  <version>5.0.2</version>
</dependency>

// Or install via Gradle
repositories {
  mavenCentral()
}
dependencies {
  implementation 'com.maxmind.geoip2:geoip2:5.0.2'
}

// Install via npm
npm install @maxmind/geoip2-node

// Or install via yarn
yarn add @maxmind/geoip2-node

# Install via Composer
composer require geoip2/geoip2:~3.0

# Install via pip
pip install geoip2

# Install as a gem
gem install maxmind-geoip2

# Or add this to your Gemfile
gem 'maxmind-geoip2'

int accountId = 10;
string licenseKey = "LICENSEKEY";

var client = new WebServiceClient(accountId, licenseKey);

// To query the GeoLite web service, you must set the optional `host` parameter
// to `geolite.info`
var client = new WebServiceClient(accountId, licenseKey, host: "geolite.info");

int accountId = 10;
String licenseKey = "LICENSEKEY";

WebServiceClient client = new WebServiceClient.Builder(accountId, licenseKey).build();

// To query the GeoLite web service, you must call the `host` method on the
// builder with "geolite.info"
WebServiceClient client = new WebServiceClient.Builder(accountId, licenseKey)
    .host("geolite.info").build();

const WebServiceClient = require('@maxmind/geoip2-node').WebServiceClient;
// TypeScript:
// import { WebServiceClient } from '@maxmind/geoip2-node';

const accountId = '10';
const licenseKey = 'LICENSEKEY';

const client = new WebServiceClient(accountId, licenseKey);

// To query the GeoLite web service, you must set the optional `host` parameter
const client = new WebServiceClient(accountId, licenseKey, {
  host: 'geolite.info',
});

<?php
require_once 'vendor/autoload.php';
use GeoIp2\WebService\Client;

$accountId = 10;
$licenseKey = 'LICENSEKEY';

$client = new Client($accountId, $licenseKey);

// To query the GeoLite web service, you must set the optional `host` argument.
// The third argument specifies the language preferences when using the `->name`
// method on the model classes that this client creates.
$client = new Client($accountId, $licenseKey, ['en'], ['host' => 'geolite.info']);

from geoip2.webservice import Client, AsyncClient

account_id = 10
license_key = 'LICENSEKEY'

# If you want to use synchronous requests
client = Client(account_id, license_key)

# To query the GeoLite web service, you must set the "host" keyword argument
# to "geolite.info"
client = Client(account_id, license_key, host='geolite.info')

# Or if you want to use asynchronous requests (requires `import asyncio`)
async_client = AsyncClient(account_id, license_key)

# To query the GeoLite web service, you must set the "host" keyword argument
# to "geolite.info"
async_client = AsyncClient(account_id, license_key, host='geolite.info')

require 'maxmind/geoip2'

client = MaxMind::GeoIP2::Client.new(
  account_id: 10,
  license_key: 'LICENSEKEY',

  # To use the GeoLite web service instead of GeoIP, set the host
  # parameter to "geolite.info", eg:
  # host: 'geolite.info',
)

// If you are making multiple requests, a single WebServiceClient
// should be shared across requests to allow connection reuse. The
// class is thread safe.

int accountId = 10;
string licenseKey = "LICENSEKEY";

// Sync
using (var client = new WebServiceClient(accountId, licenseKey))
{
    // You can also use `client.City` or `client.Insights`
    // `client.Insights` is not available to GeoLite users
    var response = client.Country("128.101.101.101");

    Console.WriteLine(response.Country.IsoCode);        // 'US'
    Console.WriteLine(response.Country.Name);           // 'United States'
    Console.WriteLine(response.Country.Names["zh-CN"]); // '美国'
}

// Async
using (var client = new WebServiceClient(accountId, licenseKey))
{
    // You can also use `client.CityAsync` or `client.InsightsAsync`
    // `client.InsightsAsync` is not available to GeoLite users
    var response = await client.CountryAsync("128.101.101.101");

    Console.WriteLine(response.Country.IsoCode);        // 'US'
    Console.WriteLine(response.Country.Name);           // 'United States'
    Console.WriteLine(response.Country.Names["zh-CN"]); // '美国'
}

int accountId = 10;
String licenseKey = "LICENSEKEY";

try (WebServiceClient client = new WebServiceClient.Builder(accountId, licenseKey)
        .build()) {

    InetAddress ipAddress = InetAddress.getByName("128.101.101.101");

    // You can also use `client.city` or `client.insights`
    // `client.insights` is not available to GeoLite users
    CountryResponse response = client.country(ipAddress);

    Country country = response.country();
    System.out.println(country.isoCode());            // 'US'
    System.out.println(country.name());               // 'United States'
    System.out.println(country.names().get("zh-CN")); // '美国'
}

const WebServiceClient = require('@maxmind/geoip2-node').WebServiceClient;
// Typescript:
// import { WebServiceClient } from '@maxmind/geoip2-node';

const accountId = '10';
const licenseKey = 'LICENSEKEY';

const client = new WebServiceClient(accountId, licenseKey);

// You can also use `client.city` or `client.insights`
// `client.insights` is not available to GeoLite users
client.country('142.1.1.1').then((response) => {
  console.log(response.country.isoCode); // 'CA'
});

<?php
require_once 'vendor/autoload.php';
use GeoIp2\WebService\Client;

$accountId = 10;
$licenseKey = 'LICENSEKEY';

$client = new Client($accountId, $licenseKey);

// You can also use `$client->city` or `$client->insights`
// `$client->insights` is not available to GeoLite users
$record = $client->country('128.101.101.101');

print($record->country->isoCode . "\n");

# Sync
from geoip2.webservice import Client

account_id = 10
license_key = 'LICENSEKEY'

with Client(account_id, license_key) as client:
  # You can also use `client.city` or `client.insights`
  # `client.insights` is not available to GeoLite users
  response = client.country('128.101.101.101')

  print(response.country.iso_code)

# Async
import asyncio
from geoip2.webservice import AsyncClient

async def main():
  async with AsyncClient(account_id, license_key) as client:
    # You can also use `client.city` or `client.insights`
    # `client.insights` is not available to GeoLite users
    response = await client.country('128.101.101.101')

    print(response.country.iso_code)

asyncio.run(main())

require 'maxmind/geoip2'

client = MaxMind::GeoIP2::Client.new(
  account_id: 10,
  license_key: 'LICENSEKEY',
)

# You can also use `client.city` or `client.insights`.
# Note that `client.insights` is not available to GeoLite users.
record = client.country('128.101.101.101')

puts record.country.iso_code