SuperAPI AI 工具集

google-maps-sdk

编程与开发

查看项目

更新于 10-15 20:31

技能介绍

用途:在移动设备上通过原生 Google Maps SDK 显示地图与叠加层,常用封装为 react-native-maps(Google provider)或项目采用的 Expo Maps 模块;路线与地点数据来自 google-maps-apis。

主要能力:MapView 作为基础;Marker 用于起点、终点、司机与 POI;Polyline 绘制轨迹;Camera/animateToRegion 实现适配边界与跟随用户;Circles/polygons 用于热点与可视化地理围栏;在权限允许时显示用户位置蓝点。

使用方式:在 GCP 启用 Maps SDK for iOS 与 Maps SDK for Android;密钥需限制 bundle ID / SHA-1;按项目模板配置 AppDelegate、AndroidManifest 或 Expo config plugin。Android 使用 Google provider;iOS 上 react-native-maps 默认 Apple Maps,若需一致体验须显式配置 Google。

规则与性能:保持单个稳定 MapView,不要在 GPS 每次更新时重挂载;叠加层使用稳定 key;密钥无效或缺少 Play Services 时提供加载/回退;相机用 fitToCoordinates 加 padding,跟随用户需节流;避免无聚合的数千标记,标记图片要轻量并缓存。样式可用 JSON 实现明暗主题或白标,控件按需开启。

限制与反模式:避免在父组件状态渲染中重建 MapView、使用无应用限制的密钥、未简化超长折线、iOS 未配置就假定 Google provider、忽略 QA 设备上的计费/SDK 错误。完成标准为双端正确渲染、主流程标记与折线正常、相机适配合理、明暗样式一致且位置更新下无重挂载抖动。