Google Sheets与Leaflet同步失败求助：共享设置疑存问题

我之前也碰到过类似的坑，大概率是共享/发布设置的细节没做对，或者Tabletop的配置有小疏漏，咱们一步步排查：

一、先把Google Sheets的权限设置拉满 #

这是最容易踩的坑，别只看表面的「共享到网络」，要做两个关键操作：

• 强制设置链接权限为「任何人可查看」：
  打开你的Sheet，右上角点「共享」，把权限从「仅限邀请」切换成「任何人有链接」，权限级别必须选「查看者」。只开「分享到网络」没用，这个和链接权限是分开的设置。
• 必须完成「发布到网络」：
  点击菜单栏「文件」→「发布到网络」，选择你要加载的工作表（多Sheet的话别选错），格式选「网页」，然后点击「发布」。Tabletop本质是读取这个公开的发布数据源，只开共享链接可能会被Google拦截。

  小贴士：发布后别立刻测试，等个1-2分钟让Google同步数据，有时候会有延迟。

二、简化Tabletop的配置，避免URL格式问题 #

你用的完整编辑链接其实没必要，Tabletop支持直接用Sheet ID，反而更稳定：

function init() {
  Tabletop.init({
    key: '1yH4TpDwIJB7v2nZqS7WHl_E11_-Gcdo4fwzckXGpuDY', // 只保留Sheet的ID部分
    callback: addPoints,
    simpleSheet: true
  })
}
init()

如果你的数据不在第一个工作表，记得去掉simpleSheet: true，改用sheet参数指定表名：

Tabletop.init({
  key: '你的Sheet ID',
  callback: addPoints,
  sheet: '数据工作表' // 替换成你的工作表名称
})

三、加调试代码，直接看问题出在哪 #

如果还是没数据，给代码加个日志和错误回调，打开浏览器控制台（F12）就能直观看到问题：

function addPoints(data, tabletop) {
  console.log('拿到的数据：', data); // 先打印数据，看有没有加载到
  if (data.length === 0) {
    console.error('没有数据！检查Sheet权限或配置');
    return;
  }
  // 你的Leaflet标记添加代码...
}

function init() {
  Tabletop.init({
    key: '你的Sheet ID',
    callback: addPoints,
    simpleSheet: true,
    error: function(error) {
      console.error('Tabletop加载失败：', error); // 捕获错误信息
    }
  })
}

如果控制台显示「跨域错误」，说明你是本地直接打开HTML文件（file://协议），换用本地服务器打开就行——比如用Python跑python -m http.server，或者VS Code的Live Server插件。

四、最后核对细节 #

• 确保Sheet的列名和代码里的字段完全一致（大小写敏感！），比如代码用row.latitude，Sheet列名就不能是「纬度」或者Latitude；
• 检查数据格式：纬度/经度必须是数字，别加单位或者多余字符。

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