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

Look up an IP address with ipstack over HTTPS

See more Geolocation Examples

Set your ipstack access key and request one public IP address over HTTPS. HTTP status errors and the API’s success=false error object are checked separately. Account quotas and optional modules depend on the subscription. The example displays core geolocation fields and handles null values.

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 Unicode C++ Downloads

Unicode C++
#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");
    const wchar_t *accessKey = L"YOUR_ACCESS_KEY";
    CkStringBuilderW url;
    url.Append(L"https://api.ipstack.com/");
    url.Append(http.urlEncode(ipAddress));
    CkJsonObjectW parameters;
    parameters.UpdateString(L"access_key",accessKey);
    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;
    }

    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"error.type") == 1) {
                wprintf(L"%s\n",json.stringOf(L"error.type"));
            }

            if (json.JsonTypeOf(L"error.info") == 1) {
                wprintf(L"%s\n",json.stringOf(L"error.info"));
            }

        }

        return;
    }

    if (parsed != true) {
        wprintf(L"Expected a JSON object in the lookup response.\n");
        return;
    }

    if (((json.JsonTypeOf(L"success") == 5) && (json.BoolOf(L"success") != true)) || (json.JsonTypeOf(L"error") == 3)) {
        wprintf(L"The service could not complete the lookup.\n");
        if (json.JsonTypeOf(L"error.type") == 1) {
            wprintf(L"%s\n",json.stringOf(L"error.type"));
        }

        if (json.JsonTypeOf(L"error.info") == 1) {
            wprintf(L"%s\n",json.stringOf(L"error.info"));
        }

        return;
    }

    if ((json.JsonTypeOf(L"ip") != 1) || (json.StringOfEquals(L"ip",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"ip"));
    if ((json.JsonTypeOf(L"country_name") == 1) && (json.StringOfEquals(L"country_name",L"",true) != true)) {
        wprintf(L"Country: %s\n",json.stringOf(L"country_name"));
    }
    else {
        wprintf(L"Country: unavailable\n");
    }

    if ((json.JsonTypeOf(L"country_code") == 1) && (json.StringOfEquals(L"country_code",L"",true) != true)) {
        wprintf(L"Country code: %s\n",json.stringOf(L"country_code"));
    }
    else {
        wprintf(L"Country code: unavailable\n");
    }

    if ((json.JsonTypeOf(L"region_name") == 1) && (json.StringOfEquals(L"region_name",L"",true) != true)) {
        wprintf(L"Region: %s\n",json.stringOf(L"region_name"));
    }
    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"zip") == 1) && (json.StringOfEquals(L"zip",L"",true) != true)) {
        wprintf(L"Postal code: %s\n",json.stringOf(L"zip"));
    }
    else {
        wprintf(L"Postal code: unavailable\n");
    }

    //  Missing coordinates stay unavailable. A numeric zero is a valid coordinate.
    if ((json.JsonTypeOf(L"latitude") == 2) && (json.JsonTypeOf(L"longitude") == 2)) {
        wprintf(L"Coordinates: %s, %s\n",json.stringOf(L"latitude"),json.stringOf(L"longitude"));
    }
    else {
        wprintf(L"Coordinates: unavailable\n");
    }
    }