Python中Pandas数据地理编码遇429错误，如何用sleep等方法解决？

阿华AIGC实验室

2026-5-21

嘿，这个问题我之前批量处理地理编码时也踩过坑！Nominatim对请求频率有严格限制（官方建议每秒不超过1次，而且必须带上明确的User-Agent标识你的应用），直接用apply批量调用肯定会触发429错误。下面给你几个实用的解决方案，按从简单到优雅的顺序来：

1. 基础方案：手动添加延迟+异常处理+必填User-Agent

首先，Nominatim会拒绝没有User-Agent的请求，所以第一步必须给定位器设置标识；其次，每次请求后加一点延迟，确保不超过每秒1次的限制；最后加上异常处理，应对临时的服务超时问题。

from geopy.geocoders import Nominatim
from geopy.exc import GeocoderTimedOut, GeocoderServiceError
import time
import pandas as pd

# 初始化定位器，必须设置User-Agent（改成你的项目/应用名称）
geolocator = Nominatim(user_agent="my_geocoding_project_v1.0")

def geocode_with_delay(address):
    try:
        # 每次请求后延迟1.1秒（比官方要求的1秒多一点，更稳妥）
        time.sleep(1.1)
        location = geolocator.geocode(address)
        # 处理地址找不到的情况，返回None避免报错
        return (location.latitude, location.longitude) if location else (None, None)
    except (GeocoderTimedOut, GeocoderServiceError):
        # 遇到超时或服务错误，先等5秒再重试一次
        time.sleep(5)
        return geocode_with_delay(address)

# 应用到DataFrame
df['coord'] = df['address'].apply(geocode_with_delay)
df.head()

2. 进阶方案：加入缓存，避免重复请求

如果你的2万行数据里有重复地址（比如多个行是同一个城市/街道），用缓存保存已经编码过的结果，能节省大量时间和请求次数，也能降低触发429的概率。

from geopy.geocoders import Nominatim
from geopy.exc import GeocoderTimedOut, GeocoderServiceError
import time
import pandas as pd

geolocator = Nominatim(user_agent="my_geocoding_project_v1.0")
# 用字典缓存已编码的地址结果
geocode_cache = {}

def geocode_with_cache_and_delay(address):
    # 先查缓存，有结果直接返回
    if address in geocode_cache:
        return geocode_cache[address]
    try:
        time.sleep(1.1)
        location = geolocator.geocode(address)
        result = (location.latitude, location.longitude) if location else (None, None)
        # 把结果存入缓存
        geocode_cache[address] = result
        return result
    except (GeocoderTimedOut, GeocoderServiceError):
        time.sleep(5)
        return geocode_with_cache_and_delay(address)

df['coord'] = df['address'].apply(geocode_with_cache_and_delay)

3. 最优方案：使用geopy自带的RateLimiter

geopy官方提供了RateLimiter类，能自动处理请求频率限制和重试逻辑，代码更简洁也更可靠，不用手动写time.sleep。

from geopy.geocoders import Nominatim
from geopy.extra.rate_limiter import RateLimiter
import pandas as pd

# 初始化定位器
geolocator = Nominatim(user_agent="my_geocoding_project_v1.0")

# 创建限速的地理编码函数：每秒最多1次请求，超时最多重试3次
geocode = RateLimiter(geolocator.geocode, min_delay_seconds=1.1, max_retries=3)

# 先获取完整的location对象，再提取经纬度
df['location'] = df['address'].apply(geocode)
df['coord'] = df['location'].apply(lambda loc: (loc.latitude, loc.longitude) if loc else (None, None))

# 可选：删除中间的location列
df = df.drop('location', axis=1)
df.head()