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

Look up an IP address with ipdata

See more Geolocation Examples

Use an ipdata API key to request a public IPv4 or IPv6 address. The key is encoded as the api-key query parameter. The example displays location fields and the optional ASN object using its current nested structure. Data access and quotas depend on the account plan.

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 Delphi DLL Downloads

Delphi DLL
var
success: Boolean;
ipAddress: PWideChar;
http: HCkHttp;
apiKey: PWideChar;
url: HCkStringBuilder;
parameters: HCkJsonObject;
response: HCkHttpResponse;
json: HCkJsonObject;
parsed: Boolean;

begin
success := False;

//  Assumes Chilkat is unlocked. See Global Unlock Sample.
//  Use a public IP address. Provider results can change as their databases are updated.
ipAddress := '8.8.8.8';
http := CkHttp_Create();
CkHttp_putRequireSslCertVerify(http,True);
CkHttp_putConnectTimeout(http,10);
CkHttp_putReadTimeout(http,30);
CkHttp_putAccept(http,'application/json');
apiKey := 'YOUR_API_KEY';
url := CkStringBuilder_Create();
CkStringBuilder_Append(url,'https://api.ipdata.co/');
CkStringBuilder_Append(url,CkHttp__urlEncode(http,ipAddress));
parameters := CkJsonObject_Create();
CkJsonObject_UpdateString(parameters,'api-key',apiKey);
response := CkHttpResponse_Create();
success := CkHttp_HttpParams(http,'GET',CkStringBuilder__getAsString(url),parameters,response);
if (CkHttpResponse_getStatusCode(response) = 0) then
  begin
    //  Request diagnostics can contain an API key. Report transport failure without logging credentials.
    Memo1.Lines.Add('No HTTP response. Check connectivity, DNS, and TLS configuration.');
    Exit;
  end;
json := CkJsonObject_Create();
parsed := CkJsonObject_Load(json,CkHttpResponse__bodyStr(response));
if ((success <> True) or (CkHttpResponse_getStatusCode(response) < 200) or (CkHttpResponse_getStatusCode(response) >= 300)) then
  begin
    Memo1.Lines.Add('Lookup failed. HTTP ' + IntToStr(CkHttpResponse_getStatusCode(response)));
    if (parsed = True) then
      begin
        if (CkJsonObject_JsonTypeOf(json,'message') = 1) then
          begin
            Memo1.Lines.Add(CkJsonObject__stringOf(json,'message'));
          end;
      end;
    Exit;
  end;
if (parsed <> True) then
  begin
    Memo1.Lines.Add('Expected a JSON object in the lookup response.');
    Exit;
  end;
if ((CkJsonObject_JsonTypeOf(json,'ip') <> 1) or (CkJsonObject_StringOfEquals(json,'ip','',True) = True)) then
  begin
    Memo1.Lines.Add('The response did not contain the expected IP address.');
    Exit;
  end;
Memo1.Lines.Add('IP address: ' + CkJsonObject__stringOf(json,'ip'));
if ((CkJsonObject_JsonTypeOf(json,'country_name') = 1) and (CkJsonObject_StringOfEquals(json,'country_name','',True) <> True)) then
  begin
    Memo1.Lines.Add('Country: ' + CkJsonObject__stringOf(json,'country_name'));
  end
else
  begin
    Memo1.Lines.Add('Country: unavailable');
  end;
if ((CkJsonObject_JsonTypeOf(json,'country_code') = 1) and (CkJsonObject_StringOfEquals(json,'country_code','',True) <> True)) then
  begin
    Memo1.Lines.Add('Country code: ' + CkJsonObject__stringOf(json,'country_code'));
  end
else
  begin
    Memo1.Lines.Add('Country code: unavailable');
  end;
if ((CkJsonObject_JsonTypeOf(json,'region') = 1) and (CkJsonObject_StringOfEquals(json,'region','',True) <> True)) then
  begin
    Memo1.Lines.Add('Region: ' + CkJsonObject__stringOf(json,'region'));
  end
else
  begin
    Memo1.Lines.Add('Region: unavailable');
  end;
if ((CkJsonObject_JsonTypeOf(json,'city') = 1) and (CkJsonObject_StringOfEquals(json,'city','',True) <> True)) then
  begin
    Memo1.Lines.Add('City: ' + CkJsonObject__stringOf(json,'city'));
  end
else
  begin
    Memo1.Lines.Add('City: unavailable');
  end;
if ((CkJsonObject_JsonTypeOf(json,'time_zone.name') = 1) and (CkJsonObject_StringOfEquals(json,'time_zone.name','',True) <> True)) then
  begin
    Memo1.Lines.Add('Time zone: ' + CkJsonObject__stringOf(json,'time_zone.name'));
  end
else
  begin
    Memo1.Lines.Add('Time zone: unavailable');
  end;
//  Missing coordinates stay unavailable. A numeric zero is a valid coordinate.
if ((CkJsonObject_JsonTypeOf(json,'latitude') = 2) and (CkJsonObject_JsonTypeOf(json,'longitude') = 2)) then
  begin
    Memo1.Lines.Add('Coordinates: ' + CkJsonObject__stringOf(json,'latitude') + ', ' + CkJsonObject__stringOf(json,'longitude'));
  end
else
  begin
    Memo1.Lines.Add('Coordinates: unavailable');
  end;
if ((CkJsonObject_JsonTypeOf(json,'asn.asn') = 1) and (CkJsonObject_StringOfEquals(json,'asn.asn','',True) <> True)) then
  begin
    Memo1.Lines.Add('ASN: ' + CkJsonObject__stringOf(json,'asn.asn'));
  end
else
  begin
    Memo1.Lines.Add('ASN: unavailable');
  end;
if ((CkJsonObject_JsonTypeOf(json,'asn.name') = 1) and (CkJsonObject_StringOfEquals(json,'asn.name','',True) <> True)) then
  begin
    Memo1.Lines.Add('Network organization: ' + CkJsonObject__stringOf(json,'asn.name'));
  end
else
  begin
    Memo1.Lines.Add('Network organization: unavailable');
  end;

CkHttp_Dispose(http);
CkStringBuilder_Dispose(url);
CkJsonObject_Dispose(parameters);
CkHttpResponse_Dispose(response);
CkJsonObject_Dispose(json);