Flutter地点搜索插件 google_places_for_flutter_3 的使用

google_places_for_flutter_3 是一个用于Flutter的插件，它利用Google Maps API来实现一个自动补全地点的TextField。用户在输入时可以自动补全地点，并且还能获取坐标等更多信息。

该插件扩展了 Google Maps for Flutter 插件，并且维护了一个超过三年未更新的包：google_places_for_flutter。

安装

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

dependencies:
  google_places_for_flutter_3: ^1.0.4

或者直接运行以下命令：

flutter pub add google_places_for_flutter_3

使用方法

基本用法

下面是一个简单的示例，展示了如何使用 SearchGooglePlacesWidget 来实现地点搜索功能：

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

class LocationSearchPage extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('地点搜索'),
      ),
      body: Center(
        child: SearchGooglePlacesWidget(
          placeType: PlaceType.address, // 可以选择不同的类型如：PlaceType.cities, PlaceType.geocode, PlaceType.region 等
          placeholder: '请输入地址',
          apiKey: '你的Google Maps API密钥',
          onSearch: (Place place) {},
          onSelected: (Place place) async {
            print('地址: ${place.description}');
          },
        ),
      ),
    );
  }
}

高级用法

下面是一个更复杂的示例，展示了如何结合 GoogleMap 使用 SearchGooglePlacesWidget，并在选择地点后自动移动地图视图：

import 'package:flutter/material.dart';
import 'dart:async';
import 'package:google_maps_flutter/google_maps_flutter.dart';
import 'package:google_places_for_flutter_3/google_places_for_flutter_3.dart';

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

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Demo',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: MyHomePage(title: 'Flutter 地点搜索示例'),
    );
  }
}

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

  [@override](/user/override)
  _MyHomePageState createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  Completer<GoogleMapController> _controller = Completer();

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text(widget.title),
      ),
      body: Stack(
        children: [
          GoogleMap(
            mapType: MapType.normal,
            initialCameraPosition: CameraPosition(
              target: LatLng(39.9042, 116.4074), // 默认位置（北京）
              zoom: 10,
            ),
            onMapCreated: (GoogleMapController controller) {
              _controller.complete(controller);
            },
          ),
          Positioned(
            top: 10,
            left: 10,
            right: 10,
            child: SearchGooglePlacesWidget(
              apiKey: '你的Google Maps API密钥',
              language: 'zh', // 设置为中文语言
              radius: 30000, // 搜索半径
              onSelected: (Place place) async {
                final geolocation = await place.geolocation;

                // 动画移动地图到选定的位置
                final GoogleMapController controller = await _controller.future;
                controller.animateCamera(
                  CameraUpdate.newLatLng(geolocation!.coordinates),
                );
                controller.animateCamera(
                  CameraUpdate.newLatLngBounds(geolocation.bounds, 0),
                );
              },
              onSearch: (Place place) {},
            ),
          ),
        ],
      ),
    );
  }
}