Flutter地图链接跳转插件maplink的使用

Maplink Package

项目用于连接Maplink（SOAP）

在pubspec.yaml文件中添加依赖：

dependencies:
  maplink: <last version>

使用示例

通过邮政编码和门牌号获取地址

final maplink = Maplink("your-token");
final response = await maplink.getAddressByZipcodeAndHouseNumber(
  "03118030", // 邮政编码
  "156", // 门牌号（可选）
);

通过街道名称获取地址

final maplink = Maplink("your-token");
final response = await maplink.getAddressByStreetName(
  state: "SP",
  city: "São Paulo",
  country: "BRA", // ISO 3166-1 alpha-3 国家代码（BRA）
  streetName: "Rua Guaimbé",
  houseNumber: "156", // 门牌号（可选）
);

错误处理

所有错误都继承自Failure类，该类有三个主要属性：

• code: 用于标识错误的代码；
• message: 错误的标准消息；
• innerException: 导致错误的异常。

处理的错误

参数验证

处理Maplink返回结果

完整示例Demo

下面是一个完整的示例代码，展示了如何使用Maplink插件进行地址查询，并处理可能出现的错误。

import 'package:flutter/material.dart';
import 'package:maplink/maplink.dart';

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

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(title: Text('Maplink Demo')),
        body: Center(
          child: MaplinkDemo(),
        ),
      ),
    );
  }
}

class MaplinkDemo extends StatefulWidget {
  [@override](/user/override)
  _MaplinkDemoState createState() => _MaplinkDemoState();
}

class _MaplinkDemoState extends State<MaplinkDemo> {
  String _response = '';
  final Maplink _maplink = Maplink("your-token");

  Future<void> _fetchAddressByZipcodeAndHouseNumber() async {
    try {
      final response = await _maplink.getAddressByZipcodeAndHouseNumber(
        "03118030", // 邮政编码
        "156", // 门牌号（可选）
      );
      setState(() {
        _response = '成功获取地址: ${response}';
      });
    } catch (e) {
      setState(() {
        _response = '获取地址失败: ${e.message}';
      });
    }
  }

  Future<void> _fetchAddressByStreetName() async {
    try {
      final response = await _maplink.getAddressByStreetName(
        state: "SP",
        city: "São Paulo",
        country: "BRA", // ISO 3166-1 alpha-3 国家代码（BRA）
        streetName: "Rua Guaimbé",
        houseNumber: "156", // 门牌号（可选）
      );
      setState(() {
        _response = '成功获取地址: ${response}';
      });
    } catch (e) {
      setState(() {
        _response = '获取地址失败: ${e.message}';
      });
    }
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Column(
      mainAxisAlignment: MainAxisAlignment.center,
      children: [
        ElevatedButton(
          onPressed: _fetchAddressByZipcodeAndHouseNumber,
          child: Text('通过邮政编码和门牌号获取地址'),
        ),
        SizedBox(height: 20),
        ElevatedButton(
          onPressed: _fetchAddressByStreetName,
          child: Text('通过街道名称获取地址'),
        ),
        SizedBox(height: 20),
        Text(_response),
      ],
    );
  }
}