Flutter 地图服务插件 neom_maps_services 的使用

通用信息

这是一个用于 Google 地图服务的 Dart 库。你可以在这里找到 Google 地图平台文档，但如果你是新手，可以从这里开始：Google 地图入门指南。

API 密钥

要使用此库，你需要一个 Web API 密钥。请按照以下步骤获取与你的 Dart 应用程序相关的密钥：获取 Places Web 服务 API 密钥。

这些密钥不能单独作为 Android 或 iOS API 密钥使用，而是应该在你的 Dart 应用程序中使用。

可用的 API

• ✅ Geocoding API
• ❌ Places API
  • ✅ 附近搜索
  • ✅ 文本搜索
  • ✅ 详情
  • ❌ 添加
  • ❌ 删除
  • ✅ 照片
  • ✅ 自动完成
  • ✅ 查询自动完成
• ✅ Directions API
• ✅ Distance Matrix API
• ❌ Geolocation API
• ❌ Elevation API
• ❌ Roads API
• ✅ Timezone API
• ✅ Static Map API

使用方法

Geocoding

import "package:google_maps_webservice/geocoding.dart";

final geocoding = GoogleMapsGeocoding(apiKey: "<API_KEY>");
final geocoding = GoogleMapsGeocoding(apiKey: "<API_KEY>", httpClient: BrowserClient());
final geocoding = GoogleMapsGeocoding(baseUrl: "http://myProxy.com");

// 搜索地址
GeocodingResponse response = await geocoding.searchByAddress("1600 Amphitheatre Parkway, Mountain View, CA");

Places

import "package:google_maps_webservice/places.dart";

final places = GoogleMapsPlaces(apiKey: "<API_KEY>");
final places = GoogleMapsPlaces(apiKey: "<API_KEY>", httpClient: BrowserClient());
final places = GoogleMapsPlaces(baseUrl: "http://myProxy.com");

// 搜索附近的地点
PlacesSearchResponse response = await places.searchNearbyWithRadius(Location(lat: 31.0424, lng: 42.421), 500);

// 按距离排序搜索附近的地点
PlacesSearchResponse response = await places.searchNearbyWithRankby(Location(lat: 31.0424, lng: 42.421), "distance");

// 搜索特定文本
PlacesSearchResponse response = await places.searchByText("123 Main Street");

// 获取地点详细信息
PlacesDetailsResponse response = await places.getDetailsByPlaceId("PLACE_ID");
PlacesDetailsResponse response = await places.getDetailsByReference("REF");

Timezone

import "package:google_maps_webservice/timezone.dart";

final timezone = GoogleMapsTimezone(apiKey: "<API_KEY>");
final timezone = GoogleMapsTimezone(apiKey: "<API_KEY>", httpClient: BrowserClient());
final timezone = GoogleMapsTimezone(baseUrl: "http://myProxy.com");

// 获取指定位置的时区信息
TimezoneResponse response = await timezone.getByLocation(Location(lat: 31.0424, lng: 42.421));

// 获取指定位置和时间戳的时区信息
TimezoneResponse response = await timezone.getByLocation(Location(lat: 31.0424, lng: 42.421), timestamp: DateTime.utc(2019, 4, 24));

// 获取指定位置、时间戳和语言的时区信息
TimezoneResponse response = await timezone.getByLocation(Location(lat: 31.0424, lng: 42.421), timestamp: DateTime.utc(2019, 4, 24), language: 'es');

Static Map

import "package:google_maps_webservice/staticmaps.dart";

final mapStatic = StaticMap(
  apiKey,
  markers: List.from([
    Location(lat: 23.721160, lng: 90.394435),
    Location(lat: 23.732322, lng: 90.385142),
  ]),
  path: Path(
    enc: 'svh~F`j}uOusC`bD', // 编码后的路径
    color: 'black',
  ),
  scale: 'false' // 是否缩放
);

String url = mapStatic.getUrl();

Image.network(url)

代理

如果需要通过代理服务器使用该库，可以通过设置 baseUrl 来实现。如果代理服务器已经设置了 apiKey，则无需在应用中存储 apiKey。（不在应用中存储 apiKey 是一种良好的实践）

完整示例

Directions API

import 'package:flutter/material.dart';
import 'package:google_maps_webservice/src/core.dart';
import 'package:google_maps_webservice/src/directions.dart';

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

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(title: Text('Directions Example')),
        body: DirectionsExample(),
      ),
    );
  }
}

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

class _DirectionsExampleState extends State<DirectionsExample> {
  late GoogleMapsDirections directions;
  late Future<DirectionsResult> futureDirections;

