offline library to get information about countries like name, capital, currencies, phone number prefixes, postal code, regex, time zones, google map location, openstreetmap location, flags, ...
Install it into your dotnet project(.NET Standard, .NET Core, .NET, Xamarin, Maui, WPF, etc.).
Note
Add namespaceRESTCountries.NET.Services and call RestCountriesService class to access all methods.
Each method returns an object of type Country or a IEnumerable of Country. You can apply filters on the returned value to retrieve what you need.
Example:
Just get name and capital city of all countries.
Get country names in French language or Spanish language.
The default language for the country name is English, but you can also get the name in other languages such as: Arabic, Breton, Czech, Welsh, German, Estonian, Finnish, French, Croatian, Hungarian, Italian, Japanese, Korean, Dutch, Persian, Polish, Russian, Slovak, Spanish, Swedish, Turkish, Urdu and Chinese.
Usage
Note: The list is already ordered ascending by the country name.
Get all countries
// Get all countries
IEnumerable<Country> countries = RestCountriesService.GetAllCountries();
Search by country name containing a "prefix"
// Search by country name containing "a" or "A"
IEnumerable<Country> result = RestCountriesService.GetCountriesByNameContains("a");
Search by country full name
// Search by country full name
Country? result = GetCountryByFullName("Brazil");
Search by Alpha-2 code or Alpha-3 code
// Search by list of ISO 3166-1 2-letter or 3-letter country codes
Country? result = RestCountriesService.GetCountryByCode("us"); // or USA
Search by currency code, name or symbol
// Search by currency code, name or symbol
IEnumerable<Country> result = RestCountriesService.GetCountriesByCurrency("EUR"); // Or Euro or €
Search by language
// Search by language
IEnumerable<Country> result = RestCountriesService.GetCountriesByLanguage("french"); // or fra
You can use var instead of explicit types. I use explicit types to show you the return type of each method.
Get only country names
var result = RestCountriesService.GetAllCountriesNames().ToList();
Here, you can choose the language you want. check out the the TranslationLanguage class to see the available languages.
// Get country names in French langauge
List<string> result = RestCountriesService.GetAllCountriesNames(TranslationLanguage.French).ToList();
Country class
public class Country
{
/// <summary>
/// Country name
/// </summary>
public CountryName Name { get; set; }
/// <summary>
/// Top Level Domain of the country.
/// </summary>
public string[]? Tld { get; set; }
/// <summary>
/// The alpha-2 code of the country.
/// </summary>
public string Cca2 { get; set; }
/// <summary>
/// ISO 3166-1 numeric : https://en.wikipedia.org/wiki/ISO_3166-1_numeric
/// </summary>
public string? Ccn3 { get; set; }
/// <summary>
/// The alpha-3 code of the country.
/// </summary>
public string Cca3 { get; set; }
/// <summary>
/// International Olympic Committee Code.
/// </summary>
public string Cioc { get; set; }
/// <summary>
/// Is the country independent?
/// </summary>
public bool? Independent { get; set; }
/// <summary>
/// Status of the country. check out the https://restcountries.com/ for more info.
/// </summary>
public string? Status { get; set; }
/// <summary>
/// Is the country member of the United Nations ?
/// </summary>
public bool UnMember { get; set; }
/// <summary>
/// Currencies used in the country.
/// The dictionary is the currency code, the value is a Currency
/// object: {name: string, symbol: string}.
/// </summary>
public Dictionary<string, Currency>? Currencies { get; set; }
/// <summary>
/// International direct dialing.
/// </summary>
public Idd Idd { get; set; }
/// <summary>
/// Capital(s) of the country.
/// </summary>
public string[] Capital { get; set; }
/// <summary>
/// Alternative spellings of the country.
/// </summary>
public string[] AltSpellings { get; set; }
/// <summary>
/// Region of the country (eg. Africa, Americas, Asia, Europe, Oceania, Antarctic).
/// </summary>
public string Region { get; set; }
/// <summary>
/// The subregion of the country(eg. Western Africa, Western Europe, ...)
/// <remarks>Can be null.</remarks>
/// </summary>
public string? Subregion { get; set; }
/// <summary>
/// Languages spoken in the country.
/// The key of the dictionary is the language code, the value is a
/// the language name in english.
/// </summary>
public Dictionary<string, string>? Languages { get; set; }
/// <summary>
/// Translations of the country name in other languages
/// </summary>
public Dictionary<string, Translation> Translations { get; set; }
/// <summary>
/// Gps coordinates of the country in the format: [latitude, longitude].
/// </summary>
private double[] LatLng { get; set; }
/// <summary>
/// Is the country landlocked?
/// </summary>
public bool Landlocked { get; set; }
/// <summary>
/// Neighboring countries.
/// </summary>
public string[] Borders { get; set; }
/// <summary>
/// The area of the country in square kilometers.
/// </summary>
public double? Area { get; set; }
/// <summary>
/// Demonym.
/// </summary>
public Demonyms? Demonyms { get; set; }
/// <summary>
/// Unicode flag.
/// </summary>
public string UnicodeFlag { get; set; }
/// <summary>
/// Google maps or OpenStreetMap link.
/// </summary>
public Maps Maps { get; set; }
/// <summary>
/// FIFA code.
/// </summary>
public string? Fifa { get; set; }
/// <summary>
/// Car information.
/// </summary>
public Car? Car { get; set; }
/// <summary>
/// List of timezones.
/// </summary>
public string[] Timezones { get; set; }
/// <summary>
/// Continent of the country. Only one continent is possible.
/// The data source taken from https://restcountries.com/ return a list of
/// one continent. That's why it's an array.
/// </summary>
public string[] Continents { get; set; }
/// <summary>
/// Flag(Url) of the country in png and svg format.
/// </summary>
public Flag Flag { get; set; }
/// <summary>
/// The week start by which day ? (eg. Sunday, Monday, ...)
/// </summary>
public string StartOfWeek { get; set; }
/// <summary>
/// Capital details. (eg. latitude, longitude, ...)
/// </summary>
public CapitalInformation CapitalInformation { get; set; }
/// <summary>
/// Postal code information (eg. format, regex).
/// </summary>
public PostalCode? PostalCode { get; set; }
}
