Google Sheets中Maps.newDirectionFinder()加载报错排查求助

1. 报错原因及解决方法 #

原因 #

• API调用频率限制: 即使Workspace总配额未超限，Maps Directions API存在分钟级/秒级的调用频率限制，批量处理数百行时会快速触发该限制，导致部分请求失败。
• 临时网络或API故障: 同一起点/终点偶尔成功偶尔失败，说明存在网络波动或Google Maps服务临时不可用的情况。
• 代码无错误处理: 当API返回无路线结果（如地址无效）时，直接访问directions.routes[0].legs[0]会抛出未定义错误，导致单元格显示"Loading"。

解决方法 #

• 添加错误处理: 在代码中加入try-catch块，并检查路由和路段是否存在：

  function CALCULATE_DRIVING_DISTANCE(origin, destination) {
    if (!origin || !destination) return "参数缺失";
    try {
      var directions = Maps.newDirectionFinder()
        .setOrigin(origin)
        .setDestination(destination)
        .setMode(Maps.DirectionFinder.Mode.DRIVING)
        .getDirections();
      
      if (!directions.routes || directions.routes.length === 0 || !directions.routes[0].legs || directions.routes[0].legs.length === 0) {
        return "无可用路线";
      }
      
      var distance = directions.routes[0].legs[0].distance.value;
      distance /= 1000;
      return Number(distance.toFixed(2));
    } catch (e) {
      Logger.log(`计算失败: 起点=${origin}, 终点=${destination}, 错误=${e.message}`);
      return "计算失败";
    }
  }
  

• 实现缓存机制: 将已计算的起点-终点对及其距离存储在Script Properties或隐藏工作表中，避免重复调用API：

  function CALCULATE_DRIVING_DISTANCE(origin, destination) {
    var cache = CacheService.getScriptCache();
    var key = `${origin}_${destination}`;
    var cachedDistance = cache.get(key);
    
    if (cachedDistance) return Number(cachedDistance);
    
    // 原有计算逻辑...
    // 计算完成后存入缓存，有效期设为1小时（可调整）
    cache.put(key, distance.toFixed(2), 3600);
    return Number(distance.toFixed(2));
  }
  

• 改用批量处理: 避免直接在单元格中使用自定义函数，改为通过菜单触发批量计算，可在调用之间添加延迟：

  function onOpen() {
    SpreadsheetApp.getUi().createMenu("距离计算").addItem("批量计算", "batchCalculate").addToUi();
  }
  
  function batchCalculate() {
    var sheet = SpreadsheetApp.getActiveSheet();
    var data = sheet.getDataRange().getValues();
    
    for (var i = 1; i < data.length; i++) { // 假设第一行是表头
      var origin = data[i][0];
      var destination = data[i][1];
      if (origin && destination) {
        var distance = CALCULATE_DRIVING_DISTANCE(origin, destination);
        sheet.getRange(i+1, 3).setValue(distance);
        Utilities.sleep(1000); // 每次调用间隔1秒，避免触发频率限制
      }
    }
  }
  

2. 获取工作表内运行函数的调试信息 #

• 使用Logger记录: 在函数中加入Logger.log()语句（如上述错误处理中的日志），运行后打开Apps Script编辑器，点击「查看」>「日志」查看记录。注意需在函数运行后立即查看，日志会被新的运行覆盖。
• 写入隐藏工作表: 创建名为「DebugLogs」的隐藏工作表，在函数中写入调试信息：

  function logDebug(message) {
    var logSheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("DebugLogs");
    if (!logSheet) {
      logSheet = SpreadsheetApp.getActiveSpreadsheet().insertSheet("DebugLogs");
      logSheet.hideSheet();
    }
    logSheet.appendRow([new Date(), message]);
  }
  
  // 在CALCULATE_DRIVING_DISTANCE中调用
  logDebug(`处理: 起点=${origin}, 终点=${destination}`);
  

• 使用console.log: 部分情况下，console.log()的内容会出现在Apps Script编辑器的「执行」标签页，但仅当函数通过非单元格公式触发时可见，自定义函数的日志主要依赖Logger或工作表记录。

3. 查看Workspace付费版账单 #

• 登录Google Admin控制台（admin.google.com），需拥有Workspace管理员权限。
• 导航至「计费」>「管理订阅」，即可查看当前订阅详情、使用量及历史账单。若无法访问，需联系企业的Workspace管理员获取权限。

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