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.1.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.1-py3-none-any.whl (4.3 MB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: ip_region-1.0.1.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.1.tar.gz
Algorithm Hash digest
SHA256 dfa84cc01e1a89f2b60e57f88ebc802850966b5d9fb17febb81d27dc7729cd8d
MD5 cbd261ed877951af1de9f7137c04759f
BLAKE2b-256 a08912abb69dc5ca9b2b82e05c10e134ee79d270ffadb376999c5ee732785ff9

See more details on using hashes here.

File details

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

File metadata

  • Download URL: ip_region-1.0.1-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.1-py3-none-any.whl
Algorithm Hash digest
SHA256 4b4373929ffdcd3eb12e2756a42c9c17cfe1bb812c07cc3c78c27a0d32d95000
MD5 8b06fe3ebfd05325a833fdc77200c8d4
BLAKE2b-256 b343a4fcbe99dde21c35286454ba5a19cbf0b1f97e683275edf0f207deb3ddd8

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