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

Geolocation of IP Address

See more REST Examples

Retrieve country, state or province, and city for a public IP address using the DB-IP v2 free JSON API. This replaces the retired freegeoip.net request and the historical two-service comparison. The sample sends one HTTPS request, checks transport and service errors, and reads the returned fields.

DB-IP documents 500 daily requests for its free service. Its free HTTPS endpoint returned a successful lookup during verification on November 20, 2026. For other providers and authenticated services, see the Geolocation examples.

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 ActiveX Downloads

Delphi ActiveX
var
success: Integer;
ipAddress: WideString;
http: TChilkatHttp;
url: TChilkatStringBuilder;
response: TChilkatHttpResponse;
json: TChilkatJsonObject;
parsed: Integer;

begin
success := 0;

//  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 := TChilkatHttp.Create(Self);
http.RequireSslCertVerify := 1;
http.ConnectTimeout := 10;
http.ReadTimeout := 30;
http.Accept := 'application/json';
url := TChilkatStringBuilder.Create(Self);
url.Append('https://api.db-ip.com/v2/free/');
url.Append(http.UrlEncode(ipAddress));
response := TChilkatHttpResponse.Create(Self);
success := http.HttpNoBody('GET',url.GetAsString(),response.ControlInterface);
if (response.StatusCode = 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 := TChilkatJsonObject.Create(Self);
parsed := json.Load(response.BodyStr);
if ((success <> 1) or (response.StatusCode < 200) or (response.StatusCode >= 300)) then
  begin
    Memo1.Lines.Add('Lookup failed. HTTP ' + IntToStr(response.StatusCode));
    if (parsed = 1) then
      begin
        if (json.JsonTypeOf('errorCode') = 1) then
          begin
            Memo1.Lines.Add(json.StringOf('errorCode'));
          end;
        if (json.JsonTypeOf('error') = 1) then
          begin
            Memo1.Lines.Add(json.StringOf('error'));
          end;
      end;
    Exit;
  end;
if (parsed <> 1) then
  begin
    Memo1.Lines.Add('Expected a JSON object in the lookup response.');
    Exit;
  end;
if ((json.HasMember('errorCode') = 1) or (json.JsonTypeOf('error') = 1)) then
  begin
    Memo1.Lines.Add('The service could not complete the lookup.');
    if (json.JsonTypeOf('errorCode') = 1) then
      begin
        Memo1.Lines.Add(json.StringOf('errorCode'));
      end;
    if (json.JsonTypeOf('error') = 1) then
      begin
        Memo1.Lines.Add(json.StringOf('error'));
      end;
    Exit;
  end;
if ((json.JsonTypeOf('ipAddress') <> 1) or (json.StringOfEquals('ipAddress','',1) = 1)) then
  begin
    Memo1.Lines.Add('The response did not contain the expected IP address.');
    Exit;
  end;
Memo1.Lines.Add('IP address: ' + json.StringOf('ipAddress'));
if ((json.JsonTypeOf('countryName') = 1) and (json.StringOfEquals('countryName','',1) <> 1)) then
  begin
    Memo1.Lines.Add('Country: ' + json.StringOf('countryName'));
  end
else
  begin
    Memo1.Lines.Add('Country: unavailable');
  end;
if ((json.JsonTypeOf('countryCode') = 1) and (json.StringOfEquals('countryCode','',1) <> 1)) then
  begin
    Memo1.Lines.Add('Country code: ' + json.StringOf('countryCode'));
  end
else
  begin
    Memo1.Lines.Add('Country code: unavailable');
  end;
if ((json.JsonTypeOf('stateProv') = 1) and (json.StringOfEquals('stateProv','',1) <> 1)) then
  begin
    Memo1.Lines.Add('State or province: ' + json.StringOf('stateProv'));
  end
else
  begin
    Memo1.Lines.Add('State or province: unavailable');
  end;
if ((json.JsonTypeOf('city') = 1) and (json.StringOfEquals('city','',1) <> 1)) then
  begin
    Memo1.Lines.Add('City: ' + json.StringOf('city'));
  end
else
  begin
    Memo1.Lines.Add('City: unavailable');
  end;