CountryData

Provides a .net wrapper around the GeoNames Data. Also exposes the data as per country json files.

See Milestones for release notes.

NuGet packages

• https://nuget.org/packages/CountryData/
• https://nuget.org/packages/CountryData.Bogus/

The NuGets contain a static copy of all data. This data is embedded as resources inside the assembly. No network calls are done by the assembly. To get the latests version of the data do a NuGet update. There are several options to help keep a NuGet update:

• Dependabot: creates pull requests to keep dependencies secure and up-to-date.
• Using NuGet wildcards.
• Libraries.io supports subscribing to NuGet package updates.

Usage

// All country info. This is only the country metadata// and not all locationData.varallCountryInfo=CountryLoader.CountryInfo;varcostaRicaInfo=allCountryInfo.Single(_ =>_.Iso=="CR");// Loads all location data for a specific countryvaraustraliaData=CountryLoader.LoadAustraliaLocationData();varname=australiaData.Name;varstate=australiaData.States[0];varprovince=state.Provinces[0];varcommunity=province.Communities[0];varplace=community.Places[0];varpostCode=place.PostCode;varplaceName=place.Name;varlatitude=place.Location.Latitude;varlongitude=place.Location.Longitude;

^{snippet source | anchor}

Bogus Usage

varfaker=newFaker<Target>().RuleFor(property: u =>u.RandomCountryName,setter:(f,u)=>f.Country().Name()).RuleFor(property: u =>u.AustralianCapital,setter:(f,u)=>CountryDataSet.Australia().Capital).RuleFor(property: u =>u.RandomIrelandState,setter:(f,u)=>CountryDataSet.Ireland().State().Name).RuleFor(property: u =>u.RandomIcelandPostCode,setter:(f,u)=>CountryDataSet.Iceland().PostCode());vartargetInstance=faker.Generate();

^{snippet source | anchor}

Json Files

Country Codes

List of country codes: https://raw.githubusercontent.com/SimonCropp/CountryData/master/Data/countrycodes.txt

https://raw.githubusercontent.com/SimonCropp/CountryData/master/Data/PostCodes/[CountryCode].json.txt

Country Information

https://github.com/SimonCropp/CountryData/blob/master/Data/countryInfo.json.txt

Country Location Data

For example the url for Australia (AU) is:

https://raw.githubusercontent.com/SimonCropp/CountryData/master/Data/PostCodes/AU.json.txt

Structure

The GeoNames data is structured as:

Country > State > Province > Community > Place

However many countries do not have data for every level.

Icon

World designed by Pedro Santos from The Noun Project.