getworld 1.1.0

A dart package to get countries, languages and currencies data.

getworld 1.1.0

Simple package for getting countries, currenices and languages information.

Table of Contents

• getworld 1.1.0
  • Table of Contents
    • nstallation
    • Country Object
    • Language Object
    • Currency Object
    • Name Object
    • Dialing Object
    • LatLng Object
    • Province Object
    • City Object
    • Geographical Object
    • Extra Object
    • Population Object
    • Demonym Object
    • TimeZone Object
    • VATRate Object
    • Usage
    • Features and bugs
  • References

nstallation

Run this command: With Dart:

 $ dart pub add getworld

With Flutter:

 $ flutter pub add getworld

This will add a line like this to your package's pubspec.yaml (and run an implicit dart pub get):

dependencies:
  getworld: ^1.1.0

Alternatively, your editor might support dart pub get or flutter pub get. Check the docs for your editor to learn more.

Now in your Dart code, you can use:

import 'package:getworld/getworld.dart';

Country Object

The countries data based on ISO_3166 countries codes.

Object	Type	Description
Country.name	Name	detrmine the offical and common name of country.
Country.natives	Map<Language, Name>	set of all available native names.
Country.translations	Map<Language, Name>	set of all available translation names.
Country.demonym	String	set of all available translation names.
Country.demonym	String	name of residents.
Country.capital	String	capital city name.
Country.iso_3166_1_alpha2	String	code ISO 3166-1 alpha-2.
Country.iso_3166_1_alpha3	String	code ISO 3166-1 alpha-3.
Country.iso_3166_1_numeric	String	code ISO 3166-1 numeric.
Country.languages	Language	list of official languages.
Country.currencies	Currency	list of official currencies.
Country.tld	List<String>	country code top-level domains.
Country.alt_spellings	List<String>	alternative spellings of country name.
Country.provinces	List<Province>	list of States/Provinces and it's cities.
Country.geographical	Geographical	describe all Geographical information.
Country.dialling	Dialling	dialing information.
Country.extra	Extra	some extra data of country.
Country.population	Population	population count and country population of world population percentage.
Country.wikiLink	String	relative link to country wikipedia page.

Language Object

The Languages data based on ISO 639-3 languages codes.

Object	Type	Description
Language.iso_639_1_alpha2	String	code iso_639_1 alpha-2.
Language.iso_639_2_alpha3	String	code iso_639_2 alpha-3.
Language.name	String	language name.
Language.family	String	language family.
Language.native	String	set of all available native names.
Language.wikiUrl	String	relative link to language wikipedia page.
Language.name_in	Map<Language, List<String>>	set of all available translation names.

Currency Object

The Currencies data based on ISO 4217 languages codes.

Object	Type	Description
Currency.iso_4217_code	String	code iso_4217 alpha3.
Currency.iso_4217_numeric	String	code iso_4217_numeric.
Currency.iso_4217_name	String	code iso_4217_numeric.
Currency.iso_4217_minor_unit	String	the smallest unit of a currency, depending on the number of decimals.
Currency.full_name	String	english full name.
Currency.symbol	String	currency symbol.
Currency.symbol_native	String	currency native symbol.
Currency.decimal_digits	String	decimal_digits.
Currency.rounding	String	Currency Rounding.
Currency.name_plural	String	currency plural name.
Currency.withdrawal_date	String	date of withdrawal.

Name Object

Object	Type	Description
Name.common	String	common name in english.
Name.official	String	official name in english.

Dialing Object

Object	Type	Description
Dialing.calling_code	String	calling code.
Dialing.national_number_lengths	int	national number lengths.

LatLng Object

Object	Type	Description
LatLng.latitude	String	latitude coordinate point.
LatLng.longitude	String	longitude coordinate point.

Province Object

Object	Type	Description
Province.id	int	.
Province.name	String	Described longitude coordinate point.
Province.state_code	String	State/Province code.
Province.latLng	LatLng	coordinate point in decimal form.
Province.type	String	State/Province type.
Province.cities	List<City>	List of cities in State/Province.

City Object

Object	Type	Description
City.id	int	.
City.name	String	name of city.
City.latLng	LatLng	coordinate point in decimal form.

Geographical Object

Object	Type	Description
Geographical.Continents	Continents	continents that country lies in.
Geographical.postal_code	String	area postal code.
Geographical.latLng_dms	LatLng	coordinate point in degrees minutes seconds form.
Geographical.latLng_dec	LatLng	coordinate point in decimal form.
Geographical.latLng_min	LatLng	minmum coordinate point in decimal form.
Geographical.latLng_max	LatLng	maximum coordinate point in decimal form.
Geographical.area	double	land area in km².
Geographical.region	String	geographical region.
Geographical.subregion	String	geographical sub-region.
Geographical.world_region	int	geographical world region.
Geographical.region_code	String	geographical sub-region numeric code.
Geographical.subregion_code	LatLng	geographical sub-region numeric code.
Geographical.landlocked	bool	landlocked status.
Geographical.borders	Country	land borders.
Geographical.independent	String	independent status.

