Flutter高级谷歌地图地点搜索插件google_maps_place_search_advance的使用

Flutter高级谷歌地图地点搜索插件google_maps_place_search_advance的使用

Pub Dev

Custom Google搜索地点自动完成小部件,带有地标图像和距离计算。

开始使用

google_maps_place_search_advance 提供了对 Google 地点自动完成搜索和地标图像的程序化访问,并且还提供了与设备当前位置的距离。

特性

帮助您的客户探索他们所在的位置及周围环境:

  • 地点自动完成功能会根据用户输入自动填充地点名称和/或地址。
  • 地点定位器可以给出相对于当前位置的距离。
  • 地点照片返回高质量的地点图像。

安装

添加依赖项

您可以使用以下命令添加 google_maps_place_search_advance 作为依赖项(使用最新稳定版本):

$ dart pub add google_maps_place_search_advance

或者,您可以在 pubspec.yaml 文件的 dependencies 部分手动添加 google_maps_place_search_advance:

dependencies:
  google_maps_place_search_advance: ^replace-with-latest-version

添加图标以使包正常工作,需要在 flutter 部分添加资产:

flutter:
  # To add assets to your package, add an assets section, like this:
  assets:
    - assets/search.png

最新版本:
Pub
最新版本(包括预发布版本):
Pub

在升级之前:主版本和次版本可能会发生破坏性更改。
请参阅[迁移指南][迁移指南]获取完整的破坏性更改列表。

极其简单的使用

import 'package:google_maps_place_search_advance/google_maps_place_search_advance.dart';

class _MyHomePageState extends State<MyHomePage> {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return SafeArea(
      child: Scaffold(
        body: Container(
          child: SingleChildScrollView(
            child: GooglePlaceSearchAdvance(
              googleMapsApiKey: "GOOGLE_MAPS_API_KEY",
              country: "fr",
              iconImagePath: "assets/search.png",
              mapimagePath: "assets/not_image_place.png",
              onLocationSelected: (double lat, double lng, String address, String imageURL){
                print("Coordinates are $lat,$lng");
                print("Address is : $address");
                print("Image URL is: $imageURL");
              },
            ),
          ),
        ),
      ),
    );
  }
}

生成应用密钥

  1. 转到 Google 地图平台 > 凭证页面。
  2. 在凭证页面上,点击创建凭据 > API 密钥。新创建的 API 密钥对话框会显示你刚创建的 API 密钥。
  3. 点击关闭。新的 API 密钥将列在凭证页面下的 API 密钥中。(在生产环境中使用前记得限制 API 密钥。)

开发者详情

GitHub Icon LinkedIn Icon


以下是示例代码:

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

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

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  // This widget is the root of your application.
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Example of Google Maps Place Search Advance Package',
      theme: ThemeData(
        colorScheme: ColorScheme.fromSeed(seedColor: Colors.deepPurple),
        useMaterial3: true,
      ),
      home: const MyHomePage(),
    );
  }
}

class MyHomePage extends StatefulWidget {
  const MyHomePage({super.key});

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

class _MyHomePageState extends State<MyHomePage> {
  FocusNode? focusNode;

  [@override](/user/override)
  void initState() {
    super.initState();
    focusNode = FocusNode();
  }

  [@override](/user/override)
  void dispose() {
    focusNode!.dispose();
    super.dispose();
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return SafeArea(
      child: Scaffold(
        body: Container(
          child: SingleChildScrollView(
            child: GooglePlaceSearchAdvance(
              googleMapsApiKey: "GOOGLE_MAPS_API_KEY",
              lightTheme: false,
              country: "fr",
              iconImagePath: "assets/search.png",
              mapimagePath: "assets/not_image_place.png",
              onLocationSelected: (double lat, double lng, String address, String mainText, String imageURL) {
                print("Coordinates are $lat,$lng");
                print("Address is : $address");
                print("Image URL is: $imageURL");
                print("Main Text is: $mainText");
              },
              focusNode: focusNode!,
            ),
          ),
        ),
      ),
    );
  }
}

更多关于Flutter高级谷歌地图地点搜索插件google_maps_place_search_advance的使用的实战教程也可以访问 https://www.itying.com/category-92-b0.html

1 回复

更多关于Flutter高级谷歌地图地点搜索插件google_maps_place_search_advance的使用的实战系列教程也可以访问 https://www.itying.com/category-92-b0.html


google_maps_place_search_advance 是一个用于 Flutter 的高级 Google 地图地点搜索插件,它允许开发者在其应用中集成 Google 地图的地点搜索功能,并提供自动完成、地点详情、地点照片等功能。以下是如何在 Flutter 项目中使用 google_maps_place_search_advance 插件的详细步骤。

1. 添加依赖

首先,你需要在 pubspec.yaml 文件中添加 google_maps_place_search_advance 插件的依赖:

dependencies:
  flutter:
    sdk: flutter
  google_maps_place_search_advance: ^版本号

注意: 替换 ^版本号 为最新的插件版本号。你可以在 pub.dev 上查找最新版本。

然后运行 flutter pub get 来安装依赖。

2. 获取 Google Places API 密钥

要使用 Google 地图的地点搜索功能,你需要一个 Google Places API 密钥。你可以通过以下步骤获取 API 密钥:

  1. 登录 Google Cloud Console
  2. 创建一个新项目或选择一个已有项目。
  3. 启用 Places APIMaps JavaScript API
  4. API 和服务 -> 凭据 中创建一个新的 API 密钥。

请注意,为了安全,建议你限制 API 密钥的使用范围,并设置 IP 地址或域名限制。

3. 配置 API 密钥

在你的 Flutter 项目中,确保 API 密钥能够被插件访问。你可以通过在 AndroidManifest.xmlInfo.plist 文件中配置 API 密钥,或者直接在代码中传递。

3.1 Android 配置

android/app/src/main/AndroidManifest.xml 文件中添加以下代码:

<meta-data
    android:name="com.google.android.geo.API_KEY"
    android:value="YOUR_API_KEY"/>

3.2 iOS 配置

ios/Runner/Info.plist 文件中添加以下代码:

<key>io.flutter.embedded_views_preview</key>
<true/>
<key>NSLocationWhenInUseUsageDescription</key>
<string>需要访问您的位置以提供基于位置的服务。</string>
<key>NSLocationAlwaysUsageDescription</key>
<string>需要访问您的位置以提供基于位置的服务。</string>
<key>NSLocationAlwaysAndWhenInUseUsageDescription</key>
<string>需要访问您的位置以提供基于位置的服务。</string>
<key>NSAppTransportSecurity</key>
<dict>
    <key>NSAllowsArbitraryLoads</key>
    <true/>
</dict>

4. 使用插件

在你的 Flutter 应用中使用 google_maps_place_search_advance 插件,以下是一个简单的示例:

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

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

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

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

class _PlaceSearchScreenState extends State<PlaceSearchScreen> {
  String? _selectedPlace;

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Place Search'),
      ),
      body: Column(
        children: [
          ElevatedButton(
            onPressed: () async {
              final result = await showSearch<String?>(
                context: context,
                delegate: GooglePlacesAutocomplete(
                  apiKey: 'YOUR_API_KEY',
                  language: 'en',
                  region: 'US',
                ),
              );
              setState(() {
                _selectedPlace = result;
              });
            },
            child: Text('Search Places'),
          ),
          if (_selectedPlace != null)
            Padding(
              padding: const EdgeInsets.all(16.0),
              child: Text('Selected Place: $_selectedPlace'),
            ),
        ],
      ),
    );
  }
}
回到顶部