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

Uploaded Python 3

File details

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

File metadata

  • Download URL: ip_region-1.0.4.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.4.tar.gz
Algorithm Hash digest
SHA256 c0ef766a8af42685d3951e7fe2800beadb814ddb41423acf02cd7a195dbe2ee4
MD5 0ec621c9b52c6ae944ceb8870c22fa2b
BLAKE2b-256 4c833e87af17f06ad45c850d12529b1518a3cb9b49bc42d76c9559864fa375f6

See more details on using hashes here.

File details

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

File metadata

  • Download URL: ip_region-1.0.4-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.4-py3-none-any.whl
Algorithm Hash digest
SHA256 a1409704c88a820f1d1b11c2a009dbda32e1de56e64a2cfa7ec650142c5cbb0e
MD5 bf7a1e0188ec41a60cf52261fcacacfa
BLAKE2b-256 cb7780c14cc015c85693075b0c6b7db8511a59e2594780e7584e30f5326ad1c4

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