Skip to main content

Get geographic location through IP address, support IPv4 and IPv6. Combine IP address library and online API.

Project description

IP address location 通过IP地址获取地理位置

Introduction 简介

Get geographic location through IP address, support IPv4 and IPv6. Combine IP address library and online API. The local IP address library comes from the project lionsoul2014/ip2region, and the online API comes from ipwho.is, ip-api and ip.sb.

通过IP地址获取地理位置,支持IPv4和IPv6。结合了IP地址库和在线API。本地的IP地址库来自项目lionsoul2014/ip2region,在线API来自ipwho.isip-apiip.sb

Pypi: ipregion

How to use 使用方法

Install 安装:

pip install ip-region

Use 使用:

from ipregion import IP2Region
ip2region = IP2Region()
region = ip2region.search('8.8.8.8')

Caching Data 缓存数据

By default, after calling the online API, it will be cached in ipcache.db3 under this project. If you want to persist the cache data, you can pass in the cache file path when instantiating it, for example:

默认情况下,调用在线API后将会缓存在本项目下的ipcache.db3里,如果想要持久保存缓存数据,可以在实例化时传入缓存文件路径,例如:

# 实例化时指定缓存路径
# Specify the cache path when instantiating
import os
cur_path = os.path.abspath(os.path.dirname(__file__))
db_path = os.path.join(cur_path, "ipcache.db3")
ip2region = IP2Region( db_path = db_path)
region = ip2region.search("2001:4860:4860::8888")

The first time you specify the cache path, the target database file will be generated, so it will be a little slower

第一次指定缓存路径后,会生成目标数据库文件,所以会慢一点

Use in Flask 结合Flask使用

Example file 示例文件: example1_flask.py

View it on github 请在github上查看

example1_flask.py

insstall Flask 安装Flask:

pip install flask

run 运行:

python example1_flask.py

visit 访问本地测试路径:

http://127.0.0.1:5000/ip/<search ip>

API:

# 获取IP对应位置
GET http://127.0.0.1:5000/ip/8.8.8.8
# 获取IPv6对应位置
GET http://127.0.0.1:5000/ip/2406:da14:2e4:8900:b5fc:b35a:34d0:93f6
### 获取IP对应位置, 使用jsonp, callbackFunction可以自定义
GET http://127.0.0.1:5000/ip/8.8.8.8?callback=callbackFunction

Example code 示例代码:

from flask import Flask, jsonify, request
from ipregion import IP2Region
import json
app = Flask(__name__)
@app.route("/ip/<ip>")
def get_ip(ip=None):
    ip2region = IP2Region()
    region = ip2region.search(ip)
    # json
    if not request.args.get('callback') or request.args.get('callback').strip() == '':
        return jsonify(region)
    # jsonp
    else:
        return request.args.get('callback') + "(" + json.dumps(region) + ")"
if __name__ == "__main__":
    app.run(debug=True)

LICENSE

Apache-2.0 License

Source code

https://github.com/jeeaay/py-ip-location

Upload to pypi

install twine and build

pip install twine build

build

python -m build

upload

twine upload dist/*

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ip_region-1.0.2.tar.gz (4.3 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

ip_region-1.0.2-py3-none-any.whl (4.3 MB view details)

Uploaded Python 3

File details

Details for the file ip_region-1.0.2.tar.gz.

File metadata

  • Download URL: ip_region-1.0.2.tar.gz
  • Upload date:
  • Size: 4.3 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.0.1 CPython/3.12.8

File hashes

Hashes for ip_region-1.0.2.tar.gz
Algorithm Hash digest
SHA256 3847df4f84ed01d2582206b8b2c8e0413dce9ddb7124d187d0ce7c8e781cc6e2
MD5 d68b71cc567686b7184c0af8d409d4e4
BLAKE2b-256 20b2270b420b9d6e1d51d85a77436936018b5e97044234ee902e83f912f05724

See more details on using hashes here.

File details

Details for the file ip_region-1.0.2-py3-none-any.whl.

File metadata

  • Download URL: ip_region-1.0.2-py3-none-any.whl
  • Upload date:
  • Size: 4.3 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.0.1 CPython/3.12.8

File hashes

Hashes for ip_region-1.0.2-py3-none-any.whl
Algorithm Hash digest
SHA256 7e2ba0cc58229cfc9ae24d29dba00521cb1d6c28f7c0d14f0a05d38d19f796a6
MD5 6f4f11e586c2fbcac8f27594059c210b
BLAKE2b-256 a46a230c47de6c4881e5edfe2c77ba4ec6533548d079a25bffab49ae446c4871

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page