使用Google Maps API：nearbySearch返回20条结果，getDetails仅返回9条

兄弟我之前也踩过类似的坑！你遇到的这个情况，大概率是这几个原因导致的，咱们一个个排查：

1. API请求速率/配额限制 #

Google Maps API对请求频率有严格限制，尤其是getDetails这类接口。你一口气连发20个请求，很容易触发短期速率限制（比如每秒最多5个请求），直接被API拦截掉一部分，自然拿不到完整结果。

解决办法： #

给请求加个间隔，用异步队列控制发送节奏。比如每500ms发一个请求，避免触发限流。用async/await结合setTimeout就能轻松实现：

async function fetchDetails(placeIds) {
  const results = [];
  for (const placeId of placeIds) {
    try {
      await new Promise(resolve => setTimeout(resolve, 500)); // 加延迟控制请求节奏
      const place = await new Promise((resolve, reject) => {
        service.getDetails({ placeId: placeId, fields: ['name', 'rating', 'reviews'] }, (result, status) => {
          if (status === google.maps.places.PlacesServiceStatus.OK) {
            resolve(result);
          } else {
            reject(`获取详情失败: ${status}`);
          }
        });
      });
      results.push(place);
    } catch (err) {
      console.error(err);
    }
  }
  return results;
}

2. 部分POI无可用详情数据 #

nearbySearch返回的结果里，有些小商家或者冷门地点可能根本没有评分、评论这类详情数据，调用getDetails时API会返回ZERO_RESULTS或者NOT_FOUND状态，自然不会计入你的有效结果。

解决办法： #

在getDetails的回调里加上状态判断，打印失败的请求信息，就能知道哪些地点没数据了：

service.getDetails({ placeId: placeId }, (result, status) => {
  if (status === google.maps.places.PlacesServiceStatus.OK) {
    // 处理有效结果
  } else {
    console.log(`地点 ${placeId} 获取详情失败，状态: ${status}`);
    // 可以在这里记录失败的ID，后续排查
  }
});

3. 异步请求并发冲突 #

如果是用普通循环直接触发20个异步请求，浏览器的并发连接限制（一般是6-8个）会导致后面的请求排队，甚至超时失败。加上API本身的限流，双重打击下就会丢结果。

解决办法： #

上面提到的异步队列（逐个发送请求）就能解决这个问题，避免并发过多。

4. 请求参数遗漏错误 #

现在Google Maps API要求显式指定需要返回的字段，如果调用getDetails时没指定fields参数，可能导致部分请求异常（虽然官方示例可能没写，但这个细节很容易忽略）。

解决办法： #

调用时明确指定需要的字段，比如只拿评分和评论：

service.getDetails({
  placeId: placeId,
  fields: ['rating', 'reviews', 'name'] // 按需指定字段，减少无效请求
}, callback);

你可以先在控制台打印每个getDetails的status值，看看是哪些请求失败了，对应上面的原因就能快速定位问题啦！

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