Golang高效处理国家地区数据的插件库countries的使用

简介

Countries是一个Go语言的国家地区数据处理库，它是Ruby Countries库的Go语言移植版本。该库提供了以下功能：

• 标准ISO3166-1（国家）
• 标准ISO3166-2（州/地区）
• 标准ISO4217（货币）
• 标准E.164（电话号码）
• 国家名称翻译
• 增值税率
• 地址格式
• 时区信息

安装

go get github.com/pioz/countries

使用示例

1. 识别码

c := countries.Get("US")
fmt.Println(c.Number)  // 840
fmt.Println(c.Alpha2)  // US
fmt.Println(c.Alpha3)  // USA
fmt.Println(c.GEC)     // US

2. 名称和翻译

c := countries.Get("US")
fmt.Println(c.ISOLongName)       // The United States of America
fmt.Println(c.ISOShortName)      // United States of America
fmt.Println(c.UnofficialNames)   // [United States USA Vereinigte Staaten von Amerika États-Unis Estados Unidos アメリカ合衆国 Verenigde Staten Соединенные Штаты Америки]
fmt.Println(c.Translations["en"]) // United States
fmt.Println(c.Translations["it"]) // Stati Uniti
fmt.Println(c.Translations["de"]) // Vereinigte Staaten
fmt.Println(c.Nationality)       // American
fmt.Println(c.Capital)           // Washington
fmt.Println(c.EmojiFlag())       // 🇺🇸

3. 行政区划

c := countries.Get("US")
ca := c.Subdivision("CA")
tx := c.SubdivisionByName("Texas")
fmt.Println(len(c.Subdivisions))  // 57
fmt.Println(ca.Name)             // California
fmt.Println(ca.Type)             // state
fmt.Println(ca.Translations["de"]) // Kalifornien
fmt.Println(ca.Geo.Latitude)     // 36.778261
fmt.Println(tx.Code)             // TX

4. 地理位置

c := countries.Get("US")
fmt.Println(c.Geo.Latitude)   // 37.09024
fmt.Println(c.Geo.Longitude)  // -95.712891
fmt.Println(c.Region)         // Americas
fmt.Println(c.Subregion)      // Northern America
fmt.Println(c.Continent)      // North America
fmt.Println(c.WorldRegion)    // AMER

5. 边界框

c := countries.Get("US")
fmt.Println(c.Geo.MinLatitude)   // 18.91619
fmt.Println(c.Geo.MaxLatitude)   // 71.3577635769
fmt.Println(c.Geo.MinLongitude)  // -171.791110603
fmt.Println(c.Geo.MaxLongitude)  // -66.96466
fmt.Println(c.Geo.Bounds.Northeast.Lat)  // 71.3577635769
fmt.Println(c.Geo.Bounds.Northeast.Lng)  // -66.96466
fmt.Println(c.Geo.Bounds.Southwest.Lat)  // 18.91619
fmt.Println(c.Geo.Bounds.Southwest.Lng)  // -171.791110603

6. 电话路由(E164)

c := countries.Get("US")
fmt.Println(c.CountryCode)                   // 1
fmt.Println(c.NationalDestinationCodeLengths) // [3]
fmt.Println(c.NationalNumberLengths)         // [10]
fmt.Println(c.InternationalPrefix)           // 011
fmt.Println(c.NationalPrefix)                // 1

7. 时区

c := countries.Get("DE")
fmt.Println(c.Timezones)  // [Europe/Berlin Europe/Busingen]

8. 格式化地址

c := countries.Get("US")
fmt.Println(c.AddressFormat)
fmt.Println("---")
fmt.Println(c.FormatAddress("John Smith", "1084 Nuzum Court", "14214", "Buffalo", "New York"))
/*
输出:
{{recipient}}
{{street}}
{{city}} {{region_short}} {{postalcode}}
{{country}}
---
John Smith
1084 Nuzum Court
Buffalo NY 14214
United States of America
*/

9. 增值税率

c := countries.Get("IE")
fmt.Println(c.VatRates.Standard)     // 23
fmt.Println(c.VatRates.Reduced)      // [9 13]
fmt.Println(c.VatRates.SuperReduced) // 4
fmt.Println(c.VatRates.Parking)      // 13

10. 欧盟成员国资格

c := countries.Get("IT")
fmt.Println(c.EUMember)  // true

11. 欧洲经济区成员国资格

c := countries.Get("FR")
fmt.Println(c.EEAMember)  // true

12. 欧洲单一市场成员国资格

c := countries.Get("CH")
fmt.Println(c.ESMMember)  // true

13. GDPR合规性

c := countries.Get("IT")
fmt.Println(c.GDPRCompliant())  // true

14. 国家查找器

allCountries := countries.All
countriesInEurope := countries.InRegion("Europe")
countriesInSouthernAsia := countries.InSubregion("Southern Asia")
countriesInEU := countries.InEU()
fmt.Println(len(allCountries))         // 249
fmt.Println(len(countriesInEurope))    // 51
fmt.Println(len(countriesInSouthernAsia)) // 9
fmt.Println(len(countriesInEU))        // 27

贡献

欢迎在GitHub上提交错误报告和拉取请求。

许可证

该软件包是开源的，遵循MIT许可证。