Flutter地理编码与反地理编码插件geocoder_buddy的使用

特性

• 易于使用
• 快速且安全
• 无需API密钥
• 更详细的数据
• 无需API密钥即可搜索位置

开始使用

在终端中运行以下命令以安装插件：

flutter pub add geocoder_buddy

搜索位置

使用GBSearchData类来查询位置：

// GBSearchData 类由 geocoder_buddy 提供
List<GBSearchData> data = await GeocoderBuddy.query(query);

GBSearchData 类

int placeId;
int id;
List<String> boundingbox;
String lat;
String lon;
String displayName;
int placeRank;
double importance;

将 GBSearchData 转换为 GBData

使用searchToGBData方法将GBSearchData转换为GBData：

// GBData 类由 geocoder_buddy 提供
GBData data = await GeocoderBuddy.searchToGBData(GBSearchData data);

根据经纬度获取详细信息

通过纬度和经度获取位置详细信息：

GBLatLng position = GBLatLng(38.8951,-77.0364);
GBData data = await GeocoderBuddy.findDetails(position);

GBData 类

int placeId;
String osmType;
int id;
String lat;
String lon;
int placeRank;
double importance;
String displayName;
Address address; // 由 geocoder_buddy 提供
List<String> boundingbox;

Address 类

String road;
String village;
String county;
String stateDistrict;
String state;
String iso31662Lvl4;
String postcode;
String country;
String countryCode;

示例代码

以下是完整的示例应用，展示如何使用 geocoder_buddy 插件进行地理编码和反地理编码。

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

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

class MyApp extends StatelessWidget {
  const MyApp({Key? key}) : super(key: key);

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Geocoder Buddy Example',
      theme: ThemeData(
        useMaterial3: true,
        primarySwatch: Colors.blue,
      ),
      home: const MyHomePage(title: 'Geocoder Buddy Example'),
    );
  }
}

class MyHomePage extends StatefulWidget {
  const MyHomePage({Key? key, required this.title}) : super(key: key);

  final String title;

  @override
  State<MyHomePage> createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  final searchTextController = TextEditingController();
  final latTextController = TextEditingController();
  final lngTextController = TextEditingController();
  List<GBSearchData> searchItem = [];
  Map<String, dynamic> details = {};
  bool isSearching = false;
  bool isLoading = false;

  void searchLocation(String query) async {
    setState(() {
      isSearching = true;
    });
    List<GBSearchData> data = await GeocoderBuddy.query(query);
    setState(() {
      isSearching = false;
      searchItem = data;
    });
  }

  getAddressDetails(GBLatLng pos) async {
    setState(() {
      isLoading = true;
    });
    GBData data = await GeocoderBuddy.findDetails(pos);
    setState(() {
      isLoading = false;
      details = data.toJson();
    });
    print(data.address.village);
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
        appBar: AppBar(
          title: Text(widget.title),
        ),
        body: SingleChildScrollView(
          child: Column(
            children: [
              const SizedBox(height: 10),
              Text("Search Location", style: Theme.of(context).textTheme.headline3),
              Container(
                padding: const EdgeInsets.all(20),
                child: TextField(
                  controller: searchTextController,
                  decoration: const InputDecoration(
                      hintText: "Search Location",
                      border: OutlineInputBorder()),
                ),
              ),
              ElevatedButton(
                  onPressed: () {
                    if (searchTextController.text.isNotEmpty) {
                      searchLocation(searchTextController.text);
                    } else {
                      ScaffoldMessenger.of(context).showSnackBar(const SnackBar(content: Text("Please Enter Location")));
                    }
                  },
                  child: const Text("Search")),
              SizedBox(
                height: 300,
                child: !isSearching
                    ? ListView.builder(
                        itemCount: searchItem.length,
                        itemBuilder: (context, index) {
                          var item = searchItem[index];
                          return ListTile(
                            onTap: () {
                              // Navigate to detail page if needed
                            },
                            title: Text(item.displayName),
                          );
                        })
                    : const Center(child: CircularProgressIndicator()),
              ),
              const SizedBox(height: 20),
              Text("Lat/Lng to Details", style: Theme.of(context).textTheme.headline3),
              Container(
                padding: const EdgeInsets.all(20),
                child: TextField(
                  controller: latTextController,
                  decoration: const InputDecoration(hintText: "Latitude", border: OutlineInputBorder()),
                ),
              ),
              Container(
                padding: const EdgeInsets.all(20),
                child: TextField(
                  controller: lngTextController,
                  decoration: const InputDecoration(hintText: "Longitude", border: OutlineInputBorder()),
                ),
              ),
              ElevatedButton(
                  onPressed: () {
                    if (latTextController.text.isNotEmpty && lngTextController.text.isNotEmpty) {
                      GBLatLng pos = GBLatLng(lat: double.parse(latTextController.text), lng: double.parse(lngTextController.text));
                      getAddressDetails(pos);
                    } else {
                      ScaffoldMessenger.of(context).showSnackBar(const SnackBar(content: Text("Please Enter Lat/Lng")));
                    }
                  },
                  child: const Text("Get Details")),
              const SizedBox(height: 20),
              SizedBox(
                height: 300,
                child: !isLoading
                    ? ListView.builder(
                        itemCount: details.keys.length,
                        itemBuilder: (context, index) {
                          var key = details.keys.elementAt(index);
                          return ListTile(
                            title: Text("$key: ${details[key]}"),
                          );
                        })
                    : const Center(child: CircularProgressIndicator()),
              ),
              const SizedBox(height: 20),
            ],
          ),
        ));
  }
}

以上是完整的示例代码，展示了如何使用 geocoder_buddy 插件进行地理编码和反地理编码。希望这些内容能帮助您更好地理解和使用该插件。