https://github.com/simoncropp/countrydata
Provides a .net wrapper around the GeoNames Data
https://github.com/simoncropp/countrydata
Last synced: about 1 year ago
JSON representation
Provides a .net wrapper around the GeoNames Data
- Host: GitHub
- URL: https://github.com/simoncropp/countrydata
- Owner: SimonCropp
- License: other
- Created: 2018-07-01T09:43:45.000Z (almost 8 years ago)
- Default Branch: main
- Last Pushed: 2025-05-12T10:02:42.000Z (about 1 year ago)
- Last Synced: 2025-05-12T11:24:42.873Z (about 1 year ago)
- Language: C#
- Homepage:
- Size: 950 MB
- Stars: 86
- Watchers: 4
- Forks: 8
- Open Issues: 0
-
Metadata Files:
- Readme: readme.md
- Funding: .github/FUNDING.yml
- License: license.txt
- Code of conduct: code_of_conduct.md
Awesome Lists containing this project
README
# 
CountryData
[](https://ci.appveyor.com/project/SimonCropp/countrydata)
[](https://www.nuget.org/packages/CountryData/)
[](https://www.nuget.org/packages/CountryData.Bogus/)
Provides a .net wrapper around the [GeoNames Data](https://www.geonames.org/). Also exposes the data as per country json files.
**See [Milestones](../../milestones?state=closed) 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](https://dependabot.com/): creates pull requests to keep dependencies secure and up-to-date.
* [Using NuGet wildcards](https://docs.microsoft.com/en-us/nuget/reference/package-versioning#version-ranges-and-wildcards).
* [Libraries.io](https://libraries.io/) supports subscribing to NuGet package updates.
## Usage
```cs
// All country info. This is only the country metadata
// and not all locationData.
var allCountryInfo = CountryLoader.CountryInfo;
var costaRicaInfo = allCountryInfo.Single(_ => _.Iso == "CR");
// Loads all location data for a specific country
var australiaData = CountryLoader.LoadAustraliaLocationData();
var name = australiaData.Name;
var state = australiaData.States[0];
var province = state.Provinces[0];
var community = province.Communities[0];
var place = community.Places[0];
var postCode = place.PostCode;
var placeName = place.Name;
var latitude = place.Location.Latitude;
var longitude = place.Location.Longitude;
```
snippet source | anchor
## Bogus Usage
```cs
var faker = new Faker()
.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());
var targetInstance = 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](https://thenounproject.com/term/world/956116/) designed by [Pedro Santos](https://thenounproject.com/pedrosantospt3) from [The Noun Project](https://thenounproject.com/pedrosantospt3).