MaxMind GeoIP Legacy Python Extension API 技术文档

1. 安装指南

使用pip安装

最简单的方式是使用pip工具安装GeoIP Python扩展：

$ pip install GeoIP

从源代码安装

如果您需要从源代码安装，可以按照以下步骤：

$ python setup.py build
$ python setup.py install

确保您的系统中已经安装了GeoIP Legacy C库版本1.4.7或更高。

2. 项目的使用说明

此Python扩展API用于访问MaxMind的GeoIP Legacy数据库，提供IP地址的地理位置信息。但是请注意，MaxMind将在2022年5月底停止支持GeoIP Legacy数据库，因此我们推荐升级到GeoIP2数据库。

使用此库时，请确保遵守以下指南：

• IP地址的地理位置查询结果仅供参考，不应用于精确识别特定地址或家庭。

• 在使用示例或进行故障排除时，请参考项目中的examples文件夹和相关文档。

故障排除

如果您遇到“libGeoIP.so.1: cannot open shared object No such file or directory”错误，请尝试以下步骤解决：

• 将/usr/local/lib添加到/etc/ld.so.conf文件中。
• 然后运行/sbin/ldconfig /etc/ld.so.conf。

3. 项目API使用文档

具体API使用方法请参考以下示例：

import GeoIP

# 创建GeoIP对象
gi = GeoIP.open("/path/to/GeoIP.dat", GeoIP.GEOIP_STANDARD)

# 获取IP地址的地理位置信息
ip_address = "64.135.242.254"
record = gi.record_by_name(ip_address)

print(record['country_name'])
print(record['city'])
print(record['latitude'])
print(record['longitude'])

请确保将"/path/to/GeoIP.dat"替换为您的GeoIP数据库文件的实际路径。

4. 项目安装方式

请参考本文档的“安装指南”部分，您可以选择使用pip工具安装或从源代码安装。

---

本文档旨在帮助用户安装和使用MaxMind GeoIP Legacy Python Extension API。在使用过程中，请确保遵守所有相关的使用指南和许可协议。