如何在Python地理编码中按城市+州实现精准搜索？

我用geopy的Nominatim获取指定城市和州的经纬度，但它会模糊匹配地址中的所有内容，而非仅匹配城市和州。比如输入“Chandler, Arizona”能正常返回结果，但输入“Chan, Arizona”时，它会返回亚利桑那州梅萨市一家含“Chan”字样的餐厅的坐标，而我希望这种情况直接返回“城市未找到”的错误。

我的初始实现代码：

geolocator = Nominatim(user_agent='clear-sky-finder')
location = geolocator.geocode(f"{city}, {state}")

if not location: 
    raise APIException("City not found", 404)
lat = location.latitude
long = location.longitude

我尝试过反向地理编码验证，但这种方法会遗漏像“Waddell”这类被归类为非city类型的区域：

location = geolocator.reverse(f"{lat},{long}")
location_city = location.raw['address']['city']

if location_city != city: 
    raise APIException("City not found", 404)

请问有没有方法实现严格的城市匹配？

可以通过结构化查询结合地址组件验证来实现严格匹配，既避免模糊匹配的问题，又能覆盖不同类型的城市区域：

方法1：结构化查询+多字段验证 #

Nominatim支持传入结构化地址参数，明确指定城市、州的类型，从根源减少模糊匹配概率；同时获取详细地址组件，验证返回结果是否完全匹配输入的城市和州。

geolocator = Nominatim(user_agent='clear-sky-finder')
# 传入结构化地址，明确指定城市、州、国家，同时开启地址详情返回
location = geolocator.geocode(
    {
        'city': city,
        'state': state,
        'country': 'United States'
    },
    addressdetails=True
)

if not location:
    raise APIException("City not found", 404)

# 提取返回的州信息，统一转为小写避免大小写问题
returned_state = location.raw['address'].get('state', '').lower()
# 定义所有可能代表城市级区域的字段（覆盖小镇、郊区等非city类型）
city_type_fields = ['city', 'town', 'village', 'suburb', 'hamlet']
returned_city = None

# 遍历字段，找到匹配的城市级名称
for field in city_type_fields:
    if field in location.raw['address']:
        returned_city = location.raw['address'][field].lower()
        break

# 严格验证城市和州是否完全匹配（若需要区分大小写可去掉lower()）
if not (returned_city == city.lower() and returned_state == state.lower()):
    raise APIException("City not found", 404)

lat = location.latitude
long = location.longitude

方法2：限制查询范围+模糊匹配过滤 #

如果不想用结构化查询，也可以在普通查询中限制国家范围，再通过地址组件验证过滤错误结果：

geolocator = Nominatim(user_agent='clear-sky-finder')
# 限制查询仅在美国范围内，同时开启地址详情
location = geolocator.geocode(
    f"{city}, {state}",
    addressdetails=True,
    country_codes='us'
)

if not location:
    raise APIException("City not found", 404)

# 验证逻辑同方法1
returned_state = location.raw['address'].get('state', '').lower()
city_type_fields = ['city', 'town', 'village', 'suburb', 'hamlet']
returned_city = None

for field in city_type_fields:
    if field in location.raw['address']:
        returned_city = location.raw['address'][field].lower()
        break

if not (returned_city == city.lower() and returned_state == state.lower()):
    raise APIException("City not found", 404)

lat = location.latitude
long = location.longitude

说明 #

• 结构化查询能让Nominatim明确识别你要查询的是城市和州，而非任意含关键词的地点，大幅降低错误匹配概率。
• 多字段验证覆盖了不同行政划分类型的区域（比如Waddell这类郊区可能被标记为suburb而非city），避免遗漏合法结果。
• 统一转为小写匹配是为了兼容输入和返回结果的大小写差异，若业务需要严格区分大小写，可移除.lower()。

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