C++ Requires Chilkat v11.0.0+
C++
Look up an IP address with the ip-api free endpoint
See more Geolocation Examples
This example uses the free, keyless ip-api endpoint for non-commercial use. The free service supports HTTP and is limited to 45 requests per minute per source IP. Its Pro service provides HTTPS and commercial use. ip-api Pro.
Always include status and message when selecting fields. Invalid or private addresses can produce status=fail inside a JSON response. Retain the X-Rl and X-Ttl response values between calls, and pause further requests when X-Rl reaches zero.
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 C++ Downloads
#include <CkHttp.h>
#include <CkStringBuilder.h>
#include <CkJsonObject.h>
#include <CkHttpResponse.h>
void ChilkatSample(void)
{
bool success = false;
// Assumes Chilkat is unlocked. See Global Unlock Sample.
// Use a public IP address. Provider results can change as their databases are updated.
const char *ipAddress = "8.8.8.8";
CkHttp http;
http.put_RequireSslCertVerify(true);
http.put_ConnectTimeout(10);
http.put_ReadTimeout(30);
http.put_Accept("application/json");
// The free endpoint is HTTP-only. This single lookup sends no API credentials.
CkStringBuilder url;
url.Append("http://ip-api.com/json/");
url.Append(http.urlEncode(ipAddress));
CkJsonObject parameters;
parameters.UpdateString("fields","status,message,query,country,countryCode,regionName,city,lat,lon,timezone");
CkHttpResponse response;
success = http.HttpParams("GET",url.getAsString(),parameters,response);
if (response.get_StatusCode() == 0) {
// Request diagnostics can contain an API key. Report transport failure without logging credentials.
std::cout << "No HTTP response. Check connectivity, DNS, and TLS configuration." << "\r\n";
return;
}
// Save these values if the application will make further requests.
const char *remaining = response.getHeaderField("X-Rl");
if (remaining == "0") {
std::cout << "Rate limit reached. Wait " << response.getHeaderField("X-Ttl") << " seconds before the next request." << "\r\n";
}
CkJsonObject json;
bool parsed = json.Load(response.bodyStr());
if ((success != true) || (response.get_StatusCode() < 200) || (response.get_StatusCode() >= 300)) {
std::cout << "Lookup failed. HTTP " << response.get_StatusCode() << "\r\n";
if (parsed == true) {
if (json.JsonTypeOf("message") == 1) {
std::cout << json.stringOf("message") << "\r\n";
}
}
return;
}
if (parsed != true) {
std::cout << "Expected a JSON object in the lookup response." << "\r\n";
return;
}
if (json.StringOfEquals("status","success",true) != true) {
std::cout << "The service could not complete the lookup." << "\r\n";
if (json.JsonTypeOf("message") == 1) {
std::cout << json.stringOf("message") << "\r\n";
}
return;
}
if ((json.JsonTypeOf("query") != 1) || (json.StringOfEquals("query","",true) == true)) {
std::cout << "The response did not contain the expected IP address." << "\r\n";
return;
}
std::cout << "IP address: " << json.stringOf("query") << "\r\n";
if ((json.JsonTypeOf("country") == 1) && (json.StringOfEquals("country","",true) != true)) {
std::cout << "Country: " << json.stringOf("country") << "\r\n";
}
else {
std::cout << "Country: unavailable" << "\r\n";
}
if ((json.JsonTypeOf("countryCode") == 1) && (json.StringOfEquals("countryCode","",true) != true)) {
std::cout << "Country code: " << json.stringOf("countryCode") << "\r\n";
}
else {
std::cout << "Country code: unavailable" << "\r\n";
}
if ((json.JsonTypeOf("regionName") == 1) && (json.StringOfEquals("regionName","",true) != true)) {
std::cout << "Region: " << json.stringOf("regionName") << "\r\n";
}
else {
std::cout << "Region: unavailable" << "\r\n";
}
if ((json.JsonTypeOf("city") == 1) && (json.StringOfEquals("city","",true) != true)) {
std::cout << "City: " << json.stringOf("city") << "\r\n";
}
else {
std::cout << "City: unavailable" << "\r\n";
}
if ((json.JsonTypeOf("timezone") == 1) && (json.StringOfEquals("timezone","",true) != true)) {
std::cout << "Time zone: " << json.stringOf("timezone") << "\r\n";
}
else {
std::cout << "Time zone: unavailable" << "\r\n";
}
// Missing coordinates stay unavailable. A numeric zero is a valid coordinate.
if ((json.JsonTypeOf("lat") == 2) && (json.JsonTypeOf("lon") == 2)) {
std::cout << "Coordinates: " << json.stringOf("lat") << ", " << json.stringOf("lon") << "\r\n";
}
else {
std::cout << "Coordinates: unavailable" << "\r\n";
}
}