# ExGeo
A simple little genserver that keeps a maxmind geolocation database up to date
## Installation
```elixir
def deps do
[
{:ex_geo, "~> 1.1.0"}
]
end
```
## Usage
Usage is quite simple, as the underlying GenServer is started with the application:
```elixir
result = ExGeo.lookup(ip)
# result.country
# result.city
# result.postal
# result.region
# result.continent
```
The lookup is done against MaxMind's free [GeoLite2 City database](http://dev.maxmind.com/geoip/geoip2/geolite2/). If you want to bring your own geolocation db, you can tune these params:
```elixir
config :ex_geo, ExGeo.Store,
url: "http://geolite.maxmind.com/download/geoip/database/GeoLite2-City.mmdb.gz",
lookup_interval: 1000 * 60 * 60 * 24
```