创建或修改目录:/www/wwwroot/104.219.215.234/data 失败!
发布日期:2024-10-11 00:07 点击次数:95
Place APIv1.0 探望进口 自2014年9月1日起伪娘 人妖,咱们将拔除Place API v1.0。届时 Place API v1.0将无法过去使用。
调教母狗 1.什么是Place API?Place API 是一类概况的HTTP接口,用于复返查询某个区域的某类POI数据,且提供单个POI的笃定查询奇迹,用户不错使用C#、C++、Java等开荒言语发送HTTP苦求且接管json、xml的数据。
2.功能先容Place API 提供区域检索POI奇迹、POI笃定奇迹与团购信息检索奇迹、商家团购笃定查询。
1. 区域检索POI奇迹提供三种区域检索要领:
城市内检索(对应JavaScriptAPI的Search要领) 矩形检索(对应JavaScript API的SearchInBound要领) 圆形区域检索(对应JavaScript的SearchNearBy要领)。2. POI笃定奇迹提供查询单个POI的笃定信息,如好评。
3. 团购信息检索奇迹提供三种区域检索要领:
城市内检索 矩形检索 圆形区域检索4. 商家团购笃定查询。
用户不错使用C# 、C++、Java等开荒言语发送HTTP苦求且接管JSON、XML的复返数据。
3.使用讲解Place API 是一套免费使用的API接口,调用次数终结为10万次/天。
ak是API苦求串的必填参数,请先得回密钥,若无百度账号则领先需要注册百度账号。
Hello, World
以下是一个对于place API的概况示例,配置检索城市为北京,检索要道字为“饭铺”,检索后复返10条数据。
?&q=饭铺®ion=北京&output=json&ak=E4805d16520de693a3fe707cdc962045
后果讲解:点击上述苦求url,复返顺应检索条款的json花样的数据。
4.Place奇迹地址百度舆图Place API奇迹地址:
//v2 place区域检索POI奇迹 //v2 POI笃定奇迹 //v2 团购信息检索奇迹 //v2 商家团购信息查询
构成讲解:
域名: 奇迹名:place 奇迹版块号:较之前版块,v2版块新增参数。 Place要领名:如search暗示区域POI查询,detail暗示POI笃定,eventsearch为团购信息检索,eventdetail为商家团购笃定查询。 5.Place区域检索POI奇迹  5.1 Place区域检索通用接口参数以下参数,适用于三种区域检索要领的Place API。
参数是否必须默许值花样例如含义 q(query) 是 无 中关村、ATM、百度大厦 检索要道字,相近检索和矩形区域内检索扶持多个要道字并集检索,不同要道字间以$符号分隔,最多扶持10个要道字检索。如:”银行$旅社”。 tag 否 无 日式烧烤/铁板烧、朝外大街 标签项,与q组合进行检索 output 否 xml json或xml 输出花样为json或者xml scope 是 1 1、2 检索后果提神过程。取值为1 或空,则复返基本信息;取值为2,复返检索POI提神信息 filter 否 无 filter=industry_type:cater|sort_name:price|sort_rule:0|price_section:100,200|groupon:0|discount:0 检索过滤条款,当scope取值为2时,不错配置filter进行排序。 industry_type:行业类型庄重:配置该字段可擢升检索速率和过滤精度。 industry_type取值如下: hotel:宾馆 cater:餐饮 life:活命文娱 sort_name:排序字段取值证实industry_type字段的值而定。 (1)industry_type为hotel时,sort_name取值: default:默许; price:价钱 total_score:好评 level:星级 health_score:卫生 distance:距离排序,只消相近检索灵验 (2)industry_type取值cater时,sort_name取值: default:默许 taste_rating:口味 price:价钱 overall_rating:好评 service_rating:奇迹 distance:距离排序,只消相近检索灵验 (3)industry_type取值life时,sort_name取值: default:默许 price:价钱 overall_rating:好评 comment_num:奇迹 distance:距离排序,只消相近检索有 sort_rule:排序章程,取值如下:0:从高到低,1:从低到高; price_section:价钱区间; groupon:是否有团购,1为有团购,0为无团购; discount:是否打折,1为有打折,0为无打折; page_size 否 10 10 范围纪录数目,默许为10札纪录,最大复返20条。多要道字检索时,复返的纪录数为要道字个数*page_size。 page_num 否 0 0、1、2 分页页码,默许为0,0代表第一页,1代表第二页,依此类推。 ak 是 无 E4805d16520de693a3fe707cdc962045 用户的探望密钥,必填项。v2之前该属性为key。 sn 否 无 用户的权限签名。 timestamp 否 无 配置sn后该值必填。编码讲解:
对于query和region参数,因为这两个参数取值不错是华文或一些特地字符(如:空格),例如:query不错取值“小吃”,region不错取值“北京”,为了幸免提交到后台乱码,是以对于这2个参数值进行编码科罚,编码成 UTF-8 字符的二字符十六进制值。 query和region参数取值时候,但凡不不才表中的字符皆要进行编码。
字符诱骗字符 URL非保留字 a b c d e f g h i j k l m n o p q r s t u v w x y z A B C D E F G H I J K L M N O P Q R S T U V W X Y Z 0 1 2 3 4 5 6 7 8 9 - _ . ~ URL保留字 ! * ' ( ) ; : @ & = + $ , / ? % # [ ]    若是query和region参数中使用URL保留字字符的字面真谛,例如:query要道字取值为"?小吃",检索要道字包含一个问号,此问号也必须进行编码,"?"的16进制编码为"?",是以通盘这个词检索要道字"?小吃"编码后为"?小吃"。
附注:
(1) javascript中一般罗致encodeURIComponent函数对特地字符进行编码。
(2) Java中不错使用函数URLEncoder.encode对特地字符进行编码。
(3) C#中不错使用函数HttpUtility.UrlEncode对特地字符进行编码。
(4) php中不错使用函数urlencode对特地字符进行编码。
5.2 Place检索示例: 5.3 Place区域检索示例要领
Place API证实扶持检索的区域类型,提供城市内、矩形、圆形三种检索要领,使用讲解如下:
1)城市内检索苦求参数
参数是否必须默许值花样例如含义 region 是 无 北京、131、世界 检索区域,若是取值为“世界”或某省份,则复返指定区域的POI。城市检索示例(复返json数据):
?&query=银行®ion=济南&output=json&ak=E4805d16520de693a3fe707cdc962045
2)矩形区域检索参数
参数是否必须默许值花样例如含义 bounds(bds) 是 无 38.76623,116.43213,39.54321,116.46773 lat,lng(左下角坐标),lat,lng(右上角坐标) 检索矩形区域矩形检索示例(复返json数据):
?&query=银行&bounds=39.915,116.404,39.975,116.414&output=json&ak=E4805d16520de693a3fe707cdc962045
3)圆形区域检索参数
参数是否必须默许值花样例如含义 location 是 无 38.76623,116.43213 lat,lng 相近检索中心点,不扶持多个点 radius(r) 否 无 2000 相近检索半径,单元为米圆形区域检索示例(复返xml数据):
?&query=银行&location=39.915,116.404&radius=2000&output=xml&ak=E4805d16520de693a3fe707cdc962045
4)Place API检索复返后果字段
景况字段
称号 类型 讲解 status Int 本次API探望景况,若是生效复返0,若是失败复返其他数字。 message string 对API探望景况值的英文讲解,若是生效复返"ok",并复返后果字段,若是失败复返造作讲解。 total int 检索总和,用户苦求中配置了page_num字段才会出现total字段。后果字段(以后果诱骗里的一条数据为例,灰色暗示膨大字段):
称号 类型 讲解 name string poi称号 location object poi经纬度坐标 lat float 纬度值 lng float 经度值 address string poi地址信息 telephone string poi电话信息 uid string poi的独一标示 detail_info object poi的膨大信息,仅当scope=2时,显现该字段,不同的poi类型,显现的detail_info字段不同。 distance int32 距离中心点的距离 type string 所属分类,如’hotel’、’cater’。 tag string 标签 detail_url string poi的笃定页 price string poi商户的价钱 shop_hours string 贸易时辰 overall_rating string 总体评分 taste_rating string 口味评分 service_rating string 奇迹评分 environment_rating string 环境评分 facility_rating string 星级(建造)评分 hygiene_rating string 卫生评分 technology_rating string 手艺评分 image_num string 图片数 groupon_num int 团购数 discount_num int 优惠数 comment_num string 驳斥数 favorite_num string 储藏数 checkin_num string 签到数 6.Place笃定检索奇迹  奇迹地址: 
提供查询某个POI点的笃定信息,如好评,评价等。
苦求参数讲解:
参数是否必须默许值花样例如含义 uid 是 无 ‘8ee4560cf91d160e6cc02cd7’ poi的uid output 否 xml json或xml 苦求复返花样 scope 是 1 1、2 检索后果提神过程。取值为1 或空,则复返基本信息;取值为2,复返检索POI提神信息 ak 是 无 E4805d16520de693a3fe707cdc962045 用户的探望密钥,必填项。v2之前该属性为key。 sn 否 无 用户的权限签名。 timestamp 否 无 配置sn后该值必填。复返值与Place API检索复返后果字段同样。
示例:?uid=8ee4560cf91d160e6cc02cd7&ak=E4805d16520de693a3fe707cdc962045&output=json&scope=2复返值:
{ status: 0, message: "ok", result: { name: "江边城外•巫山烤全鱼亚运村店", location: { lng: 116.412347, lat: 40.005328 }, address: "向阳区慧忠北路慧忠里123号楼(近北辰东路)", telephone: "(010)64924119", uid: "8ee4560cf91d160e6cc02cd7", detail_info: { tag: "好意思食 中餐馆 烤鱼 饭统北京 家东说念主麇集 一又友集合 烧烤 学生聚餐 二三东说念主小聚 家庭麇集 寿辰PARTY 共事一又友集合 亚运村店 川菜 安妥大伙东说念主 餐馆 川北凉粉 大拌菜 豆豉烤鱼 豆豉清江鱼 怪味清江鱼 会员卡商户 家常泡饼 家庭集合 不错刷卡 麻辣烤鱼 免费泊车 一又友聚餐 皮蛋豆腐 青椒皮蛋 情侣集合 商务宴请 跳水木耳 无线上网 香辣烤鱼 香辣清江鱼 失业小憩 有无烟区", detail_url: "?uid=8ee4560cf91d160e6cc02cd7&output=html&source=placeapi_v2", type: "cater", price: "63", overall_rating: "5.0", taste_rating: "5.0", service_rating: "5.0", environment_rating: "5.0", image_num: "671", comment_num: "1191", favorite_num: "1851", checkin_num: "45060", shop_hours: "11:00-23:00" } } }7. Place团购检索奇迹  7.1 团购信息检索奇迹
奇迹地址:
?
证实团购要道字、团购分类、区域范围等条款组合检索,扶持按团购价钱、距离等条款排序。
苦求参数讲解:
参数是否必须默许值花样含义 q(query) 是 无 小吃、宾馆、文娱 要道字检索 event 是 无 groupon、discount、all 事件称号,不错是团购、打折或一齐,现在只扶持团购。 region 是 131 北京、131,庄重:和search功能不同,此字段必须填写城市称号或城市代码,不成为世界或1。 检索区域 location 是,二选一 1)location 2)bounds 若皆出当前,bounds优先级最大,location优先级小。 无 38.76623,116.43213 检索中心点,庄重轨则:纬度,经度 radius(r) 否 1000 2000 检索半径。默许1000米,最大可配置2000米。 bounds(bds) 是,二选一 1) location 2) bounds 若皆出当前,bounds优先级最大,location优先级小。 无 38.76623,116.43213,39.54321,116.46773 检索矩形Bound,庄重轨则:左下角纬度,左下角经度,右上角纬度,右上角经度。 output 否 xml json或xml,默许xml 输出花样 filter 否 无 检索过滤条款。 groupon_type为团购类型,取值如下: 1: 餐饮 2:活命 3:文娱 4:旅游住宿 sort_name为排序字段,取值如下: data_type:数据类型,默许排序 groupon_num:团购销量 groupon_price:团购价钱 groupon_start:团购运转时辰 distance:按距离排序,只对中心点检索灵验 sort_rule为排序章程,取值如下: 0: 从高到低 1:从低到高 该章程对data_type和groupon_num字段无效。 示例: groupon_type:1|sort_name:group_price|sort_rule:1 page_size 否 10 10 复返纪录数目,默许为10札纪录,最大可配置为20条。 page_num 否 0 0、1、2 分页页码,默许为0。 0代表第一页,1代表第二页,依此类推。 若是配置了此字段,则输出后果中含有total字段。 ak 是 无 vDh8mxgqaG4clKP7u 用户的探望密钥 sn 否 无 LiD0WoSTit8b8teqHSNysUrK63a3m 用户的权限签名 timestamp sn存在时必选。 无 1352887837758 时辰戳备注:query和region取值讲解详见编码讲解。
 奇迹示例:复返后果:?query=美食&event=groupon&region=131&bounds=39.915,116.404,39.935,116.435&output=json&page_size=1&ak=E4805d16520de693a3fe707cdc962045 //北京市的“好意思食”团购信息
