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

Look up an IP address with IP2Location.io

See more Geolocation Examples

Look up a public IPv4 or IPv6 address. The sample runs keyless. To use your account allowance, set apiKey and Chilkat will send it as a Bearer token. IP2Location.io recommends header authentication and also accepts its older key query parameter.

Keyless requests have a daily allowance. Registered plans have their own quotas and field availability. Check the provider’s current limits. An HTTP 401 with error 10000 can indicate an invalid key or an exhausted free allowance. Coordinates can default to the capital city when a city is unknown. The returned time_zone is a UTC offset.

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");
    //  Leave empty for keyless evaluation, or set the API key from your account.
    String apiKey = "";
    if (apiKey != "") {
        http.put_AuthToken(apiKey);
        }

    CkJsonObject parameters = new CkJsonObject();
    parameters.UpdateString("ip",ipAddress);
    parameters.UpdateString("format","json");
    CkHttpResponse response = new CkHttpResponse();
    success = http.HttpParams("GET","https://api.ip2location.io/",parameters,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.error_message") == 1) {
                System.out.println(json.stringOf("error.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.error_message") == 1) {
            System.out.println(json.stringOf("error.error_message"));
            }

        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("country_name") == 1) && (json.StringOfEquals("country_name","",true) != true)) {
        System.out.println("Country: " + json.stringOf("country_name"));
        }
    else {
        System.out.println("Country: unavailable");
        }

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

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

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

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

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