目录

创建地图

概览

本章节将向您介绍如何使用地图容器快速地获得地图对象、修改地图类型以及在地图上绘制形状和标记。详情请参见Flutter示例代码。

一般用法

构建HuaweiMap组件,该组件中地图上的特征(例如标记和多边形)可作为子元素使用。提供了一个接口来声明性地控制地图上的特征。

import 'package:huawei_map/map.dart';

地图实例创建

下面介绍如何使用HuaweiMap来创建地图实例。

  1. 在main.dart文件中添加HuaweiMap对象,并设置地图属性。

    HuaweiMap( 
        mapType: MapType.normal, 
        tiltGesturesEnabled: true, 
        buildingsEnabled: true, 
        compassEnabled: true, 
        zoomControlsEnabled: false, 
        rotateGesturesEnabled: true, 
        myLocationButtonEnabled: true, 
        myLocationEnabled: true, 
        trafficEnabled: true, 
        .... 
    )

  2. 运行您的项目以在您的应用中查看地图,如下图所示。

    设置地图上显示的初始位置。对象创建后再修改该属性将不会促使相机位置改变。

    HuaweiMap( 
      initialCameraPosition: CameraPosition( 
        target: const LatLng(41.012959, 28.997438), 
        zoom: 12, 
      ), 
    ...

    或者,您可以使用控制状态并跟踪地图中心点的坐标。

    double _zoom = 12; 
    LatLng _center = const LatLng(41.012959, 28.997438); 
    ... 
    HuaweiMap( 
      initialCameraPosition: CameraPosition( 
        target: _center, 
        zoom: _zoom, 
      ), 
    ...

    详情请参见Flutter示例代码中的文件。

地图类型

目前HuaweiMap支持两种地图类型:

要设置地图类型,可以设置HuaweiMap对象的mapType属性,并传递MapType中定义的枚举值。

如果要设置空地图,请将HuaweiMap对象的mapType属性设置为MapType.none。地图显示效果如图1所示。

示例代码如下:

HuaweiMap( 
    mapType: MapType.none, 
    ... 
)

如果要设置标准地图,请将HuaweiMap对象的mapType属性设置为MapType.normal。地图显示效果如图2所示。

示例代码如下:

HuaweiMap( 
    mapType: MapType.normal, 
    ... 
)
图1 空地图

图2 标准地图

我的位置

我的位置功能允许用户在使用您的应用时获取他们当前所在的位置。在使用该功能之前,请确保您的应用已被授予定位权限。Android操作系统提供两种位置权限:“ACCESS_COARSE_LOCATION”(粗略位置权限)和“ACCESS_FINE_LOCATION”(精确位置权限)。您需要在Manifest文件中声明这些权限。

<!-- 允许应用通过WiFi或基站信号获取用户的大致经纬度坐标。--> 
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/> 
<!-- 允许应用通过GPS芯片从卫星接收位置信息。--> 
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/>

在Manifest文件中添加上述信息后,需要在代码中动态申请这些权限(Android 6.0危险权限要求)。

要启用此功能,请将HuaweiMap对象中的“MyLocationEnabled”设置为true。

示例代码如下:

HuaweiMap( 
    myLocationButtonEnabled: true, 
    myLocationEnabled: true, 
    ...

启用此功能后,地图右下角默认显示“我的位置”图标,且用户当前位置显示为蓝点。当用户点击此图标时,用户的当前位置(如果获得)将显示在屏幕中央。

您也可以在HuaweiMap对象中设置“myLocationButtonEnabled”为false,以隐藏“我的位置”图标。

地图属性设置

详情请参见HuaweiMap属性。

地图填充

华为地图服务是通过模拟相机来实现的。地图相机区域已目标位置为中心进行填充。地图控件(如指南针、缩放图标和我的位置图标等)放置在地图相机区域的边缘。默认情况下,指南针放置在地图相机区域的右上角,缩放图标和我的位置图标放置在地图相机区域的右下角。您可以使用HuaweiMap接口的padding字段设置地图相机区域边界和地图控件之间的填充。

图3 填充后的华为地图