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

IP定位 API v1.1

产品介绍

IP定位 API是一个根据IP返回对应位置信息的http形式位置服务接口,支持多种语言调用,如C# 、C++、Java等,即通过发送http请求,返回json格式的位置数据(包括坐标值、省份、城市、百度城市代码等)。

该接口是免费对外开放,您需先申请密钥(ak) 才可使用。每个key支持100万次/天,超过限制不返回数据。

功能介绍

提供根据IP返回位置信息的功能,包括如下两种情况:

1.获取指定IP的位置信息:指定IP值,返回该IP对应的位置信息;

2.获取当前设备IP的地址信息:根据用户设备当前的IP返回位置信息;

适用场景

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

使用限制

每个key每天支持100万次调用,超过限制不返回数据。

IP定位的结果精度较差,主要应用获取省份或者城市的位置信息。移动平台的APP建议使用百度定位SDK

使用方法

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

第二步,拼写发送http请求的url,注意需使用第一步申请的ak;

第三步,接收http请求返回的数据(json格式)。

服务地址

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

接口参数

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

返回值说明

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

{
	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=E4805d16520de693a3fe707cdc962045&ip=202.198.16.3&coor=bd09ll

返回值:

{
address: "CN|吉林|长春|None|CERNET|1|None",
content: {
address: "吉林省长春市",
address_detail: {
city: "长春市",
city_code: 53,
district: "",
province: "吉林省",
street: "",
street_number: ""
},
point: {     
x: "125.31364243",    
y: "43.89833761"
}
},
status: 0
}
		 
		 

更新日志

2013年7月5日IP定位v1.1:产品上线。

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


更多历史更新请查看