Android 11及以上设备加载Google Maps JavaScript API无回调报错求助

问题核心 #

你遇到的报错是因为加载Google Maps JavaScript API的URL缺少必填的callback参数，该参数用于指定API加载完成后执行的初始化函数，这是API v3的强制要求，在Android 11+的WebView环境下会严格校验这个参数。

具体解决步骤 #

• 修改API加载URL：在现有URL末尾添加&callback=你的初始化函数名，同时建议将HTTP协议换成HTTPS，并移除已废弃的sensor=false参数，示例如下：

  https://maps.googleapis.com/maps/api/js?v=3&libraries=geometry&key=你的API密钥&callback=initMap
  

  注意替换你的API密钥为实际的Google Cloud API密钥，initMap是你要定义的初始化函数名称（可自定义）。

• 定义对应回调函数：在页面的JavaScript代码中实现这个回调函数，用于初始化地图及相关操作，示例代码：

  function initMap() {
      // 初始化地图实例
      const mapElement = document.getElementById('map');
      const map = new google.maps.Map(mapElement, {
          center: { lat: 39.9042, lng: 116.4074 }, // 示例坐标（北京）
          zoom: 12
      });
      // 这里可以添加标记、图层等其他地图功能逻辑
  }
  

额外注意事项 #

• Android 11+的WebView限制了混合内容加载，确保你的页面和API请求都使用HTTPS协议，避免加载被拦截。
• 确认你的API密钥已在Google Cloud控制台启用了Google Maps JavaScript API，并且配置了正确的应用限制（如对应的Android包名或网站域名），防止因权限问题导致加载失败。

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