STADATA Flutter SDK - Simplified Access to WebAPI BPS

Pub Version (including pre-releases) Pub Points ci Code Coverage codecov Website style: very good analysis Powered by Mason License: MIT Pub Likes Pub Popularity


Description

The STADATA Flutter SDK is a powerful and user-friendly Flutter SDK designed to seamlessly integrate with the official API offered by the Badan Pusat Statistik (BPS) Statistic of the Republic of Indonesia. BPS offers a WebAPI - webapi.bps.go.id/developer/ that allows users to programmatically access various types of data, including Publications, Press Releases, Static Tables, Dynamic Tables, and many more.

This SDK empowers Flutter developers to effortlessly access a wealth of statistical data and information directly from BPS's extensive database, enabling the creation of data-driven applications that provide valuable insights into various aspects of Indonesia's socio-economic landscape.

With STADATA Flutter SDK, you can harness the comprehensive data sets made available by BPS, covering a wide range of domains such as population, economy, demographics, and more. This SDK simplifies the process of fetching, processing, and presenting statistical data within your Flutter apps, ensuring a smooth and efficient user experience by eliminate the need for manual data downloads from the https://www.bps.go.id/.


Key Features

  • Seamless Integration: Easily incorporate BPS Statistic of the Republic of Indonesia's data into your Flutter projects.
  • Rich Data Sources: Access a vast repository of statistical data on Indonesia's diverse economic and demographic aspects.
  • User-Friendly: Designed with developers in mind, making it straightforward to utilize the API's functionalities.
  • Data Insights: Create data-driven applications to provide valuable insights and visualizations to your users.
  • Up-to-Date: Stay current with the latest data releases and updates from BPS.

Unlock the potential of BPS's statistical data with the stadata_flutter_sdk and empower your Flutter applications to provide users with valuable information and insights about Indonesia's dynamic landscape.

For detailed usage instructions and documentation of the BPS API, please refer to the API BPS documentation.


Documentation

For detailed usage instructions and documentation of this package, please refer to the official documentation.


๐Ÿš€ Getting Started

Prerequisites

  • Flutter SDK >=3.7.0 <4.0.0
  • An API key from BPS WebAPI

Installation

Add this package to your pubspec.yaml:

dependencies:
  stadata_flutter_sdk: ^latest_version

Quick Example

import 'package:stadata_flutter_sdk/stadata_flutter_sdk.dart';

// Initialize the SDK
final stadata = StadataFlutter.instance;
await stadata.init(apiKey: 'your_api_key_here');

// Fetch domains
final domains = await stadata.list.domains(
  lang: DataLanguage.id,
  type: DomainType.all,
);

// Fetch publications
final publications = await stadata.list.publications(
  lang: DataLanguage.en,
  domain: '0000',
);

For more detailed examples, check our example app or visit the documentation.


๐Ÿ› ๏ธ Development Status

List API Implementation

Feature Status Description
Domains โœ… Geographic administrative divisions
Publications โœ… BPS publications and reports
Infographics โœ… Statistical infographics
Static Tables โœ… Pre-defined statistical tables
Press Releases โœ… Official press releases
News โœ… Statistical news and updates
News Categories โœ… News categorization
Subject Categories โœ… Statistical subject hierarchies
Subjects โœ… Statistical subjects
Statistical Classifications โœ… KBLI & KBKI classifications
Strategic Indicators โœ… Key performance indicators
Units โœ… Measurement units
Variables โœ… Statistical variables
Vertical Variables โœ… Vertical measurement variables
Census Data โœ… Census information and datasets
Dynamic Tables โœ… Dynamic statistical tables
Glossary ๐Ÿ”„ Statistical terms glossary
Foreign Trade ๐Ÿ”„ Export/import statistics
SDGs Data ๐Ÿ”„ Sustainable Development Goals

View API Implementation

Feature Status Description
Publications โœ… Detailed publication view
Static Tables โœ… Detailed table view
Press Releases โœ… Detailed press release view
News โœ… Detailed news view
News Categories โœ… Category details
Statistical Classifications โœ… Classification details
Dynamic Tables โœ… Dynamic table details

Legend: โœ… Complete | ๐Ÿ”„ In Progress | โŒ Not Started


๐Ÿค Contributing

We welcome contributions from the community! Whether you're fixing bugs, adding features, improving documentation, or helping with translations, your contributions are valuable.

Quick Start for Contributors

  1. ๐Ÿ‘‹ New to Contributing? Read our Contributor Guide | Panduan Kontributor
  2. ๐Ÿ” First Time? Check our Contribution Guidelines
  3. ๐Ÿš€ New Feature? Follow our Feature Development Workflow | Panduan Pengembangan Fitur
  4. ๐Ÿ“‹ GitHub Process? See our GitHub Contribution Workflow | Alur Kontribusi GitHub

Ways to Contribute

  • ๐Ÿ› Bug Reports: Found an issue? Report it here
  • โœจ Feature Requests: Have an idea? Suggest it here
  • ๐Ÿ“ Documentation: Help improve our docs
  • ๐Ÿงช Testing: Write tests to improve coverage
  • ๐ŸŒ Localization: Help translate the example app
  • ๐Ÿ”„ Pending Features: Help implement features marked with ๐Ÿ”„

Good First Issues

Look for issues labeled good first issue - these are perfect for newcomers!

Documentation

Activities

Alt

Libraries

stadata_flutter_sdk
STADATA Flutter SDK - Official Flutter SDK for BPS WebAPI