Delphi DLL Requires Chilkat v11.0.0+
Delphi DLL
Look up an IP address with ipapi.co
See more Geolocation Examples
Request the HTTPS JSON endpoint for a public IPv4 or IPv6 address. The sample uses the keyless service for evaluation. Use your subscription credentials and limits for production traffic.
Check both the HTTP status and the JSON error flag. An invalid or reserved address can return HTTP 200 with an error object. Unknown location fields are returned as null. The example keeps those values unavailable instead of displaying zero coordinates.
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;
url: HCkStringBuilder;
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');
url := CkStringBuilder_Create();
CkStringBuilder_Append(url,'https://ipapi.co/');
CkStringBuilder_Append(url,CkHttp__urlEncode(http,ipAddress));
CkStringBuilder_Append(url,'/json/');
response := CkHttpResponse_Create();
success := CkHttp_HttpNoBody(http,'GET',CkStringBuilder__getAsString(url),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,'reason') = 1) then
begin
Memo1.Lines.Add(CkJsonObject__stringOf(json,'reason'));
end;
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,'error') = 5) and (CkJsonObject_BoolOf(json,'error') = True)) then
begin
Memo1.Lines.Add('The service could not complete the lookup.');
if (CkJsonObject_JsonTypeOf(json,'reason') = 1) then
begin
Memo1.Lines.Add(CkJsonObject__stringOf(json,'reason'));
end;
if (CkJsonObject_JsonTypeOf(json,'message') = 1) then
begin
Memo1.Lines.Add(CkJsonObject__stringOf(json,'message'));
end;
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,'timezone') = 1) and (CkJsonObject_StringOfEquals(json,'timezone','',True) <> True)) then
begin
Memo1.Lines.Add('Time zone: ' + CkJsonObject__stringOf(json,'timezone'));
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;
CkHttp_Dispose(http);
CkStringBuilder_Dispose(url);
CkHttpResponse_Dispose(response);
CkJsonObject_Dispose(json);