百度高精度IP定位API 文档备份

产品介绍

高精度IP定位API是一个根据IP返回对应精准位置信息的HTTP/HTTPS形式位置服务接口，支持多种语言调用，如C# 、C++、Java等，即通过发送HTTP/HTTPS请求，返回JSON/JSONP格式的位置数据（包括经纬度信息、地址信息、周边POI信息等）。该接口是免费对外开放，您需先申请密钥（AK）才可使用。每个帐号每天使用该服务的次数是有限的，若需更高配额，请完成开发者认证以获取更高配额和更及时的技术支持。

功能介绍

开放平台提供HTTP/HTTPS类型的API服务接口，开发者通过上传待定位IP，返回该IP对应地址信息，包括经纬度、地址信息（省、市、区、街道等）、周边POI信息、当前位置描述信息等。面向的用户是对IP定位有需求的开发者，包括但不限于PC/Mobile Web网站开发者、H5应用开发者、移动端定位能力受限应用开发者。

注意：Android移动应用开发者，请首选Android定位SDK使用，定位SDK精度更高，效果更佳，且无配额及并发限制。具体请求参数及返回值请参考后续详细介绍。

产品特点

高精度IP定位目前只支持WiFi链接上网情况下的使用，其原理是实时建库和百度大数据分析挖掘，因此相比于普通IP定位能返回更加精确的定位结果。

目前相关参数如下：成功率：综合定位成功率 65% 精度：90% 误差 80m 以内；95% 误差 350m 如果高精度定位失败的话，直接返回普通IP定位结果。高精度IP定位服务和普通IP定位服务并存，两个服务的配额不同，定位效果也不同，请开发者结合自身业务合理选择。

使用限制

每一个开发者帐号每天使用高精度IP定位服务的使用次数是有限的，即配额有限。每一个开发者帐号在每分钟内使用高精度IP定位服务的次数是有限的，即并发量有限。同一个帐号下的HTTP/HTTPS请求，配额、并发共享。配额及并发量说明如下：

分类	未认证	个人认证	企业认证
日配额（次）	1,000	10,000	100,000
分钟并发量（次/分钟）	1,200	3,000	12,000

使用方法

第一步，申请密钥（AK），作为访问服务的依据；第二步，拼写发送HTTP/HTTPS请求的URL，注意需使用第一步申请的AK；第三步，接收HTTP/HTTPS请求返回的数据（JSON/JSONP格式）。

地址服务

http://api.map.baidu.com/highacciploc/v1 https://api.map.baidu.com/highacciploc/v1
https://api.map.baidu.com/highacciploc/v1 https://api.map.baidu.com/highacciploc/v1

说明：

highacciploc：服务名称，即high accuracy IP location；

v1：服务版本号，v1版本；

参数	含义	说明
qcip	待定位IP	可选，如果为空，则针对定位服务的IP进行定位
ak	开发者密钥	必填，进行AK鉴权及配额控制
qterm	待定位终端类型	必填， mb：终端定位设备类型为移动设备 pc：终端定位设备类型为固定设备
extensions	返回结果扩展设定	可选， 0（默认）：只返回基础定位结果 1：返回基础定位结果+地址信息 2：返回基础定位结果+周边POI信息 3：返回基础定位结果+地址信息+POI信息
coord	返回坐标类型	可选， bd09（默认）：百度墨卡托坐标 bd09ll：百度经纬度坐标 gcj02：国测局经纬度坐标
coding	返回结果编码类型	可选， utf-8（默认）：返回UTF-8类型 gbk：返回GBK类型
callback_type	回调方式选择	必选， json（默认）：json方式 jsonp：jsonp方式，需设置callback参数
callback	jsonp回调函数	当callback_type=jsonp时，必填，取值为开发者所设置回调函数名

返回值说明

字段				说明
content	location	lat		纬度坐标	基础定位结果extensions=任何值都返回
	location	lng		经度坐标
	locid			定位结果唯一ID，用于问题排查
	radius			定位结果半径
	confidence			定位结果可信度
	address_component	country		国家	地址信息extensions=1、3返回
		province		省份
		city		城市
		district		区县
		street		街道
		street_number		门牌号
		admin_area_code		行政区划代码（身份证前6位）
	formatted_address			结构化地址信息
	business			商圈信息
	pois（1000m以内的最多10条poi）	name		名称	周边POI信息extensions=2、3返回
		uid		POI唯一标识ID
		address		地址
		tag		分类
		location	lat	纬度
		location	lng	经度
	location_description			位置描述信息
result	loc_time			定位时间	结果信息extensions=任何值都返回
result	error			定位结果状态码 161：定位成功 167：定位失败 1：服务器内部错误 101：AK参数不存在 200：应用不存在，AK有误请检查重试 201：应用被用户自己禁止 202：应用被管理员删除 203：应用类型错误 210：应用IP校验失败 211：应用SN校验失败 220：应用Refer检验失败 240：应用服务被禁用 251：用户被自己删除 252：用户被管理员删除 260：服务不存在 261：服务被禁用 301：永久配额超限，禁止访问 302：当天配额超限，禁止访问 401：当前并发超限，限制访问 402：当前并发和总并发超限	结果信息extensions=任何值都返回

接口示例

1、代码接口示例（callback_type = json）

服务示例：

http://api.map.baidu.com/highacciploc/v1?qcip=220.181.38.113&qterm=pc&ak=请输入您的AK&coord=bd09ll

或

https://api.map.baidu.com/highacciploc/v1?qcip=220.181.38.113&qterm=pc&ak=请输入您的AK&coord=bd09ll

返回值：

{
    content: {
        location: {
            lat: 40.047726,#纬度
            lng: 116.313304 #经度  
        },
        locid: "8b1bf81d208bc2ce657fb6e6c270de66",#定位结果唯一ID
        radius: 30, #定位结果半径
        confidence: 1 #定位结果可信度    },
    result: {
        error: 161,#定位结果状态码
        loc_time: "2016-08-23 15:14:12"#定位时间    }}

2、代码接口示例（callback_type = jsonp）

服务示例：

http://api.map.baidu.com/highacciploc/v1?qcip=220.181.38.113&qterm=pc&ak=请输入您的AK&coord=bd09ll&callback_type=jsonp&callback=test

或

https://api.map.baidu.com/highacciploc/v1?qcip=220.181.38.113&qterm=pc&ak=请输入您的AK&coord=bd09ll&callback_type=jsonp&callback=test

返回值：

test({"content":{
      "location":{
         "lat":40.047726,
         "lng":116.313304
       },
       "locid":"d5ce5ea49ab1efa5a1f2296404b3e7f9",
       "radius":30,
       "confidence":1.0
       },
       "result":{
           "error":161,
           "loc_time":"2016-08-23 14:32:19"
       }})

发表于2016-12-17

分类:教程

已喜欢

朗读