Unicode C++ Requires Chilkat v11.0.0+
Unicode 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 Unicode C++ Downloads
#include <CkHttpW.h>
#include <CkStringBuilderW.h>
#include <CkJsonObjectW.h>
#include <CkHttpResponseW.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 wchar_t *ipAddress = L"8.8.8.8";
CkHttpW http;
http.put_RequireSslCertVerify(true);
http.put_ConnectTimeout(10);
http.put_ReadTimeout(30);
http.put_Accept(L"application/json");
// The free endpoint is HTTP-only. This single lookup sends no API credentials.
CkStringBuilderW url;
url.Append(L"http://ip-api.com/json/");
url.Append(http.urlEncode(ipAddress));
CkJsonObjectW parameters;
parameters.UpdateString(L"fields",L"status,message,query,country,countryCode,regionName,city,lat,lon,timezone");
CkHttpResponseW response;
success = http.HttpParams(L"GET",url.getAsString(),parameters,response);
if (response.get_StatusCode() == 0) {
// Request diagnostics can contain an API key. Report transport failure without logging credentials.
wprintf(L"No HTTP response. Check connectivity, DNS, and TLS configuration.\n");
return;
}
// Save these values if the application will make further requests.
const wchar_t *remaining = response.getHeaderField(L"X-Rl");
if (remaining == L"0") {
wprintf(L"Rate limit reached. Wait %s seconds before the next request.\n",response.getHeaderField(L"X-Ttl"));
}
CkJsonObjectW json;
bool parsed = json.Load(response.bodyStr());
if ((success != true) || (response.get_StatusCode() < 200) || (response.get_StatusCode() >= 300)) {
wprintf(L"Lookup failed. HTTP %d\n",response.get_StatusCode());
if (parsed == true) {
if (json.JsonTypeOf(L"message") == 1) {
wprintf(L"%s\n",json.stringOf(L"message"));
}
}
return;
}
if (parsed != true) {
wprintf(L"Expected a JSON object in the lookup response.\n");
return;
}
if (json.StringOfEquals(L"status",L"success",true) != true) {
wprintf(L"The service could not complete the lookup.\n");
if (json.JsonTypeOf(L"message") == 1) {
wprintf(L"%s\n",json.stringOf(L"message"));
}
return;
}
if ((json.JsonTypeOf(L"query") != 1) || (json.StringOfEquals(L"query",L"",true) == true)) {
wprintf(L"The response did not contain the expected IP address.\n");
return;
}
wprintf(L"IP address: %s\n",json.stringOf(L"query"));
if ((json.JsonTypeOf(L"country") == 1) && (json.StringOfEquals(L"country",L"",true) != true)) {
wprintf(L"Country: %s\n",json.stringOf(L"country"));
}
else {
wprintf(L"Country: unavailable\n");
}
if ((json.JsonTypeOf(L"countryCode") == 1) && (json.StringOfEquals(L"countryCode",L"",true) != true)) {
wprintf(L"Country code: %s\n",json.stringOf(L"countryCode"));
}
else {
wprintf(L"Country code: unavailable\n");
}
if ((json.JsonTypeOf(L"regionName") == 1) && (json.StringOfEquals(L"regionName",L"",true) != true)) {
wprintf(L"Region: %s\n",json.stringOf(L"regionName"));
}
else {
wprintf(L"Region: unavailable\n");
}
if ((json.JsonTypeOf(L"city") == 1) && (json.StringOfEquals(L"city",L"",true) != true)) {
wprintf(L"City: %s\n",json.stringOf(L"city"));
}
else {
wprintf(L"City: unavailable\n");
}
if ((json.JsonTypeOf(L"timezone") == 1) && (json.StringOfEquals(L"timezone",L"",true) != true)) {
wprintf(L"Time zone: %s\n",json.stringOf(L"timezone"));
}
else {
wprintf(L"Time zone: unavailable\n");
}
// Missing coordinates stay unavailable. A numeric zero is a valid coordinate.
if ((json.JsonTypeOf(L"lat") == 2) && (json.JsonTypeOf(L"lon") == 2)) {
wprintf(L"Coordinates: %s, %s\n",json.stringOf(L"lat"),json.stringOf(L"lon"));
}
else {
wprintf(L"Coordinates: unavailable\n");
}
}