Flutter地理编码插件geocode的使用

Geocode library

Introduction

geocode包用于执行地理编码请求。它提供了两个方法，可以将坐标转换为位置或将地址转换为坐标。

这是对以下API的基本实现：geocode.xyz。它是免费的，每秒允许一个请求的配额。在上述网站注册以获取API密钥，并将请求数量增加到每秒10个。这些是付费计划，允许每秒更多的请求。有关更多信息，请查看该网站。

Installation

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

dependencies:
  geocode: ^1.0.3

然后运行命令：

flutter pub get

Example

下面是一个完整的示例代码，演示了如何使用geocode插件进行正向地理编码（从地址获取经纬度）和反向地理编码（从经纬度获取地址）：

main.dart

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

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

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: GeoCodeDemo(),
    );
  }
}

class GeoCodeDemo extends StatefulWidget {
  @override
  _GeoCodeDemoState createState() => _GeoCodeDemoState();
}

class _GeoCodeDemoState extends State<GeoCodeDemo> {
  final TextEditingController _addressController = TextEditingController();
  String _latitude = '';
  String _longitude = '';
  String _formattedAddress = '';

  final GeoCode geoCode = GeoCode();

  Future<void> _forwardGeocoding() async {
    try {
      Coordinates coordinates = await geoCode.forwardGeocoding(
        address: _addressController.text,
      );

      setState(() {
        _latitude = coordinates.latitude.toString();
        _longitude = coordinates.longitude.toString();
      });
    } catch (e) {
      print(e);
    }
  }

  Future<void> _reverseGeocoding() async {
    try {
      Address address = await geoCode.reverseGeocoding(
        latitude: double.parse(_latitude),
        longitude: double.parse(_longitude),
      );

      setState(() {
        _formattedAddress = '${address.streetNumber} ${address.streetName}, '
            '${address.city}, ${address.state}, ${address.countryCode}';
      });
    } catch (e) {
      print(e);
    }
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Geocode Demo'),
      ),
      body: Padding(
        padding: const EdgeInsets.all(16.0),
        child: Column(
          children: [
            TextField(
              controller: _addressController,
              decoration: InputDecoration(labelText: 'Enter an address'),
            ),
            SizedBox(height: 10),
            ElevatedButton(
              onPressed: _forwardGeocoding,
              child: Text('Get Coordinates'),
            ),
            SizedBox(height: 20),
            Text('Latitude: $_latitude'),
            Text('Longitude: $_longitude'),
            SizedBox(height: 20),
            ElevatedButton(
              onPressed: () {
                if (_latitude.isNotEmpty && _longitude.isNotEmpty) {
                  _reverseGeocoding();
                }
              },
              child: Text('Get Address'),
            ),
            SizedBox(height: 20),
            Text('Formatted Address: $_formattedAddress'),
          ],
        ),
      ),
    );
  }
}

Methods

• Constructor: GeoCode({this.apiKey})

  • 可选参数apiKey用于设置API密钥。

• Reverse Geocode: Future<Address> reverseGeocoding({double latitude, double longitude})

  • 将一对latitude和longitude坐标转换为实际地址。

• Forward Geocode: Future<Coordinates> forwardGeocoding({String address})

  • 将地址转换为一对latitude和longitude坐标。

Responses

• Reverse Geocode

  Attribute	Type	Description
  elevation	double	海拔高度（米）。
  timezone	String	时区。
  geoNumber	int	地理编号，表示纬度和经度的一个值。附近点将有相似的地理编号。
  streetNumber	int	格式化的街道地址编号。
  streetAddress	String	格式化的街道地址。
  city	String	格式化的城市名称。
  countryCode	String	格式化的国家代码。
  countryName	String	格式化的国家名称。
  region	String	格式化的地区。
  postal	String	格式化的邮政编码。
  distance	double	结果位置与输入位置之间的距离。

• Forward Geocode

  Attribute	Type	Description
  latitude	double	纬度坐标值。
  longitude	double	经度坐标值。

Exceptions

• AccountOutOfCreditsException: 账户已用完信用额度。
• AuthTokenNotFoundException: 未找到身份验证令牌。
• PostalCodeFormatException: 邮政编码格式不正确。
• RequestThrottledException: 请求被限制。
• InvalidQueryException: 提供有效的查询。
• EmptyResultException: 您的请求未产生任何结果。请检查拼写并重试。
• UnknownErrorException: 未知错误。

Dependencies

http: '>=0.13.0 <2.0.0'

License

BSD 3-Clause License

以上就是geocode插件的详细使用说明及示例代码。希望对您有所帮助！如果有任何问题，欢迎随时提问。