Skip to content
Self hosted reverse geo location
TypeScript Dockerfile
Branch: master
Clone or download

Latest commit

Fetching latest commit…
Cannot retrieve the latest commit at this time.

Files

Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
schema
service
.gitignore
README.md
docker-compose.yml

README.md

Self hosted reverse geo location

A simple self-hosted reverse geo location service.

This provides the physical address of the client making a request to it.

Why?

There are a lot of free or semi-free reverse geo location services out there already. Why create another one?

This one is self hosted and provides the ability to get reverse geo location with zero external dependencies.

Request and response format

A GET request to /json/ yields a response formatted as a Place with the location matching the client ip.

Example response:

{
  "@context": "http://schema.org",
  "@type": "Place",
  "geo": {
    "@type": "GeoCoordinates",
    "latitude": 12.34567,
    "longitude": 12.34567
  },
  "address": {
    "@type": "PostalAddress",
    "postalCode": "90210",
    "addressLocality": "Beverly Hills",
    "addressRegion": "California",
    "addressCountry": "US"
  },
  "additionalProperty": {
    "name": "timeZone",
    "value": "-08:00"
  }
}

Where does the data come from?

This site or product includes IP2Location LITE data available from https://www.ip2location.com.

This means that the data is provided free of charge by ip2location.com as long as the above sentence is retained. See license in schema for details.

You can’t perform that action at this time.