1．作者介绍

吝红凯，男，西安工程大学电子信息学院，2022级研究生
研究方向：机器视觉与人工智能
电子邮件：[email protected]

王泽宇，男，西安工程大学电子信息学院，2022级研究生，张宏伟人工智能课题组
研究方向：机器视觉与人工智能
电子邮件：[email protected]

2．相关介绍

2.1 什么是聚合数据？

聚合数据是指天聚地合（苏州）科技股份有限公司
公司成立于2010年，是一家基于API技术的综合性数据处理服务商，主要为为智能手机开发者，网站站长，移动设备开发人员等提供原始数据API服务的综合性云数据平台。包含手机聚合，网站聚合，LBS聚合三部分，其功能类似于Google APIS和百度的APIStore。
在这里插入图片描述

2.2 API介绍

API是应用程序接口（Application Programming Interface）的缩写。它是一组定义了软件组件之间如何互相通信的规则和协议。API允许不同的软件系统之间共享数据和功能，使它们能够相互交互和集成。
API可以被视为两个软件系统之间的桥梁，它定义了一个软件组件可以如何请求另一个软件组件的服务，并指定了请求和响应的数据格式。通过API，开发人员可以使用已经构建好的功能和服务，而无需从头开始编写所有的代码。这样可以提高开发效率，同时促进不同系统之间的集成和交互。
API可以用于各种不同的目的，例如
①　数据访问
②　功能扩展
③　应用程序集成
④　开发工具

2.3 手机号码归属地

在中国的手机号都是11位
手机号学名叫做移动用户号码簿号码，简称MDN。它由三部分组成：
MDN =CC + MAC + SN
CC（国家码):此码代表用户所属的国家，由2位数字组成。
MAC（移动接入码）：手机号的前三位代表网络识别码，也就是移动电信联通的所属号段。
SN（用户号码）：手机号的后八位代表用户号码，用户号码的前四位代表地区编码，这四个数可以查出你的大致归属地，最后四位代表用户号码，号码自由生成。

所以手机号码归属地的识别就是识别用户号码的前四个数字来查询用户的位置信息

3．实验过程

3.1如何调用聚合数据API

