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.
Chilkat PowerBuilder Downloads
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