Flutter UI风格插件flutter_photon的使用

Flutter UI风格插件flutter_photon的使用

flutter_photon

flutter_photon 是一个用于 Dart/Flutter 的库，封装了 Komoot 的 Photon API。它支持前向和反向地理编码以及边输入边搜索的功能。

Photon 是由 Komoot 提供的一个免费且开源的 API，由 ElasticSearch 驱动。它返回来自 OpenStreetMap 项目的数据，这些数据遵循 ODbL 许可证。

重要提示：请遵守 Photon 的使用条款！它是免费使用的，请公平使用，避免过多请求！

使用方法

前向地理编码

import 'package:flutter_photon/flutter_photon.dart';

void main() async {
  // 创建 PhotonApi 实例
  final api = PhotonApi();
  
  // 执行前向地理编码搜索
  final results = await api.forwardSearch('munich'); // 搜索“慕尼黑”
  
  // 结果将包含与“慕尼黑”相关的地理位置信息
}

反向地理编码

import 'package:flutter_photon/flutter_photon.dart';

void main() async {
  // 创建 PhotonApi 实例
  final api = PhotonApi();
  
  // 执行反向地理编码搜索
  final results = await api.reverseSearch(48.123, 11.321); // 给定纬度和经度
  
  // 结果将包含给定坐标位置的相关信息
}

自托管实例（自定义 URL）

void main() async {
  // 创建 PhotonApi 实例，并指定自定义的 API URL
  final api = PhotonApi(baseUrl: 'https://example.com/api');
  
  // 这样可以连接到您自己托管的 Photon API 实例
}

您可以查看更多的 API 使用示例，通过查看测试文件中的例子来了解如何使用该 API。

特性和错误

如果您发现任何功能需求或错误，请随时打开一个新的问题！我们始终乐于改进这个包。

贡献

欢迎提交拉取请求并帮助改进这个包！

完整示例 Demo

以下是一个完整的示例代码，展示了如何使用 flutter_photon 包进行前向和反向地理编码：

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

void main() => runApp(MyApp());

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Photon Example',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: MyHomePage(),
    );
  }
}

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

class _MyHomePageState extends State<MyHomePage> {
  String _forwardResult = '';
  String _reverseResult = '';

  void _performForwardSearch() async {
    final api = PhotonApi();
    final results = await api.forwardSearch('munich');
    
    setState(() {
      if (results.isNotEmpty) {
        _forwardResult = '结果: ${results[0].name}'; // 显示第一个结果的名字
      } else {
        _forwardResult = '没有找到结果';
      }
    });
  }

  void _performReverseSearch() async {
    final api = PhotonApi();
    final results = await api.reverseSearch(48.5, 11.5);
    
    setState(() {
      if (results.isNotEmpty) {
        _reverseResult = '结果: ${results[0].name}'; // 显示第一个结果的名字
      } else {
        _reverseResult = '没有找到结果';
      }
    });
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Flutter Photon Example'),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: <Widget>[
            ElevatedButton(
              onPressed: _performForwardSearch,
              child: Text('前向地理编码搜索 "慕尼黑"'),
            ),
            SizedBox(height: 20),
            Text(_forwardResult),
            SizedBox(height: 40),
            ElevatedButton(
              onPressed: _performReverseSearch,
              child: Text('反向地理编码搜索 (48.5, 11.5)'),
            ),
            SizedBox(height: 20),
            Text(_reverseResult),
          ],
        ),
      ),
    );
  }
}