  [@override](/user/override)
  void initState() {
    super.initState();
    final googleMaps = GoogleMapsDirections(apiKey: "<API_KEY>");
    directions = googleMaps;
    futureDirections = getDirections();
  }

  Future<DirectionsResult> getDirections() async {
    return await directions.query(
      origin: Location(lat: 37.361764, lng: -122.020398),
      destination: Location(lat: 37.365524, lng: -122.025129),
    );
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return FutureBuilder<DirectionsResult>(
      future: futureDirections,
      builder: (context, snapshot) {
        if (snapshot.hasData) {
          final result = snapshot.data!;
          return Column(
            children: [
              Text(result.status),
              Expanded(
                child: ListView.builder(
                  itemCount: result.routes?.length ?? 0,
                  itemBuilder: (context, index) {
                    final route = result.routes![index];
                    return ListTile(
                      title: Text(route.summary ?? ''),
                      subtitle: Text(route.distance.text ?? ''),
                    );
                  },
                ),
              ),
            ],
          );
        } else if (snapshot.hasError) {
          return Center(child: Text(snapshot.error.toString()));
        }
        return Center(child: CircularProgressIndicator());
      },
    );
  }
}

Places API

import 'package:flutter/material.dart';
import 'package:google_maps_webservice/src/places.dart';

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

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(title: Text('Places Example')),
        body: PlacesExample(),
      ),
    );
  }
}

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

class _PlacesExampleState extends State<PlacesExample> {
  late GoogleMapsPlaces places;
  late Future<PlacesSearchResponse> futurePlaces;

  [@override](/user/override)
  void initState() {
    super.initState();
    places = GoogleMapsPlaces(apiKey: "<API_KEY>");
    futurePlaces = searchNearby();
  }

  Future<PlacesSearchResponse> searchNearby() async {
    return await places.searchNearbyWithRankby(
      Location(lat: 37.361764, lng: -122.020398),
      "distance",
    );
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return FutureBuilder<PlacesSearchResponse>(
      future: futurePlaces,
      builder: (context, snapshot) {
        if (snapshot.hasData) {
          final result = snapshot.data!;
          return ListView.builder(
            itemCount: result.results?.length ?? 0,
            itemBuilder: (context, index) {
              final place = result.results![index];
              return ListTile(
                title: Text(place.name ?? ''),
                subtitle: Text(place.vicinity ?? ''),
              );
            },
          );
        } else if (snapshot.hasError) {
          return Center(child: Text(snapshot.error.toString()));
        }
        return Center(child: CircularProgressIndicator());
      },
    );
  }
}

Timezone API

import 'package:flutter/material.dart';
import 'package:google_maps_webservice/src/timezone.dart';

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

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(title: Text('Timezone Example')),
        body: TimezoneExample(),
      ),
    );
  }
}

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

class _TimezoneExampleState extends State<TimezoneExample> {
  late GoogleMapsTimezone timezone;
  late Future<TimezoneResponse> futureTimezone;

  [@override](/user/override)
  void initState() {
    super.initState();
    timezone = GoogleMapsTimezone(apiKey: "<API_KEY>");
    futureTimezone = getTimezone();
  }

  Future<TimezoneResponse> getTimezone() async {
    return await timezone.getByLocation(
      Location(lat: 37.361764, lng: -122.020398),
      timestamp: DateTime.utc(2019, 4, 24),
    );
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return FutureBuilder<TimezoneResponse>(
      future: futureTimezone,
      builder: (context, snapshot) {
        if (snapshot.hasData) {
          final result = snapshot.data!;
          return Center(
            child: Text(result.timeZoneId ?? ''),
          );
        } else if (snapshot.hasError) {
          return Center(child: Text(snapshot.error.toString()));
        }
        return Center(child: CircularProgressIndicator());
      },
    );
  }
}

Static Map API

import 'package:flutter/material.dart';
import 'package:google_maps_webservice/src/staticmaps.dart';

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

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(title: Text('Static Map Example')),
        body: StaticMapExample(),
      ),
    );
  }
}

class StaticMapExample extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    final mapStatic = StaticMap(
      apiKey,
      markers: List.from([
        Location(lat: 23.721160, lng: 90.394435),
        Location(lat: 23.732322, lng: 90.385142),
      ]),
      path: Path(
        enc: 'svh~F`j}uOusC`bD',
        color: 'black',
      ),
      scale: 'false',
    );

    final url = mapStatic.getUrl();

    return Center(
      child: Image.network(url),
    );
  }
}