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 SQL Server Downloads
-- Important: See this note about string length limitations for strings returned by sp_OAMethod calls.
--
CREATE PROCEDURE ChilkatSample
AS
BEGIN
DECLARE @hr int
DECLARE @iTmp0 int
DECLARE @iTmp1 int
DECLARE @sTmp0 nvarchar(4000)
DECLARE @success int
SELECT @success = 0
-- Assumes Chilkat is unlocked. See Global Unlock Sample.
-- Use a public IP address. Provider results can change as their databases are updated.
DECLARE @ipAddress nvarchar(4000)
SELECT @ipAddress = '8.8.8.8'
DECLARE @http int
EXEC @hr = sp_OACreate 'Chilkat.Http', @http OUT
IF @hr <> 0
BEGIN
PRINT 'Failed to create ActiveX component'
RETURN
END
EXEC sp_OASetProperty @http, 'RequireSslCertVerify', 1
EXEC sp_OASetProperty @http, 'ConnectTimeout', 10
EXEC sp_OASetProperty @http, 'ReadTimeout', 30
EXEC sp_OASetProperty @http, 'Accept', 'application/json'
DECLARE @url int
EXEC @hr = sp_OACreate 'Chilkat.StringBuilder', @url OUT
EXEC sp_OAMethod @url, 'Append', @success OUT, 'https://api.db-ip.com/v2/free/'
EXEC sp_OAMethod @http, 'UrlEncode', @sTmp0 OUT, @ipAddress
EXEC sp_OAMethod @url, 'Append', @success OUT, @sTmp0
DECLARE @response int
EXEC @hr = sp_OACreate 'Chilkat.HttpResponse', @response OUT
EXEC sp_OAMethod @url, 'GetAsString', @sTmp0 OUT
EXEC sp_OAMethod @http, 'HttpNoBody', @success OUT, 'GET', @sTmp0, @response
EXEC sp_OAGetProperty @response, 'StatusCode', @iTmp0 OUT
IF @iTmp0 = 0
BEGIN
-- Request diagnostics can contain an API key. Report transport failure without logging credentials.
PRINT 'No HTTP response. Check connectivity, DNS, and TLS configuration.'
EXEC @hr = sp_OADestroy @http
EXEC @hr = sp_OADestroy @url
EXEC @hr = sp_OADestroy @response
RETURN
END
DECLARE @json int
EXEC @hr = sp_OACreate 'Chilkat.JsonObject', @json OUT
DECLARE @parsed int
EXEC sp_OAGetProperty @response, 'BodyStr', @sTmp0 OUT
EXEC sp_OAMethod @json, 'Load', @parsed OUT, @sTmp0
EXEC sp_OAGetProperty @response, 'StatusCode', @iTmp0 OUT
EXEC sp_OAGetProperty @response, 'StatusCode', @iTmp1 OUT
IF (@success <> 1) or (@iTmp0 < 200) or (@iTmp1 >= 300)
BEGIN
EXEC sp_OAGetProperty @response, 'StatusCode', @iTmp0 OUT
PRINT 'Lookup failed. HTTP ' + @iTmp0
IF @parsed = 1
BEGIN
EXEC sp_OAMethod @json, 'JsonTypeOf', @iTmp0 OUT, 'errorCode'
IF @iTmp0 = 1
BEGIN
EXEC sp_OAMethod @json, 'StringOf', @sTmp0 OUT, 'errorCode'
PRINT @sTmp0
END
EXEC sp_OAMethod @json, 'JsonTypeOf', @iTmp0 OUT, 'error'
IF @iTmp0 = 1
BEGIN
EXEC sp_OAMethod @json, 'StringOf', @sTmp0 OUT, 'error'
PRINT @sTmp0
END
END
EXEC @hr = sp_OADestroy @http
EXEC @hr = sp_OADestroy @url
EXEC @hr = sp_OADestroy @response
EXEC @hr = sp_OADestroy @json
RETURN
END
IF @parsed <> 1
BEGIN
PRINT 'Expected a JSON object in the lookup response.'
EXEC @hr = sp_OADestroy @http
EXEC @hr = sp_OADestroy @url
EXEC @hr = sp_OADestroy @response
EXEC @hr = sp_OADestroy @json
RETURN
END
EXEC sp_OAMethod @json, 'HasMember', @iTmp0 OUT, 'errorCode'
EXEC sp_OAMethod @json, 'JsonTypeOf', @iTmp1 OUT, 'error'
IF (@iTmp0 = 1) or (@iTmp1 = 1)
BEGIN
PRINT 'The service could not complete the lookup.'
EXEC sp_OAMethod @json, 'JsonTypeOf', @iTmp0 OUT, 'errorCode'
IF @iTmp0 = 1
BEGIN
EXEC sp_OAMethod @json, 'StringOf', @sTmp0 OUT, 'errorCode'
PRINT @sTmp0
END
EXEC sp_OAMethod @json, 'JsonTypeOf', @iTmp0 OUT, 'error'
IF @iTmp0 = 1
BEGIN
EXEC sp_OAMethod @json, 'StringOf', @sTmp0 OUT, 'error'
PRINT @sTmp0
END
EXEC @hr = sp_OADestroy @http
EXEC @hr = sp_OADestroy @url
EXEC @hr = sp_OADestroy @response
EXEC @hr = sp_OADestroy @json
RETURN
END
EXEC sp_OAMethod @json, 'JsonTypeOf', @iTmp0 OUT, 'ipAddress'
EXEC sp_OAMethod @json, 'StringOfEquals', @iTmp1 OUT, 'ipAddress', '', 1
IF (@iTmp0 <> 1) or (@iTmp1 = 1)
BEGIN
PRINT 'The response did not contain the expected IP address.'
EXEC @hr = sp_OADestroy @http
EXEC @hr = sp_OADestroy @url
EXEC @hr = sp_OADestroy @response
EXEC @hr = sp_OADestroy @json
RETURN
END
EXEC sp_OAMethod @json, 'StringOf', @sTmp0 OUT, 'ipAddress'
PRINT 'IP address: ' + @sTmp0
EXEC sp_OAMethod @json, 'JsonTypeOf', @iTmp0 OUT, 'countryName'
EXEC sp_OAMethod @json, 'StringOfEquals', @iTmp1 OUT, 'countryName', '', 1
IF (@iTmp0 = 1) and (@iTmp1 <> 1)
BEGIN
EXEC sp_OAMethod @json, 'StringOf', @sTmp0 OUT, 'countryName'
PRINT 'Country: ' + @sTmp0
END
ELSE
BEGIN
PRINT 'Country: unavailable'
END
EXEC sp_OAMethod @json, 'JsonTypeOf', @iTmp0 OUT, 'countryCode'
EXEC sp_OAMethod @json, 'StringOfEquals', @iTmp1 OUT, 'countryCode', '', 1
IF (@iTmp0 = 1) and (@iTmp1 <> 1)
BEGIN
EXEC sp_OAMethod @json, 'StringOf', @sTmp0 OUT, 'countryCode'
PRINT 'Country code: ' + @sTmp0
END
ELSE
BEGIN
PRINT 'Country code: unavailable'
END
EXEC sp_OAMethod @json, 'JsonTypeOf', @iTmp0 OUT, 'stateProv'
EXEC sp_OAMethod @json, 'StringOfEquals', @iTmp1 OUT, 'stateProv', '', 1
IF (@iTmp0 = 1) and (@iTmp1 <> 1)
BEGIN
EXEC sp_OAMethod @json, 'StringOf', @sTmp0 OUT, 'stateProv'
PRINT 'State or province: ' + @sTmp0
END
ELSE
BEGIN
PRINT 'State or province: unavailable'
END
EXEC sp_OAMethod @json, 'JsonTypeOf', @iTmp0 OUT, 'city'
EXEC sp_OAMethod @json, 'StringOfEquals', @iTmp1 OUT, 'city', '', 1
IF (@iTmp0 = 1) and (@iTmp1 <> 1)
BEGIN
EXEC sp_OAMethod @json, 'StringOf', @sTmp0 OUT, 'city'
PRINT 'City: ' + @sTmp0
END
ELSE
BEGIN
PRINT 'City: unavailable'
END
EXEC @hr = sp_OADestroy @http
EXEC @hr = sp_OADestroy @url
EXEC @hr = sp_OADestroy @response
EXEC @hr = sp_OADestroy @json
END
GO