https://github.com/gkarthiks/ip-geo-locator
Returns the GEO location of the IP Address provided
https://github.com/gkarthiks/ip-geo-locator
charset geo-location golang ip
Last synced: 6 months ago
JSON representation
Returns the GEO location of the IP Address provided
- Host: GitHub
- URL: https://github.com/gkarthiks/ip-geo-locator
- Owner: gkarthiks
- License: mit
- Created: 2019-04-13T20:20:52.000Z (over 6 years ago)
- Default Branch: main
- Last Pushed: 2023-02-23T00:48:16.000Z (over 2 years ago)
- Last Synced: 2025-03-26T13:46:17.616Z (7 months ago)
- Topics: charset, geo-location, golang, ip
- Language: Go
- Homepage: https://gkarthiks.github.io/ip-geo-locator/
- Size: 226 KB
- Stars: 5
- Watchers: 3
- Forks: 2
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# IP Geo Locator
[](https://goreportcard.com/report/github.com/gkarthiks/ip-geo-locator)
[](https://github.com/gkarthiks/ip-geo-locator/actions/workflows/codeql-analysis.yml)
## Live Demo
Try the live demo in Heroku here: https://ip-geo-locator.herokuapp.com/ip/218.189.35.128
Locates the geography of the given IP address. The webserver continiously runs on port 8080 and accepts the `GET` request on the following endpoint `http://:8080/ip/`
Requests to the above endpoint will be responded with the user friendly JSON responses as shown below.
```json
{
"Responses": [
{
"ip": "218.189.35.128",
"host": "218.189.35.128",
"isp": "HGC",
"city": "",
"countrycode": "HK",
"countryname": "Hong Kong",
"latitude": "22.25",
"longitude": "114.1667"
}
]
}
```
As explained earlier, the server also accepts the comma separated IP address and will respond with array of JSON objects as shown below.
#### Comma separated multiple IP Addresses
```url
http://localhost:8080/ip/218.189.35.128,118.189.35.128,18.189.35.128
```
#### JSON Response
```json
{
"Responses": [
{
"ip": "218.189.35.128",
"host": "218.189.35.128",
"isp": "HGC",
"city": "",
"countrycode": "HK",
"countryname": "Hong Kong",
"latitude": "22.25",
"longitude": "114.1667"
},
{
"ip": "118.189.35.128",
"host": "118.189.35.128",
"isp": "M1 Connect Pte Ltd",
"city": "Singapore",
"countrycode": "SG",
"countryname": "Singapore",
"latitude": "1.2929",
"longitude": "103.8547"
},
{
"ip": "18.189.35.128",
"host": "18.189.35.128",
"isp": "Amazon.com",
"city": "Columbus",
"countrycode": "US",
"countryname": "United States",
"latitude": "39.9653",
"longitude": "-83.0235"
}
]
}
```
### Docker Image
This utility project is dockerized and is avilable as a docker image [here](https://hub.docker.com/r/gkarthics/ip-geo-locator).