đ gountries - Awesome Go Library for Miscellaneous
Package that exposes country and subdivision data.
đ·ïž Miscellaneous
đ These libraries were placed here because none of the other categories seemed to fit.
â 408 stars
Detailed Description of gountries
gountries
Inspired by the countries gem for ruby.
Countries (ISO-3166-1), Country Subdivisions(ISO-3166-2), Currencies (ISO 4217), Geo Coordinates(ISO-6709) as well as translations, country borders and other stuff exposed as struct data.
All data is derived from the pariz/countries repo.
This is currently a work in progress, so things may change. More stuff will be added
Installation
go get github.com/pariz/gountries
Examples
Basic
package main
import (
"fmt"
"github.com/pariz/gountries"
)
func main() {
query := gountries.New()
/////////////////
// Find sweden //
/////////////////
sweden, _ := query.FindCountryByName("sweden")
// sweden, _ := query.FindCountryByAlpha("SE")
// sweden, _ := query.FindCountryByAlpha("SWE")
fmt.Println(sweden.Name.Common) // Output: Sweden
fmt.Println(sweden.Name.Official) // Output: Konungariket Sverige
fmt.Println(sweden.Translations["DEU"].Common) // Output: Schweden
fmt.Println(sweden.Translations["DEU"].Official) // Output: Königreich Schweden
}
A bit more advanced
package main
import (
"fmt"
"github.com/pariz/gountries"
)
func main() {
query := gountries.New()
////////////////////////////////////////////
// Find the bordering countries of Sweden //
////////////////////////////////////////////
sweden, _ := query.FindCountryByAlpha("SWE") // "SE" also works..
// Get the bordering countries of sweden
for _, country := range sweden.BorderingCountries() {
fmt.Println(country.Name.Common)
}
// Output:
// Finland
// Norway
////////////////////////////////////
// Find all subdivisons for Sweden //
////////////////////////////////////
subdivisions := sweden.SubDivisions()
for _, subdivision := range subdivisions {
fmt.Println(subdivision.Name)
}
// Output:
// VÀsterbottens lÀn
// Uppsala lÀn
// Södermanlands lÀn
// Gotlands lÀn
// Dalarnas lÀn
// ...
//////////////////////////////////////////////////////////
// Find all countries bordering Germany and Switzerland //
//////////////////////////////////////////////////////////
countryQuery := gountries.Country{
Borders: []string{
"DEU",
"CHE",
},
}
countries := query.FindCountries(countryQuery)
for _, c := range countries {
fmt.Println(c.Name.Common)
}
// Output:
// Austria
// France
///////////////////////////////////////////////////////////////////
// Calculate distance between Sweden and Germany (in Kilometers) //
///////////////////////////////////////////////////////////////////
se, _ := query.FindCountryByAlpha("SWE")
de, _ := query.FindCountryByAlpha("DEU")
distance := gountries.MeasureDistanceHaversine(se, de)
//distance := MeasureDistancePythagoras(se, de)
fmt.Println(distance)
// Output:
// 1430.1937864547901
distance = gountries.CalculateHaversine(
se.Coordinates.MaxLatitude, se.Coordinates.MaxLongitude,
de.Coordinates.MinLatitude, de.Coordinates.MinLongitude)
fmt.Println(distance)
// Output:
// 2641.26145088825
}
Using packed data
The data in the data/yaml
subdirectory is embedded using go-bindata. Once you include this library in your project, you won't need to access the data directory. To add or update the data, make changes to the YAML files then run:
go-bindata -pkg gountries data/yaml/*
Testing
Has a pretty solid test coverage but is constantly improving.
Todo
- Province/County querying (partially complete)
- Measurement between coordinates
- GeoJSON information
- Suggestions?