flutter_countries

Description:

flutter countries

Flutter Countries #
Query and retrieve country details by property type from a database of 250 countries.
TODO: Add your license here.

Total Countries : 250
Total States/Regions/Municipalities : 4,979
Total Cities/Towns/Districts : 148,266

See the usage methods for available data.
NOTE The data sets are retreived using rootBundle.loadString() in the main isolate, prior to json -> object conversion.
However, json -> object conversion happens inside a new isolate. If you experience any UI jank when making queries (except when using .all getters), you can try running the query outside of the main isolate.
Reference: Running rootBundle.loadString() outside of main isolate
Data source provided by: Countries States Cities Database
Features #

Works offline
Async queries by substring
Searches by substring, making fuzzy search possible
Matches and returns similar or exact results

Usage - Countries #
Retrieve a list of countries by property and substring.
import 'package:country/country.dart';

await Countries.all;
await Countries.byCapital(capital);
await Countries.byCoords(longitude, latitude);
await Countries.byCurrencyName(currencyName);
await Countries.byId(id);
await Countries.byIso2(iso2);
await Countries.byIso3(iso3);
await Countries.byName(name);
await Countries.byNative(native);
await Countries.byNumericCode(numericCode);
await Countries.byPhoneCode(phoneCode);
await Countries.byRegion(region);
await Countries.bySubRegion(subRegion);
await Countries.byTimeZoneAbbreviation(timeZoneAbbreviation);
await Countries.byTimeZoneGmtOffset(timeZoneGmtOffset);
await Countries.byTimeZoneGmtOffsetName(gmtOffsetName):
await Countries.byTimeZoneTzName(timeZoneTzName);
await Countries.byTimeZoneZoneName(zoneName);
await Countries.byTld(tld);
await Countries.byTranslation(translation);
copied to clipboard
Usage - States #
Retrieve a list of states by property and substring.
import 'package:country/country.dart';

await States.all;
await States.byCoords(longitude, latitude);
await States.byCountryCode(countryCode);
await States.byCountryId(countryId);
await States.byCountryName(countryName);
await States.byId(id);
await States.byLatitude(latitude);
await States.byLongitude(longitude);
await States.byName(name);
await States.byStateCode(stateCode);
await States.byType(type);
copied to clipboard
Usage - Cities #
Retrieve a list of cities by property and substring.
import 'package:country/country.dart';

await Cities.all;
await Cities.byCoords(longitude, latitude);
await Cities.byCountryCode(countryCode);
await Cities.byCountryName(countryName);
await Cities.byId(id);
await Cities.byLatitude(latitude);
await Cities.byLongitude(longitude);
await Cities.byName(name);
await Cities.byStateCode(stateCode);
await Cities.byStateId(stateId);
await Cities.byStateName(stateName);
await Cities.byWikiDataId(wikiDataId);
await Cities.bycountryID(countryId);
copied to clipboard
Additional information #
Improvements to be made to queries.
Paurini Wiringi