heyhip_amap #

一个基于 Flutter Plugin 的高德地图插件，支持 Android / iOS，面向真实业务场景封装。

功能特性 #

• ✅ 跨平台支持：Android / iOS 原生高德地图集成
• 🗺️ 核心功能：
  • 地图展示 & 相机控制
  • Marker 添加与点击交互
  • Marker InfoWindow（气泡，可开关）
  • Marker 聚合（Cluster）
• 🔍 搜索能力：
  • 周边 POI 搜索（经纬度）
  • 关键字 POI 搜索（文本搜索）
  • 搜索结果字段对齐（Android/iOS 统一 distance/type 字段）
  • 支持分页查询
• ⚡ 优化特性：
  • 地图未 ready 时操作自动缓存
  • 仅支持arm64-v8a

打包 #

--split-per-abi 除arm64-v8a其他不可用

快速开始 #

初始化配置 #

// 设置高德Key 
HeyhipAmap.initKey(
  androidKey: "YOUR_ANDROID_KEY", 
  iosKey: "YOUR_IOS_KEY"
);
 
// 隐私合规设置 
HeyhipAmap.updatePrivacy(
  hasAgree: true, 
  hasShow: true, 
  hasContains: true
);


Platform Configuration
Android
在 AndroidManifest.xml 中添加以下权限

<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/>
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/>
<uses-permission android:name="android.permission.INTERNET"/>
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>


高德 Key 配置

<meta-data
    android:name="com.amap.api.v2.apikey"
    android:value="YOUR_AMAP_KEY"/>


iOS
Info.plist 配置高德 Key
<key>AMapApiKey</key>
<string>YOUR_AMAP_KEY</string>

ios/Podfile文件添加如下
target 'Runner' do
  # use_frameworks!

  # 添加静态
  use_frameworks! :linkage => :static

  flutter_install_all_ios_pods File.dirname(File.realpath(__FILE__))
  target 'RunnerTests' do
    inherit! :search_paths
  end
end

Basic Usage
创建 Controller

HeyhipAmapController? mapController;



定位
final has = await HeyhipAmap.hasLocationPermission();
   
if (has) {
  final res = await HeyhipAmap.getCurrentLocation();
} else {
  HeyhipAmap.requestLocationPermission();
}


地图打点
final List<HeyhipMarker> markers = [
    HeyhipMarker(
      id: 'marker_1',
      latitude: 30.482251,
      longitude: 104.080003,
      icon: MarkerIcon.asset('assets/images/point.png', width: 600, height: 600),
      popup: HeyhipMarkerPopup(
        title: "标题",
        subtitle: "副标题",
        avatar: "xxx",
      ),
    ),
    HeyhipMarker(
      id: 'marker_2',
      latitude: 30.482351,
      longitude: 104.080103,
      icon: MarkerIcon.asset('assets/images/point.png', width: 600, height: 600),
    ),
];

HeyhipAmapView(
  latitude: 31.2304,
  longitude: 121.4737,
  zoom: 14,
  controller: controller,
  clusterEnabled: true,
  enableMarkerPopup: true,
  onMapCreated: (controller) {
      mapController = controller;

      mapController?.setMarkers(markers);

      mapController.moveCamera(
        CameraPosition(
          target: LatLng(31.2304, 121.4737),
          zoom: 16,
        ),
      );

      mapController.searchPoisByLatLng(
        LatLng(31.2304, 121.4737),
        radius: 1000,
        page: 1,
        pageSize: 20,
      );


      mapController.searchPoisByText(
        '咖啡',
        city: '上海',
        page: 1,
        pageSize: 20,
      );


    },
              
)