GeoCurrencies #

Flutter Package that provides methods for fetching currencies information, All information about conversion currency are updated once a day.

Features #

• get currency data by coordinate: The library provides methods to get currency data of a given geographic coordinate.
• format amount with currency: The library provides methods to easily format amount with currency symbol.
• convert amount with currency: The library provides methods to easily convert amount the data source are fetched from EXCHANGE RATE API DOCUMENTATION.
• Support for multiple languages: The methods accept an optional Locale parameter, which can be used to specify the language. The default language is English.

Installation #

Add this to your package's pubspec.yaml file:

dependencies:
  geo_currencies: ^0.0.5

Usage #

Import the package in your Dart code:

import 'package:geo_currencies/geo_currencies.dart';

The GeoCurrencies class is implemented as a interface, with a factory constructor that returns different instance by optional GeoCurrenciesType given, by default the GeoCurrenciesType is live.

For some tests in your code your can do:

final GeoCurrencies geoCurrencies = GeoCurrencies(
    config: GeoCurrenciesConfig(
        geoCurrenciesType: GeoCurrenciesType.fake,
        decimalDigits: 2,
        decimalSeparator: '.',
        includeSymbol: true,
        symbolSeparator: ' ',
        locale: Locale('En', 'en'),
        thousandSeparator: ','),
  );

For live implementation in your code your can do:

final GeoCurrencies geoCurrencies = GeoCurrencies(
    config: GeoCurrenciesConfig(
        geoCurrenciesType: GeoCurrenciesType.live,
        decimalDigits: 2,
        decimalSeparator: '.',
        includeSymbol: true,
        symbolSeparator: ' ',
        locale: Locale('En', 'en'),
        thousandSeparator: ','),
  );

formatAmountWithCurrencySymbol #

  String amountToDisplay = geoCurrencies.formatAmountWithCurrencySymbol(
    amount: 10,
    currencyCodeAlpha3: 'USD',
  );

Responses #

Output: $ 10

formatAmountWithCurrencySymbol #

  String amountToDisplay = geoCurrencies.formatAmountWithCurrencyCode(
    amount: 10,
    currencyCodeAlpha3: 'USD',
  );

Responses #

Output: USD 10

getCurrencyDataByCoordinate #

  CurrencyData? currencyData = await geoCurrencies.getCurrencyDataByCoordinate(
    latitude: 37.4219999,
    longitude: 32.0840575,
  );

Responses #

CurrencyData is a class that represents a currency and its details. It has the following attributes:

convertAmountWithCurrenciesCodes #

  Future<ConversionData?> convertAmountWithCurrenciesCodes({
    required num amount,
    required String fromCurrencyCodeIso4217,
    required String toCurrencyCodeIso4217,
  });

Responses #

ConversionData is a class that represents a conversion data and its details. It has the following attributes:

getRate #

  Future<RateData?> getRate({
    required String fromCurrencyCodeIso4217,
    required String toCurrencyCodeIso4217,
  });

Responses #

RateData is a class that represents a rate data and its details. It has the following attributes:

getRate #

  AmountConvertedData convertAmountWithRate({
    required num amount,
    required num rate,
    required String toCurrencyCodeIso4217,
  });

Responses #

AmountConvertedData is a class that represents a amount converted data and its details. It has the following attributes:

Dependencies #

http: ^1.1.0
intl: ^0.19.1
logging: ^1.0.2

Additional information #

the library uses the following APIs:

• EXCHANGE RATE API DOCUMENTATION
• EXCHANGE RATE API TERMS
• WIKIPEDIA ISO 4217