alonbg / ip2loc

A IP2Location DB1 (country-only) binary database query library for Go. Very fast.

IP2Loc

An IP2Location binary data query engine that only works with the DB1 (Country) database.

There are a few major differences between this and the official library, ip2location/ip2location-go:

• It only supports the DB1 (Country) database;
• Every function can return an error;
• No print statements;
• It's faster and consumes less memory.

Installation

go get -u github.com/tserkov/ip2loc

Usage

It's all in the godoc.

Example

import "github.com/tserkov/ip2loc"

db, err := ip2loc.New("/path/to/db.bin")
if err != nil {
	// handle it
}
defer db.Close()

result, err := db.Query("8.8.8.8")
if err != nil {
	// handle it
}

fmt.Printf(
	"Country Code: %s\nCountry Name: %s\n",
	result.CountryCode,
	result.CountryName,
)

Bonus: A binary!

If you happen to be on Linux, this repository contains an executable that accepts space-delimited IPs via arguments or stdin and spits out results in {IP} {Country Name} ({Country Code}) format to stdout.

It does require that the environment variable IP2LOC_DB be set to the path to the ip2location db1 bin.

License

The super permissive MIT License.

Contributing

While I don't plan on supporting databases beyond DB1, I will gladly take any performance-enhancing contributions.