Sample code for 30+ languages & platforms
PowerBuilder 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 PowerBuilder Downloads

PowerBuilder
integer li_rc
long li_Success
string ls_IpAddress
oleobject loo_Http
oleobject loo_Url
oleobject loo_Response
oleobject loo_Json
long li_Parsed

li_Success = 0

//  Assumes Chilkat is unlocked. See Global Unlock Sample.
//  Use a public IP address. Provider results can change as their databases are updated.
ls_IpAddress = "8.8.8.8"
loo_Http = create oleobject
li_rc = loo_Http.ConnectToNewObject("Chilkat.Http")
if li_rc < 0 then
    destroy loo_Http
    MessageBox("Error","Connecting to COM object failed")
    return
end if
loo_Http.RequireSslCertVerify = 1
loo_Http.ConnectTimeout = 10
loo_Http.ReadTimeout = 30
loo_Http.Accept = "application/json"
loo_Url = create oleobject
li_rc = loo_Url.ConnectToNewObject("Chilkat.StringBuilder")

loo_Url.Append("https://api.db-ip.com/v2/free/")
loo_Url.Append(loo_Http.UrlEncode(ls_IpAddress))
loo_Response = create oleobject
li_rc = loo_Response.ConnectToNewObject("Chilkat.HttpResponse")

li_Success = loo_Http.HttpNoBody("GET",loo_Url.GetAsString(),loo_Response)
if loo_Response.StatusCode = 0 then
    //  Request diagnostics can contain an API key. Report transport failure without logging credentials.
    Write-Debug "No HTTP response. Check connectivity, DNS, and TLS configuration."
    destroy loo_Http
    destroy loo_Url
    destroy loo_Response
    return
end if

loo_Json = create oleobject
li_rc = loo_Json.ConnectToNewObject("Chilkat.JsonObject")

li_Parsed = loo_Json.Load(loo_Response.BodyStr)
if (li_Success <> 1) OR (loo_Response.StatusCode < 200) OR (loo_Response.StatusCode >= 300) then
    Write-Debug "Lookup failed. HTTP " + string(loo_Response.StatusCode)
    if li_Parsed = 1 then
        if loo_Json.JsonTypeOf("errorCode") = 1 then
            Write-Debug loo_Json.StringOf("errorCode")
        end if

        if loo_Json.JsonTypeOf("error") = 1 then
            Write-Debug loo_Json.StringOf("error")
        end if

    end if

    destroy loo_Http
    destroy loo_Url
    destroy loo_Response
    destroy loo_Json
    return
end if

if li_Parsed <> 1 then
    Write-Debug "Expected a JSON object in the lookup response."
    destroy loo_Http
    destroy loo_Url
    destroy loo_Response
    destroy loo_Json
    return
end if

if (loo_Json.HasMember("errorCode") = 1) OR (loo_Json.JsonTypeOf("error") = 1) then
    Write-Debug "The service could not complete the lookup."
    if loo_Json.JsonTypeOf("errorCode") = 1 then
        Write-Debug loo_Json.StringOf("errorCode")
    end if

    if loo_Json.JsonTypeOf("error") = 1 then
        Write-Debug loo_Json.StringOf("error")
    end if

    destroy loo_Http
    destroy loo_Url
    destroy loo_Response
    destroy loo_Json
    return
end if

if (loo_Json.JsonTypeOf("ipAddress") <> 1) OR (loo_Json.StringOfEquals("ipAddress","",1) = 1) then
    Write-Debug "The response did not contain the expected IP address."
    destroy loo_Http
    destroy loo_Url
    destroy loo_Response
    destroy loo_Json
    return
end if

Write-Debug "IP address: " + loo_Json.StringOf("ipAddress")
if (loo_Json.JsonTypeOf("countryName") = 1) AND (loo_Json.StringOfEquals("countryName","",1) <> 1) then
    Write-Debug "Country: " + loo_Json.StringOf("countryName")
else
    Write-Debug "Country: unavailable"
end if

if (loo_Json.JsonTypeOf("countryCode") = 1) AND (loo_Json.StringOfEquals("countryCode","",1) <> 1) then
    Write-Debug "Country code: " + loo_Json.StringOf("countryCode")
else
    Write-Debug "Country code: unavailable"
end if

if (loo_Json.JsonTypeOf("stateProv") = 1) AND (loo_Json.StringOfEquals("stateProv","",1) <> 1) then
    Write-Debug "State or province: " + loo_Json.StringOf("stateProv")
else
    Write-Debug "State or province: unavailable"
end if

if (loo_Json.JsonTypeOf("city") = 1) AND (loo_Json.StringOfEquals("city","",1) <> 1) then
    Write-Debug "City: " + loo_Json.StringOf("city")
else
    Write-Debug "City: unavailable"
end if



destroy loo_Http
destroy loo_Url
destroy loo_Response
destroy loo_Json