CkJava Requires Chilkat v11.0.0+
CkJava
Look up an IP location with the ipify v2 API
See more Geolocation Examples
Use the ipify IP Geolocation v2 country,city endpoint with an API key. This endpoint returns country and city details, including coordinates when available, and currently costs two credits per request. The country endpoint has a smaller result and costs one credit.
The example explicitly supplies the target IPv4 or IPv6 address and URL-encodes the query parameters. location.timezone is a UTC offset. This replaces the older v1 request used by this example.
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.
Chilkat CkJava Downloads
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");
CkJsonObject parameters = new CkJsonObject();
parameters.UpdateString("apiKey","YOUR_API_KEY");
parameters.UpdateString("ipAddress",ipAddress);
CkHttpResponse response = new CkHttpResponse();
success = http.HttpParams("GET","https://geo.ipify.org/api/v2/country,city",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("messages") == 1) {
System.out.println(json.stringOf("messages"));
}
if (json.JsonTypeOf("message") == 1) {
System.out.println(json.stringOf("message"));
}
}
return;
}
if (parsed != true) {
System.out.println("Expected a JSON object in the lookup response.");
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("location.country") == 1) && (json.StringOfEquals("location.country","",true) != true)) {
System.out.println("Country code: " + json.stringOf("location.country"));
}
else {
System.out.println("Country code: unavailable");
}
if ((json.JsonTypeOf("location.region") == 1) && (json.StringOfEquals("location.region","",true) != true)) {
System.out.println("Region: " + json.stringOf("location.region"));
}
else {
System.out.println("Region: unavailable");
}
if ((json.JsonTypeOf("location.city") == 1) && (json.StringOfEquals("location.city","",true) != true)) {
System.out.println("City: " + json.stringOf("location.city"));
}
else {
System.out.println("City: unavailable");
}
if ((json.JsonTypeOf("location.timezone") == 1) && (json.StringOfEquals("location.timezone","",true) != true)) {
System.out.println("UTC offset: " + json.stringOf("location.timezone"));
}
else {
System.out.println("UTC offset: unavailable");
}
// Missing coordinates stay unavailable. A numeric zero is a valid coordinate.
if ((json.JsonTypeOf("location.lat") == 2) && (json.JsonTypeOf("location.lng") == 2)) {
System.out.println("Coordinates: " + json.stringOf("location.lat") + ", " + json.stringOf("location.lng"));
}
else {
System.out.println("Coordinates: unavailable");
}
}
}