geolookup

Documentation

Index

• func EnablePersistence(geoFile string)
• func GetCountry(timeout time.Duration) string
• func GetIP(timeout time.Duration) string
• func OnRefresh() <-chan bool
• func Refresh()
• func SetDefaultRoundTripper()
• type GeoInfo
  • func GetGeoInfo(timeout time.Duration) (*GeoInfo, error)

Functions

func EnablePersistence

func EnablePersistence(geoFile string)

EnablePersistence enables persistence of the current geo info to disk at the named file and initializes current geo info from that file if necessary.

func GetCountry

func GetCountry(timeout time.Duration) string

GetCountry gets the country. If the country hasn't been determined yet, waits up to the given timeout for a country to become available.

func GetIP

func GetIP(timeout time.Duration) string

GetIP gets the IP. If the IP hasn't been determined yet, waits up to the given timeout for an IP to become available.

func OnRefresh

func OnRefresh() <-chan bool

OnRefresh creates a channel that caller can receive on when new geolocation information is got.

func Refresh

func Refresh()

Refresh refreshes the geolookup information by calling the remote geolookup service. It will keep calling the service until it's able to determine an IP and country.

func SetDefaultRoundTripper

func SetDefaultRoundTripper()

Types

type GeoInfo

type GeoInfo struct {
	IP       string
	City     *geo.City
	FromDisk bool
}

func GetGeoInfo

func GetGeoInfo(timeout time.Duration) (*GeoInfo, error)