复返后果有两种体式伪娘 人妖,一种是json,另一种为xml,默许为xml花样,底下示例为json花样。
{ status: 0, message: "ok", results: [ { uid: "9d18c725de1b540efb2d6192", name: "DQ冰淇淋(王府井店)", lcatin: { lat: "39.920411", lng: "116.418224" } address: "东城区王府井大街138号新东安阛阓", telephne: "(010)65283613", event: [ { cn_name: "民众点评", grupn_end: "2013-05-05", grupn_id: "4310671635", grupn_image: "http://tuanimg.baidu.cm/data/2_3b10ad0339b39176869831e787b1a9ea", grupn_num: "38178", grupn_price: "16.6", grupn_rebate: "7.9", grupn_site: : "http://t.dianping.cm/redirect?utm_surce=tuan_baidu&cityname=beijing", grupn_start: "2013-04-12", grupn_tips: "< div class="detail-bx"> <h3 class="tit tit-c">超过教唆</h3> </br> </br></p class="listitem">灵验期:</br>北京地区套餐中杯狂风雪1杯 2013-04-12 至 2013-05-30<br/>天津地区套餐 2013-04-12 至 2013-05-30<《》br/>天津提拉米苏布朗尼套餐 2013-04-14 至 2013-05-30</br/>石家庄地区套餐 2013-04-12 至 2013-05-30</p><p class="listitem">仅限DQ(北京,天津,石家庄)使用,笃定见页面附表使用</p><p class="listitem">无需预约</p><p class="listitem">团购券请于到店时出示</p><p class="listitem">不可与其他优惠同享</p><p class="listitem">本单团购不扶持退款</p><p class="listitem">本单团购不成使用点评团抵用券/优惠代码</p></br> </br> </div>", grupn_title: "DQ冰淇淋!仅售16.6元,最高价值21元中杯狂风雪1杯!3城97家店可选!缤纷味说念由你决定,倒杯不洒的诱惑,开启甘好意思一霎!", grupn_type: "1", grupn_url_mbile: "?frm=bdmapwise&url=http://wap.dianping.cm/tuan/redirect?did=152496", grupn_url_pc:"?frm=bdmappc&url=http://t.dianping.cm/redirect?did=152496", regular_price: "21", reservatin: "1", shrt_title: "DQ冰淇淋中杯狂风雪冰激凌", spend_end_time: "1369929599" } ] } ] }7.2 商家团购笃定查询 奇迹地址:
?
证实POI UID查询当前POI通盘的团购提神信息。
苦求参数讲解:
参数是否必须默许值花样含义 uid 是 8ee4560cf91d160e6cc02cd7 POI uid output 否 json或xml 输出花样 ak 必选 vDh8mxgqaG4clKP7u 用户的探望密钥 sn 可选。 LiD0WoSTit8b8teqHSNysUrK63a3m 用户的权限签名 timestamp sn存在时必选。 1352887837758 时辰戳 奇迹示例:复返后果:?uid=c14fc238f7fadd4ea5da390f&output=json&ak=6cb3f458a482fcd009414370808ea219//证实uid: "c14fc238f7fadd4ea5da390f查询该POI对应的通盘团购信息。
复返后果有两种体式,一种是json,另一种为xml,默许为xml花样,底下示例为json花样。
{ status: 0, message: "ok", result: { uid: "c14fc238f7fadd4ea5da390f", name: "觉品壹号", lcatin: { lat: "39.905745", lng: "116.390223" }, address: "西城区南新华街1号瑞驰大旅社1楼(近地铁和平门站)", telephne: "(010)63022277,(010)63188187", events: [ { cn_name: "糯米网", grupn_end: "2013-08-01", grupn_id: "4309423174", grupn_image: "http://tuanimg.baidu.cm/data/2_618fcdeff527f6c3e4af41be48693f4f", grupn_num: "55", grupn_price: "368", grupn_rebate: "2.4", grupn_price: "368",grupn_site: "http://bj.numi.cm", grupn_start: "2013-02-05", grupn_tips: "1、糯米券灵验期为2013年02月05日至2013年08月04日</br>2、贸易时辰:11:00-14:00;17:00-21:00</br>3、请提前24小时预约,预约电话:010-63188187/13552470897</br>4、糯米券不限购买数目,每张糯米券提议6东说念主使用</br>5、节沐日通用(春节、情东说念主节均不错使用)</br>6、糯米券不达成、不找零,不与店内其他优惠同享", grupn_title: "[觉品壹号会所]6东说念主套餐!创意惊艳岁末宴,春节、沐日通用!", grupn_type: "1", grupn_url_mbile: "?frm=bdmapwise&url=http://m.numi.cm/deal/view?tinyurl=0wua4ryz", grupn_url_pc: "?frm=bdmappc&url=http://bj.numi.cm/deal/0wua4ryz.html?utm_surce=baidu-cps&utm_medium=ny-pic&utm_campaign=ny-pic&cid=006001", regular_price: "1558", reservatin: "1", shrt_title: "觉品壹号368", spend_end_time: "1375631999" } ] } }8.景况码附录 复返码界说英文复返形色 0过去ok 2苦求参数犯法Parameter Invalid 3权限校验失败Verify Failure 4配额校验失败Quota Failure 5ak不存在或者犯法AK Failure 2xx无权限 3xx配额造作 9.升级讲解 v2版块较之v1版块,功能更新详见更新日记,且苦求url参数:新增版块号“v2”,修改“key”为“ak”。V2不兼容v1版块的key,若需升级,请重新得回密钥。 若需稽察v1文档,请探望“Place APIv1.0”。