0.9 系列的变更日志

0.99

2014-03-18

• 新增：添加 GeocodeFarm 地理编码器，支持地理编码和反向地理编码。由 Eric Palakovich Carr 贡献。

0.98.3

2014-03-07

• 新增：在 Python 2.7 中，查询由地理编码器编码为 Unicode。由 Rocky Meza 贡献。

• 修复：YahooPlaceFinder count 参数已修复。

• 修复：Point.__repr__ 已修复。由 Paweł Mandera 贡献。

0.98.2

2014-02-28

• 新增：GoogleV3 现在接受 api_key 参数。由 Andrea Tosatto 贡献。

• 变更：GoogleV3 的已弃用 protocol 参数已移除。

0.98.1

2014-02-22

• 修复：Mapquest 地理编码器在创建其查询时未使用 format_string。由 Danny Finkelstein 贡献。

• 修复：地理编码器错误地为所有 SSLError 异常引发了 GeocoderTimedOut 异常。由 David Gilman 贡献。

0.98

2014-02-05

• 变更：地理编码器的 geocode 和 reverse 方法的返回值类型已从 None、元组或元组列表更改为 None、geopy.Location 对象或 geopy.Location 对象列表。

  Location 对象可以像以前那样迭代元组，以保持向后兼容性，返回值为 (address<String>, (latitude<float>, longitude<Float>))。

  geopy.Location 对象还将返回值作为属性提供。现有属性为 address、longitude 和 latitude。现在可以访问地理编码器的原始响应作为 raw，以及位置的海拔作为 altitude。

0.97.1

2014-02-01

• 修复：YahooPlaceFinder 地理编码器身份验证和响应解析已修复。由 petergx 贡献。

• 新增：GoogleV3 地理编码现在支持 components 参数，它是用于过滤位置条件（如行政区域、国家/地区等）的过滤器。由 crccheck 贡献。

0.97

2013-12-26

• 变更：默认情况下，支持 SSL 连接的服务使用 SSL 连接。这些地理编码器在其 init 中接受新的“scheme”参数，该参数可以是“https”或“http”。希望使用未加密连接的用户现在必须指定“http”。请注意，SSL 连接的证书未经过验证。

• 变更：地理编码器接受 timeout 参数，该参数指定在引发 GeocoderTimedOut 异常之前要等待的秒数。这可以在 init 中指定，也可以在每次 geocode 或 reverse 调用中单独指定。现在默认值为 1 秒。

• 变更：geopy 现在支持单个代码库上的 Python 2 和 Python 3。对 Python 2.5 的支持也已删除。

• 变更：GoogleV3 的 protocol 参数已弃用，取而代之的是 scheme。

• 新增：ESRI 的 ArcGIS 地理编码器已实现。由 Arsen Mamikonyan 贡献。

• 新增：地理编码器接受 proxies 参数，该参数指定一个代理，用于通过该代理路由其地理编码请求。它使用 urllib，并接受代理字典格式为 {scheme: proxy address}，例如，{"https": "192.0.2.0"}。这在 0.96 中已经存在，但未记录。

• 新增：如果定义，地理编码器会在 HTTP 调用到地理编码器服务时引发异常时检查新的方法 _geocoder_exception_handler。请参阅 LiveStreets 以了解示例。用户可以定义或覆盖此方法。

• 新增：LiveStreets 在适当的情况下抛出 GeocoderQuotaExceeded 异常。

• 新增：Point 可以解析更多种类的坐标字符串。由 nucflash 贡献。

• 修复：GeocodersDotUS 现在使用 Authorization HTTP 标头进行身份验证。由 Arsen Mamikonyan 贡献。

• 移除：MediaWiki 和 SemanticMediaWiki 地理编码器已移除。

• 移除：Geohash 模块已移除。

0.96.3

2013-12-26

• 新增：文档警告，Vincenty 距离实现无法收敛某些有效点。由 mkeller-upb 报告。

• 修复：地理编码器代理已修复。由 Marc-Olivier Titeux 贡献。

0.96.2

2013-11-20

• 修复：MANIFEST.in 排除项在 buildout 下破坏了构建。由 James Mills 贡献。

0.96.1

2013-10-31

• 修复：GoogleV3 在服务返回错误状态 ZERO_RESULTS 时返回 None。由 Ian A Wilson 贡献。

0.96

2013-10-25

• 变更：GoogleV3 的反向地理编码器现在默认情况下返回一个结果。将 exactly_one 设置为 False 以获取列表。

• 变更：GoogleV3 返回新的异常类型：geopy.geocoders.base.GQueryError -> geopy.exc.GeocoderQueryError geopy.geocoders.base.GeocoderResultError -> geopy.exc.GeocoderQueryError geopy.geocoders.base.GTooManyQueriesError -> geopy.exc.GeocoderQuotaExceeded

