RAD Studio 10.4.1 下TMapView如何关联Map ID使用自定义样式地图

之前配置失效的核心原因 #

• 你往AndroidManifest里加的com.google.android.maps.v2.MAP_ID meta-data完全不生效：一方面这个键名本身就不是谷歌Android Maps SDK原生识别的配置项，另一方面10.4.1版本的TMapView封装层根本没实现读取这类meta-data的逻辑，不管填什么值都不会被组件读取。
• 你参考Web JS SDK的传参逻辑套到Android原生端是方向错了：JS端的Map ID是作为URL查询参数传入的，Android原生SDK的Map ID需要通过运行时API设置，不能静态写在清单里。
• 10.4.1版本的TMapView没有暴露公开的Map ID设计时属性，所有静态配置路径在这个版本上都是走不通的，必须走运行时调用的路径。
• 如果在GCP创建Map ID时，错误绑定了Web/JS端的样式规则，哪怕后续配置全对，移动端也加载不了对应的自定义样式。

正确的操作流程 #

• 第一步先清掉之前加在自定义AndroidManifest里的无效MAP_ID配置，别留着占位置。
• 打开Google Cloud Console后台，核对你创建的Map ID对应的样式绑定类型是Android地图，不是JS Web端的，改完等5-10分钟让谷歌侧配置同步完成。
• 检查项目的Android依赖版本：打开项目选项 -> 应用商店 -> Android 平台设置，确认play-services-maps的版本不低于18.0.0——Map ID功能是从这个版本的Android Maps SDK才开始支持的，如果是10.4.1自带的老版本依赖，就算写了代码调用方法也会报找不到符号的错，手动把版本改成18.1.0及以上，重新同步SDK依赖。
• 选中界面上的TMapView组件，在事件面板绑定OnMapReady事件，在回调里拿到底层封装的原生GoogleMap实例，调用setMapId方法传入你的Map ID，示例代码如下：

procedure TMainForm.MapView1MapReady(Sender: TObject);
var
  LNativeMap: JGoogleMap;
begin
  // 拿到组件内部封装的原生Google Map对象
  LNativeMap := MapView1.NativeMap as JGoogleMap;
  // 替换成你自己在GCP创建的Map ID字符串
  LNativeMap.setMapId('替换为你的Map_ID值');
end;

容易踩的坑 #

• 别在窗体创建、组件初始化的时候就调用setMapId：这时候底层原生Map还没初始化完，会直接抛空引用，必须等OnMapReady事件触发之后再执行设置。
• 确认你的应用包名、签名文件的SHA1指纹，已经和GCP里配置的API Key的授权范围匹配，不然就算Map ID设置对了，也会因为权限校验不通过 fallback 到默认地图样式。
• 别试图把Map ID拼到API Key的配置字符串里，Map ID和API Key是两个完全独立的配置维度，没有拼接在同一个参数里的逻辑。

内容的提问来源于stack exchange，提问作者Haifisch