Extra Object

Object	Type	Description
Extra.geonameid	String	Geoname ID.
Extra.edgar	String	Electronic Data Gathering, Analysis, and Retrieval system.
Extra.itu	String	Codes assigned by the International Telecommunications Union.
Extra.marc	String	MAchine-Readable Cataloging codes from the Library of Congress.
Extra.wmo	String	Country abbreviations by the World Meteorological Organization.
Extra.ds	String	Distinguishing signs of vehicles in international traffic.
Extra.fifa	String	Codes assigned by the Fédération Internationale de Football Association.
Extra.fips	String	Codes from the U.S. Federal Information Processing Standard.
Extra.gaul	String	Global Administrative Unit Layers from the Food and Agriculture Organization.
Extra.ioc	String	Codes assigned by the International Olympics Committee.
Extra.cowc	String	Correlates of War character.
Extra.cown	String	Correlates of War numeric.
Extra.fao	String	Food and Agriculture Organization.
Extra.imf	String	International Monetary Fund.
Extra.ar5	String	Fifth Assessment Report (AR5).
Extra.address_format	String	Address format.
Extra.eu_member	String	European Union Member.

Population Object

Object	Type	Description
Population.count	int	population number.
Population.worldPercentage	double	country population of world population percentage.

Demonym Object

Object	Type	Description
Demonym.male	Map<Language, String>	Name of males residents.
Demonym.female	Map<Language, String>	Name of females residents.

TimeZone Object

Object	Type	Description
TimeZone.zoneName	Map<Language, String>	Zone name.
TimeZone.gmtOffset	Map<Language, String>	The time differs from Greenwich Mean Time.
TimeZone.gmtOffsetName	Map<Language, String>	Greenwich Mean Time name.
TimeZone.abbreviation	Map<Language, String>	Time zone abbreviation.
TimeZone.tzName	Map<Language, String>	Time zone name.

VATRate Object

Object	Type	Description
VATRate.standard	double	Standard VAT.
VATRate.reduced	List<double>	Reduced rates.
VATRate.super_reduced	double	Super reduced rates.
VATRate.parking	double	VAT rate for parking.

Usage

getworld must be intiialized with intitailze function and use it once over all the project. intitailze retrive data to three List Countries, Currencies and Languages. You can use all list/map properties over them like map, forEach, forEach, where and ...

import  'package:getworld/getworld.dart';
void  main() async {
Stopwatch stopwatch = Stopwatch()..start();

  GetWorld().initialize();
  print(Countries.length);
  print(Languages.length);
  print(Currencies.length);

  print('GetWorld.intitialize executed in ${stopwatch.elapsed.inMilliseconds} Milliseconds\n');

  //Find by common/offical name
  stopwatch.reset();
  print(Countries.where((country) => country.name.official.toLowerCase().contains("Egypt".toLowerCase()) || country.name.common.toLowerCase().contains("Egypt".toLowerCase())).map((e) => e.name.common));
  print('Countries.where executed  in ${stopwatch.elapsed.inMilliseconds} Milliseconds\n');

  //Find by calling_code
  stopwatch.reset();
  print(Countries.where((country) => country.dialling!.calling_code.contains("+1")).map((e) => e.name.common));
  print('Countries.where executed  in ${stopwatch.elapsed.inMilliseconds} Milliseconds\n');

  //Find by Currency object
  stopwatch.reset();
  print(Countries.where(
          (country) => country.currencies!.contains(Currencies.firstWhere((cur) => cur.iso_4217_code == "USD")))
      .map((e) => e.name.common));
  print('Countries.where executed  in ${stopwatch.elapsed.inMilliseconds} Milliseconds\n');

  //Find by Currency code
  stopwatch.reset();
  print(Countries.where((country) => country.currencies!.any((currency) => currency.iso_4217_code == "USD"))
      .map((e) => e.name.common));
  print('Countries.where executed  in ${stopwatch.elapsed.inMilliseconds} Milliseconds\n');
}

Features and bugs

Please file feature requests and bugs at the [issue tracker][tracker]. issue tracker

References

1. Countries ISO 3166 code
2. Languages ISO 639
3. Currencies ISO_4217
4. arash16/countries-languages
5. ksafranski/Common-Currency.json
6. CryceTruly/currencies.json
7. dr5hn/countries-states-cities-database