Flutter公交API集成插件sg_bus_api的使用

概述

本包允许您在您的Flutter应用中无缝地集成当前的新加坡公交API。以下是该包的功能和用法说明。

功能

• <code>SGBuses.get(_busID)</code>：此方法可以获取指定公交车ID的相关信息，您可以利用这些信息进行其他操作。

开始使用

要开始使用此包，只需导入该包：

import "package:sg_bus_api/src/bus_model.dart"

使用示例

以下是一个完整的示例，展示如何使用sg_bus_api插件来获取并展示新加坡公交车的信息。

示例代码

import 'package:flutter/material.dart';
import 'package:sg_bus_api/src/bus_model.dart';

void main() {
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: Text('新加坡公交API插件示例'),
        ),
        body: Center(
          child: BusInfoWidget(),
        ),
      ),
    );
  }
}

class BusInfoWidget extends StatefulWidget {
  @override
  _BusInfoWidgetState createState() => _BusInfoWidgetState();
}

class _BusInfoWidgetState extends State<BusInfoWidget> {
  String _busInfo = '加载中...';

  @override
  void initState() {
    super.initState();
    // 获取指定公交车ID的信息
    getBusInformation('10');
  }

  Future<void> getBusInformation(String busID) async {
    try {
      // 调用SGBuses.get方法获取公交车信息
      var busData = await SGBuses.get(busID);
      setState(() {
        _busInfo = '公交车ID: ${busData.busId}\n路线: ${busData.route}';
      });
    } catch (e) {
      setState(() {
        _busInfo = '加载失败: $e';
      });
    }
  }

  @override
  Widget build(BuildContext context) {
    return Text(
      _busInfo,
      style: TextStyle(fontSize: 20),
    );
  }
}

说明

1. 导入依赖：

   import 'package:flutter/material.dart';
   import 'package:sg_bus_api/src/bus_model.dart';
   

   这两行代码分别导入了Flutter框架和sg_bus_api包。

2. 主应用类：

   void main() {
     runApp(MyApp());
   }
   
   class MyApp extends StatelessWidget {
     @override
     Widget build(BuildContext context) {
       return MaterialApp(
         home: Scaffold(
           appBar: AppBar(
             title: Text('新加坡公交API插件示例'),
           ),
           body: Center(
             child: BusInfoWidget(),
           ),
         ),
       );
     }
   }
   

   MyApp类定义了应用的基本结构，包括标题栏和主体部分。主体部分显示了一个BusInfoWidget小部件。

3. 获取公交信息：

   class BusInfoWidget extends StatefulWidget {
     @override
     _BusInfoWidgetState createState() => _BusInfoWidgetState();
   }
   
   class _BusInfoWidgetState extends State<BusInfoWidget> {
     String _busInfo = '加载中...';
   
     @override
     void initState() {
       super.initState();
       // 获取指定公交车ID的信息
       getBusInformation('10');
     }
   
     Future<void> getBusInformation(String busID) async {
       try {
         // 调用SGBuses.get方法获取公交车信息
         var busData = await SGBuses.get(busID);
         setState(() {
           _busInfo = '公交车ID: ${busData.busId}\n路线: ${busData.route}';
         });
       } catch (e) {
         setState(() {
           _busInfo = '加载失败: $e';
         });
       }
     }
   
     @override
     Widget build(BuildContext context) {
       return Text(
         _busInfo,
         style: TextStyle(fontSize: 20),
       );
     }
   }