您当前的位置: Web服务API > 普通IP定位API
普通IP定位API

产品介绍

普通IP定位 API是一个根据IP返回对应大致位置信息的HTTP/HTTPS形式位置服务接口,支持多种语言调用,如C# 、C++、Java等,即通过发送HTTP/HTTPS请求,返回JSON格式的位置数据(包括经纬度信息、地址信息等)。

该接口免费对外开放,您需先申请密钥(AK)才可使用。每个开发者帐号每天使用该服务的次数是有限的,若需更多的使用次数,请完成开发者认证以获取更高配额和更及时的技术支持。

坐标系说明

目前国内主要有以下三种坐标系:

1. WGS84:为一种大地坐标系,也是目前广泛使用的GPS全球卫星定位系统使用的坐标系;

2. GCJ02:表示经过国测局加密的坐标;

3. BD09:为百度坐标系,其中bd09ll表示百度经纬度坐标,bd09mc表示百度墨卡托米制坐标;


普通IP定位API能够根据输入的IP地址,返回该IP大致的位置信息,位置信息中所包含的经纬度坐标为该IP所在城市中心点坐标。坐标类型可根据开发者的设置,返回 bd09ll 或 bd09mc。

百度地图在国内使用的是BD09坐标,在海外地区,统一使用WGS84坐标。开发者在使用百度地图相关服务时,请注意选择。普通IP定位API服务,目前暂不支持海外IP定位。

功能介绍

调用API接口,返回请求参数中指定IP的大致位置信息,包括:经纬度、省、市、区县等地址信息。

如果请求参数中的IP为空,则默认返回当前服务请求来源的IP所对应的大致位置信息。

适用场景

以城市为分类的应用或网站:根据用户当前IP来提供对应城市的服务。

ip_dev1.jpg

使用限制

每一个开发者帐号每天使用普通IP定位服务的使用次数是有限的,即配额有限。

每一个开发者帐号在每分钟内使用普通IP定位服务的次数是有限的,即并发量有限。

同一个帐号下的HTTP/HTTPS请求,配额、并发共享。

配额及并发量说明如下:

分类 未认证 个人认证 企业认证
日配额(次) 100,000 300,000 3,000,000
分钟并发量(次/分钟) 6,000 12,000 30,000

普通IP定位效果一般,只能针对IP返回大致位置信息,适用于对位置精度要求不高的应用。

如果您的应用为Android Native App,建议使用Android定位SDK,定位效果最佳,精度可达到10m,且无任何使用配额及并发量的限制。

使用方法

第一步,申请密钥(AK) ,作为访问服务的依据;

第二步,拼写发送HTTP/HTTPS请求的URL,注意需使用第一步申请的AK;

第三步,接收HTTP/HTTPS请求返回的数据(JSON格式)。

服务地址

http://api.map.baidu.com/location/ip
https://api.map.baidu.com/location/ip

接口参数

参数 含义 格式 说明
ip IP地址 string 可选,IP不出现,或者出现且为空字符串的情况下,会使用当前访问者的IP地址作为定位参数。
ak 开发者密钥 string 必选,登录API控制台,申请AK,作为访问的依据。
sn 用户的权限签名 string 可选,若用户所用AK的校验方式为SN校验时该参数必须。(SN生成算法
coor 输出的坐标格式 string 可选,coor不出现时,默认为百度墨卡托坐标;coor=bd09ll时,返回为百度经纬度坐标。

注意:

1. 普通IP定位API服务,只能够获得指定IP所处大致位置,结果字段中所返回的经纬度坐标一般为城市中心点坐标,请开发者注意使用;

2. 返回坐标类型,目前仅支持bd09mc(百度墨卡托坐标)和bd09ll(百度经纬度坐标)。GCJ02坐标类型的返回,将在下个版本支持;

返回值说明

返回结果(地址解析的结果)

{  
    address: "CN|北京|北京|None|CHINANET|1|None",    #地址  
    content:    #详细内容  
    {  
        address: "北京市",    #简要地址  
        address_detail:    #详细地址信息  
        {  
            city: "北京市",    #城市  
            city_code: 131,    #百度城市代码  
            district: "",    #区县  
            province: "北京市",    #省份  
            street: "",    #街道  
            street_number: ""    #门址  
        },  
        point:    #当前城市中心点,注意当前坐标返回类型
        {  
            x: "116.39564504",  
            y: "39.92998578"  
        }  
    },  
    status: 0    #返回状态码  
}

注:若返回异常,请查看 异常返回状态码 ,确认异常原因。

接口示例

服务示例:

http://api.map.baidu.com/location/ip?ak=请输入您的AK&coor=bd09ll

https://api.map.baidu.com/location/ip?ak=请输入您的AK&coor=bd09ll

返回值:

{  
    address: "CN|吉林|长春|None|CERNET|1|None",  
    content: 
    {  
        address: "吉林省长春市",  
        address_detail: 
        {  
            city: "长春市",  
            city_code: 53,  
            district: "",  
            province: "吉林省",  
            street: "",  
            street_number: ""  
        },  
        point:  #当前城市中心点,注意当前坐标返回类型,
        {
            #当前示例为bd09ll,可直接用于在百度地图上绘制展示  
            x: "125.31364243",      
            y: "43.89833761"  
        }  
    },  
    status: 0  
}

更新日志

2016年9月26日

普通IP定位服务,全面支持HTTPS协议类型访问。


2013年7月5日 普通IP定位服务API v1.1上线。

新增:返回值支持返回百度经纬度坐标(默认返回是墨卡托坐标)。