进入首先登录聚合数据官网(https://www.juhe.cn/register)，注册聚合账号，在右上角的个人信息中点击实名认证。
实名认证通过后，点击数据中心中我的API，申请新数据。
在新弹出的窗口中选择电子商务，就可以找到手机号码归属地，点击申请
申请成功后会给出请求key。

功能如下:
①　根据输入的手机号码，查询手机号码归属地信息，如省份、城市、运营商
②　免费用户，调用API每日50次免费调用
并且它网页端给出了功能测试，输入手机号点击查询，会输出对应的信息

3.2代码实现

安装并导入所需要的库（需要引入requests包）

pip install requests

1.首先解释了该源码采用UTF-8编码方式，然后导入所需要的模块，

#!/usr/bin/python
# -*- coding: utf-8 -*-

# 导入所需的模块
import json  # 导入json模块，用于处理JSON数据
import urllib.request  # 导入urllib.request模块，用于发送HTTP请求
from urllib.parse import urlencode  # 导入urlencode函数，用于对参数进行URL编码

2.下面这段代码的作用是配置APP密钥并发起手机归属地查询请求

def main():
    # 配置您申请的APPKey
    appkey = "56c179d02817209ee0c40d9bf70f59ed"

    # 1.手机归属地查询
request1(appkey, "GET")

3.然后定义了一个名为request1的函数，用于进行手机归属地查询。
需要输入三个参数，第一个是输入需要查询的手机号码，第二个是在聚合数据官网申请到的APP密钥，第三个是输入需要返回的数据格式。

def request1(appkey, m="GET"):
    url = "http://apis.juhe.cn/mobile/get"
    params = {
        "phone": "21988329395",  # 需要查询的手机号码或手机号码前7位
        "key": "56c179d02817209ee0c40d9bf70f59ed",  # 应用APPKEY(应用详细页查询)
        "bytes": "json"  # 返回数据的格式,xml或json，默认json
}

4.最后这段代码是对request1 函数实现了手机归属地查询的逻辑。它通过构造请求的 URL 和参数，使用 urllib.request 模块发送 HTTP 请求，获取查询结果。如果查询成功，将结果打印出来；否则打印错误信息。

# 手机归属地查询
def request1(appkey, m="GET"):
    url = "http://apis.juhe.cn/mobile/get"  # 手机归属地查询接口的URL
    params = {
        "phone": "1529138547",  # 需要查询的手机号码或手机号码前7位
        "key": "56c179d02817209ee0c40d9bf70f59ed",  # 应用APPKEY(应用详细页查询)
        "bytes": "json"  # 返回数据的格式,xml或json，默认json
    }
    params = urlencode(params)  # 对参数进行URL编码
    if m == "GET":
        f = urllib.request.urlopen("%s?%s" % (url, params))  # 发送GET请求
    else:
        f = urllib.request.urlopen(url, params)  # 发送POST请求

    content = f.read().decode("utf-8")  # 读取响应内容并解码为UTF-8格式
    res = json.loads(content)  # 将响应内容解析为JSON格式
    if res:
        error_code = res["error_code"]
        if error_code == 0:
            # 成功请求
            print(res["result"])  # 打印归属地查询结果
        else:
            print("%s:%s" % (res["error_code"], res["reason"]))  # 打印错误码和错误信息
    else:
        print("request api error")  # 打印请求API错误信息

# 主函数入口
if __name__ == '__main__':
main()

5.返回的参数说明
在这里插入图片描述
6.下面给出了返回的数据格式的示例

两种数据格式的区别
①　数据以键值对的形式表示，使用大括号{}表示对象，使用方括号[]表示数组
②　XML使用标签和元素来定义数据结构，使用尖括号<>表示标签
③　总的来说：JSON的可读性更高，并且支持更多的数据类型，通常情况下选用json为返回数据格式数据，JSON更加简洁、易于理解和处理，适用于大多数应用场景。
7.完整代码如下：

#!/usr/bin/python
# -*- coding: utf-8 -*-

# 导入所需的模块
import json  # 导入json模块，用于处理JSON数据
import urllib.request  # 导入urllib.request模块，用于发送HTTP请求
from urllib.parse import urlencode  # 导入urlencode函数，用于对参数进行URL编码

# ----------------------------------
# 手机号码归属地调用示例代码 － 聚合数据
# 在线接口文档：http://www.juhe.cn/docs/11
# ----------------------------------

def main():
    # 配置您申请的APPKey
    appkey = "56c179d02817209ee0c40d9bf70f59ed"

    # 1.手机归属地查询
    request1(appkey, "GET")

# 手机归属地查询
def request1(appkey, m="GET"):
    url = "http://apis.juhe.cn/mobile/get"  # 手机归属地查询接口的URL
    params = {
        "phone": "1529138547",  # 需要查询的手机号码或手机号码前7位
        "key": "56c179d02817209ee0c40d9bf70f59ed",  # 应用APPKEY(应用详细页查询)
        "bytes": "json"  # 返回数据的格式,xml或json，默认json
    }
    params = urlencode(params)  # 对参数进行URL编码
    if m == "GET":
        f = urllib.request.urlopen("%s?%s" % (url, params))  # 发送GET请求
    else:
        f = urllib.request.urlopen(url, params)  # 发送POST请求

    content = f.read().decode("utf-8")  # 读取响应内容并解码为UTF-8格式
    res = json.loads(content)  # 将响应内容解析为JSON格式
    if res:
        error_code = res["error_code"]
        if error_code == 0:
            # 成功请求
            print(res["result"])  # 打印归属地查询结果
        else:
            print("%s:%s" % (res["error_code"], res["reason"]))  # 打印错误码和错误信息
    else:
        print("request api error")  # 打印请求API错误信息

# 主函数入口
if __name__ == '__main__':
    main()

3.3实验结果

运行图片：
1.运行结果展示，因为输入参数的是我自己手机号，它返回了对应的省份，城市，区号，邮政，运营商
输入手机号：1522913****
在这里插入图片描述
2.然后在网上找了国外的手机号，他和中国的手机号长度是一样的都是11位，运行后报错，显示输入为空，所以它不能识别出国外手机号的信息。
输入手机号：21988329395（巴西）

3.错误码参照