Sample code for 30+ languages & platforms
CkJava Requires Chilkat v11.0.0+

Look up an IP location with IPinfo Core

See more Geolocation Examples

Use an IPinfo token with Core, Plus, or Max access. The current api.ipinfo.io/lookup/ endpoint returns location fields inside geo and network fields inside as. Authenticate with a Bearer token.

IPinfo continues to support its older ipinfo.io API for existing integrations. This example uses the current Core response structure. The free Lite API uses /lite/ and a different, country-level response. Choose the endpoint and parser for your subscription.

IP geolocation estimates a network location. VPNs, mobile gateways, and anycast routing can affect the result. City and coordinate fields can be missing or approximate. The sample address 8.8.8.8 is a public DNS address used to demonstrate the request.

Service documentation

Chilkat CkJava Downloads

CkJava
import com.chilkatsoft.*;

public class ChilkatExample {

  static {
    try {
        System.loadLibrary("chilkat");
    } catch (UnsatisfiedLinkError e) {
      System.err.println("Native code library failed to load.\n" + e);
      System.exit(1);
    }
  }

  public static void main(String argv[])
  {
    boolean success = false;

    //  Assumes Chilkat is unlocked. See Global Unlock Sample.
    //  Use a public IP address. Provider results can change as their databases are updated.
    String ipAddress = "8.8.8.8";
    CkHttp http = new CkHttp();
    http.put_RequireSslCertVerify(true);
    http.put_ConnectTimeout(10);
    http.put_ReadTimeout(30);
    http.put_Accept("application/json");
    http.put_AuthToken("IPINFO_TOKEN");
    CkStringBuilder url = new CkStringBuilder();
    url.Append("https://api.ipinfo.io/lookup/");
    url.Append(http.urlEncode(ipAddress));
    CkHttpResponse response = new CkHttpResponse();
    success = http.HttpNoBody("GET",url.getAsString(),response);
    if (response.get_StatusCode() == 0) {
        //  Request diagnostics can contain an API key. Report transport failure without logging credentials.
        System.out.println("No HTTP response. Check connectivity, DNS, and TLS configuration.");
        return;
        }

    CkJsonObject json = new CkJsonObject();
    boolean parsed = json.Load(response.bodyStr());
    if ((success != true) || (response.get_StatusCode() < 200) || (response.get_StatusCode() >= 300)) {
        System.out.println("Lookup failed. HTTP " + response.get_StatusCode());
        if (parsed == true) {
            if (json.JsonTypeOf("error.title") == 1) {
                System.out.println(json.stringOf("error.title"));
                }

            if (json.JsonTypeOf("error.message") == 1) {
                System.out.println(json.stringOf("error.message"));
                }

            }

        return;
        }

    if (parsed != true) {
        System.out.println("Expected a JSON object in the lookup response.");
        return;
        }

    if ((json.JsonTypeOf("error") == 3)) {
        System.out.println("The service could not complete the lookup.");
        if (json.JsonTypeOf("error.title") == 1) {
            System.out.println(json.stringOf("error.title"));
            }

        if (json.JsonTypeOf("error.message") == 1) {
            System.out.println(json.stringOf("error.message"));
            }

        return;
        }

    if ((json.JsonTypeOf("bogon") == 5) && (json.BoolOf("bogon") == true)) {
        System.out.println("This is a reserved or otherwise non-public IP address.");
        return;
        }

    if ((json.JsonTypeOf("ip") != 1) || (json.StringOfEquals("ip","",true) == true)) {
        System.out.println("The response did not contain the expected IP address.");
        return;
        }

    System.out.println("IP address: " + json.stringOf("ip"));
    if ((json.JsonTypeOf("geo.country") == 1) && (json.StringOfEquals("geo.country","",true) != true)) {
        System.out.println("Country: " + json.stringOf("geo.country"));
        }
    else {
        System.out.println("Country: unavailable");
        }

    if ((json.JsonTypeOf("geo.country_code") == 1) && (json.StringOfEquals("geo.country_code","",true) != true)) {
        System.out.println("Country code: " + json.stringOf("geo.country_code"));
        }
    else {
        System.out.println("Country code: unavailable");
        }

    if ((json.JsonTypeOf("geo.region") == 1) && (json.StringOfEquals("geo.region","",true) != true)) {
        System.out.println("Region: " + json.stringOf("geo.region"));
        }
    else {
        System.out.println("Region: unavailable");
        }

    if ((json.JsonTypeOf("geo.city") == 1) && (json.StringOfEquals("geo.city","",true) != true)) {
        System.out.println("City: " + json.stringOf("geo.city"));
        }
    else {
        System.out.println("City: unavailable");
        }

    if ((json.JsonTypeOf("geo.timezone") == 1) && (json.StringOfEquals("geo.timezone","",true) != true)) {
        System.out.println("Time zone: " + json.stringOf("geo.timezone"));
        }
    else {
        System.out.println("Time zone: unavailable");
        }

    //  Missing coordinates stay unavailable. A numeric zero is a valid coordinate.
    if ((json.JsonTypeOf("geo.latitude") == 2) && (json.JsonTypeOf("geo.longitude") == 2)) {
        System.out.println("Coordinates: " + json.stringOf("geo.latitude") + ", " + json.stringOf("geo.longitude"));
        }
    else {
        System.out.println("Coordinates: unavailable");
        }

    if ((json.JsonTypeOf("as.asn") == 1) && (json.StringOfEquals("as.asn","",true) != true)) {
        System.out.println("ASN: " + json.stringOf("as.asn"));
        }
    else {
        System.out.println("ASN: unavailable");
        }

    if ((json.JsonTypeOf("as.name") == 1) && (json.StringOfEquals("as.name","",true) != true)) {
        System.out.println("Network organization: " + json.stringOf("as.name"));
        }
    else {
        System.out.println("Network organization: unavailable");
        }
  }
}