Delphi DLL Requires Chilkat v11.0.0+
Delphi DLL
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.
Chilkat Delphi DLL Downloads
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);