geoip

Documentation

Index

• func ASOrgUnknown(asOrg string) bool
• func IsInitialized(v6, wait bool) bool
• func PrimitiveNetworkProximity(from net.IP, to net.IP, ipVersion uint8) int
• type Coordinates
• type Location
  • func GetLocation(ip net.IP) (*Location, error)
  • func (l *Location) AddRegion()
  • func (l *Location) EstimateNetworkProximity(to *Location) (proximity float32)
  • func (l *Location) FillMissingInfo()
  • func (l *Location) IsRegionalNeighbor(other *Location) bool
• type Region

Functions

func ASOrgUnknown

func ASOrgUnknown(asOrg string) bool

ASOrgUnknown return whether the given AS Org string actually is meant to mean that the AS Org is unknown.

func IsInitialized

func IsInitialized(v6, wait bool) bool

IsInitialized returns whether the geoip database has been initialized.

func PrimitiveNetworkProximity

func PrimitiveNetworkProximity(from net.IP, to net.IP, ipVersion uint8) int

PrimitiveNetworkProximity calculates the numerical distance between two IP addresses. Returns a proximity value between 0 (far away) and 100 (nearby).

Types

type Coordinates

type Coordinates struct {
	AccuracyRadius uint16  `maxminddb:"accuracy_radius"`
	Latitude       float64 `maxminddb:"latitude"`
	Longitude      float64 `maxminddb:"longitude"`
}

Coordinates holds geographic coordinates and their estimated accuracy.

type Location

type Location struct {
	Continent struct {
		Code string `maxminddb:"code"`
	} `maxminddb:"continent"`
	Country struct {
		ISOCode string `maxminddb:"iso_code"`
	} `maxminddb:"country"`
	Coordinates                  Coordinates `maxminddb:"location"`
	AutonomousSystemNumber       uint        `maxminddb:"autonomous_system_number"`
	AutonomousSystemOrganization string      `maxminddb:"autonomous_system_organization"`
	IsAnycast                    bool        `maxminddb:"is_anycast"`
	IsSatelliteProvider          bool        `maxminddb:"is_satellite_provider"`
	IsAnonymousProxy             bool        `maxminddb:"is_anonymous_proxy"`
}

Location holds information regarding the geographical and network location of an IP address. TODO: We are currently re-using the Continent-Code for the region. Update this and all dependencies.

func GetLocation

func GetLocation(ip net.IP) (*Location, error)

GetLocation returns Location data of an IP address.

func (*Location) AddRegion

func (l *Location) AddRegion()

AddRegion adds the region based on the country.

func (*Location) EstimateNetworkProximity

func (l *Location) EstimateNetworkProximity(to *Location) (proximity float32)

EstimateNetworkProximity aims to calculate the distance between two network locations. Returns a proximity value between 0 (far away) and 100 (nearby).

func (*Location) FillMissingInfo

func (l *Location) FillMissingInfo()

FillMissingInfo tries to fill missing location information based on the available existing information.

func (*Location) IsRegionalNeighbor

func (l *Location) IsRegionalNeighbor(other *Location) bool

IsRegionalNeighbor returns whether the supplied location is a regional neighbor.

type Region

type Region struct {
	ID        string
	Name      string
	Neighbors []string
}

Region defines a geographic region and neighboring regions.