• 新增：已实现 OpenStreetMap Nominatim 地理编码器。由 Alessandro Pasotti 贡献。

• 新增：已实现 Yahoo！BOSS Geo PlaceFinder 地理编码器。由 jhmaddox 和 Philip Kimmey 贡献。

• 新增：已实现 SmartyStreets LiveAddress 地理编码器。由 Michael Whatcott 贡献。

• 新增：GeoNames 地理编码器实现了 GeoNames 的新用户名要求和 api.geonames.org 端点。由 David Wilson 和 Benoit Grégoire 贡献。

• 新增：Bing 地理编码器支持 user_location (Point) 参数。Bing 将优先考虑靠近 user_location 坐标的结果。由 Ryan Nagle 贡献。

• 修复：GoogleV3.geocode_first() 现在不再在多个结果上抛出异常。由 migajek 贡献。

• 修复：在 Py3k 上不必要的强制转换为 UTF-8。由 akanouras 贡献。

• 修复：format_degrees 现在正确地舍入分钟。由 avdd 贡献。

• 修复：如果可选依赖项 BeautifulSoup 不存在，不再发出警告。

• 修复：地理定位中的各种不一致行为和错误。

• 移除：Google V2 地理编码器已移除，因为其 API 已关闭。

0.95.1

2013-03-22

• 修复：即使未使用 GoogleV2（由于 geopy.geocoders 导入它），也修复了显示的 DeprecationWarning。由 Dave Arter 贡献。

• 变更：GoogleV3.geocode 的“address”关键字参数已重命名为“string”，以匹配 Google.geocode，以便于更新。

• 修复：地理编码器现在可以正确地处理 Unicode 对象作为输入（以前由于需要 UTF-8 字符串而会在非 ASCII 字符上失败）。

0.95

2013-03-12

• 新增：支持 Google 地理编码 API V3。由 Jordan Bouvier (jbouvier) 贡献。“google.Google()” 应替换为 “googlev3.GoogleV3()”，没有 api_key。

  请参阅 http://goo.gl/somDT 以了解有效参数。

• 变更：setup.py 已更新，现在可以自动支持 Python 3+（通过 2to3 自动编译选项）。由 Feanil Patel 贡献。

0.94.2

2012-03-12

• 新增：MANIFEST.in，以便 LICENSE 文件包含在 dist 包中（如 Debian Python 模块团队的要求）。

• 变更：Yahoo 地理编码器使用新的 PlaceFinder API 而不是过时的 MapsService V1 API。

0.94.1

2011-03-24

• 新增：测试套件包含对 Google、Bing、Yahoo、GeocoderDotUS 和 GeoNames 地理编码器的地理编码测试。

• 变更：output_format 在使用它的后端中已弃用。

• 修复：Bing 地理编码器现在可以正常工作。更新为使用 JSON 返回方法而不是 XML。 output_format 一直被忽略，现在已弃用。

• 修复：GeocoderDotUS 现在可以正常工作。更新为使用更紧凑的 CSV 返回方法而不是 XMLRPC。

• 变更：Yahoo 地理编码器现在使用“旧”元组返回格式（address, (lat, lon)），而不是未记录的 Location() 对象，以保持 API 一致性。（具有丰富数据的对象返回值将在未来的版本中实现。）

• 修复：修复了 Bing 后端中的“print”语句。不再有 print 语句。

• 修复：除了检查系统 json 和 simplejson 之外，geopy 现在还查找系统安装的 django（它捆绑了一个 simplejson 的副本）。

• 修复：在 Distance 上实现 __cmp__，以便距离对象可以相互比较。

• 变更：向 Distance 添加了 __repr__ 和 __str__

• 新增：MapQuest 的 OpenMapQuest API 的地理编码器后端，由 Shashwat Anand 贡献。

0.94

2010-03-07

• 新增：部分测试套件现在可以通过“setup.py test”运行

• 修复：将“print”语句转换为日志记录器调用，以允许与 WSGI 兼容。

• 修复：Google 地理编码器后端现在在某些失败状态下抛出更具描述性的异常。

• 修复：将 simplejson 添加到 install_requires 中以进行设置。如果可用，请使用本机 (Python 2.6+/3.0+) json 模块。

• 修复：超过 180/-180 和 90/-90 的值的距离计算现在会包装，而不是引发错误。

• 修复：修复了 Point 对象的字符串表示，以便它们不会抛出异常。

• 修复：修复了 GreatCircleDistance ValueErrors，原因是极近点的浮点精度。

0.93 (2006-10-08) 和 2009-02-15 之间的更改

请参阅 https://github.com/geopy/geopy/compare/0451a051…ffebd5f3