Highmaps与Google Sheets集成功能是否失效？官方示例也无法正常加载

我之前也碰到过好几次类似的情况——官方示例一直卡在加载提示、自己的项目拉不到Google Sheets数据，大概率是Google Sheets的权限设置或者发布配置出了问题，咱们一步步排查：

• 检查共享权限是否开放
  你的Google Sheets必须设置为「任何人通过链接均可查看」，如果是仅限特定用户访问，Highmaps的请求会被Google的权限拦截。操作步骤：打开表格右上角的「共享」按钮，将权限改为「知道链接的任何人」，权限级别设为「查看者」。

• 确认表格已发布到网络
  光设置共享还不够，必须把表格发布成公开可访问的CSV格式。操作：点击「文件」>「发布到网络」，选择你要共享的工作表，格式选择「逗号分隔值(.csv)」，然后点击「发布」。Highmaps是通过CSV接口拉取数据的，没发布的话根本拿不到数据。

• 验证数据格式是否合规
  表格第一行必须是清晰的表头（比如国家,数值），而且国家名称要和Highmaps使用的地理编码匹配（比如ISO 3166代码或者标准国名），如果表头缺失、列名混乱或者地理名称不匹配，就算加载了数据也不会在地图上显示。

• 测试CSV链接的可用性
  把发布后生成的CSV链接复制到浏览器地址栏打开，如果能直接看到纯文本的CSV内容或者自动下载文件，说明链接没问题；如果跳转到Google登录页面或者报错，那肯定是权限/发布环节出了问题，回去重新检查。

• 替换官方示例的数据源测试
  官方示例的旧数据源可能因为权限过期失效了，你可以把自己发布好的CSV链接替换到示例代码的data.src字段里，比如：

  data: {
    src: '你的公开CSV链接'
  }
  

  替换后运行看看能不能正常加载数据，这样能快速定位是数据源的问题还是代码的问题。

• 排查Google API的变更
  如果前面的步骤都试过还是不行，可能是Google最近调整了Sheets的API规则（比如废弃旧接口、要求API密钥），可以去Highmaps的官方文档里查下最新的Google Sheets集成说明，确认有没有新增的配置要求。

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