Pois/round

跳转到: 导航, 搜索

目录

pois/round

根据关键字和(或)分类,在中心点附近搜索,返回相关的poi点信息

URL

http://api.t.sina.com.cn/location/pois/round.(json%7Cxml)

支持格式

XML/JSON

HTTP请求方式

GET

是否需要登录

true

请求数限制

true

请求参数

参数 必选 类型及范围 说明
source true string 申请应用时分配的AppKey,调用接口时候代表应用的唯一身份。
注意:以下两个参数至少填一个
q false string 查询的关键字
category false string 查询poi分类代码(详见分类代码对照表
注意:以下两个参数选填一个
coordinate false string 搜索中心点坐标(经纬度用逗号分隔。若只有坐标,则输出不含中心点poi信息)
pid false string 搜索中心点的pid(若填此项会覆盖coordinate参数,此时输出会有中心点poi信息)
注意:以下参数选填
dr false float 搜索半径,最大为500,默认为500。
city false string 城市代码(不填城市代码,默认在全国搜索,详见城市代码对照表
注意:结果最多只返回50条记录,若有其他需求请及时与我们取得联系
page false int 返回的首条结果在结果集中的页码(默认为1,最大为40)
count false int 返回的结果集中每页的结果数(默认为10,最大为50)

返回结果

XML示例

  <?xml version="1.0" encoding="utf-8" ?> 
  <geoSearchResult> 
    <total>6</total> 
    <count>2</count> 
    <page>1</page> 
    <center_poi>
      <poi>
       <pid>B000A7O1CU</pid> 
       <name>颐和园</name> 
       <address>北京市海淀区颐和园路21号</address> 
       <category>110201</category>
       <navigator>世界遗产</navigator>
       <telephone>010-62881144</telephone> 
       <pic_url>mapabcpic/db7282901da891bea2fcd73840caad1c-1252980038.bmp</pic_url> 
       <longitude>116.2739</longitude> 
       <latitude>39.99957</latitude> 
      </poi>
    </center_poi>
    <pois>
      <poi>
       <pid>P010A00D46N</pid> 
       <name>老八旗营饮食</name> 
       <address>青龙桥东街1号平房</address> 
       <category>100200</category> 
       <navigator>旅馆招待所</navigator> 
       <telephone>010-62876066</telephone> 
       <pic_url /> 
       <longitude>116.27088</longitude> 
       <latitude>40.00284</latitude> 
      </poi>
     ...
    </pois>
</geoSearchResult>

JSON示例

{
 "result":"1",
 "total":"6",
 "count":"2",
 "page":"1",
 "center_poi":
 {
  "poi":
  {
   "pid":"B000A7O1CU",
   "name":"\u9890\u548c\u56ed",
   "address":"\u5317\u4eac\u5e02\u6d77\u6dc0\u533a\u9890\u548c\u56ed\u8def21\u53f7",
   "category":"110201",
   "navigator":"\u6751\u5e84\u7ea7\u5730\u540d",
   "telphone":"010-62881144",
   "pic_url":"mapabcpic\/db7282901da891bea2fcd73840caad1c-1252980038.bmp",
   "longitude":"116.2739",
   "latitude":"39.99957"
  }
 },
 "pois":
 [{
   "pid":"P010A00D46N",
   "name":"\u8001\u516b\u65d7\u8425\u996e\u98df",
   "address":"\u9752\u9f99\u6865\u4e1c\u88571\u53f7\u5e73\u623f",
   "category":"100200","navigator":"\u65c5\u9986\u62db\u5f85\u6240",
   "navigator":"\u6751\u5e84\u7ea7\u5730\u540d",
   "telephone":"010-62876066",
   "pic_url":"",
   "longitude":"116.27088",
   "latitude":"40.00284"
  },
  ...
 ]
}

字段说明

total:结果总数
count:本页返回的结果数
page:本页返回的首条结果在结果集中的页码
center_poi:中心点的信息(用id和city查询时返回,用xy作为中心点参数时,不返回center_poi信息)
pid:中心点的poi_id(全局id)
category:中心点的类别代码
navigator:中心点的分类导航名称
name:中心点的名称
address:中心点的地址
telephone:中心点的电话
pic_url:中心点的图片地址
longitude:中心点的经度
latitude:中心点的纬度
pois:结果poi集
pid:本条poi记录的id
title:poi点名称
address:poi点的地址
category:poi点的分类
navigator:poi点的分类导航名称
telephone:poi点的电话
pic_url:poi点的图片地址
longitude:poi点的经度
latitude:poi点的纬度

其它

PHP示例

需要开启PHP的cURL扩展

<?php
//改为你的微博账号,用户名和密码之间用:隔开
$userPwd = 'user@sina.com:pwd';
//改为你微博应用的appkey
$appkey = '0123456789';
//查询关键词
$q = urlencode("123");

$url = "http://api.t.sina.com.cn/location/pois/round.xml?coordinate=116.36993,39.97646&q=$q&city=0010&source=$appkey";

$rst = curlSample($url,$userPwd);

echo $rst;

function curlSample($url,$userPwd,$postFields = '',$header = ''){
	$ch = curl_init() or die (curl_error()) ;
	curl_setopt($ch,CURLOPT_URL,$url);
	curl_setopt($ch,CURLOPT_RETURNTRANSFER,1);
	curl_setopt($ch,CURLOPT_TIMEOUT,30);
	if(!empty($userPwd)){
		curl_setopt($ch,CURLOPT_USERPWD,$userPwd);
	}
	if(!empty($postFields)){
		curl_setopt($ch,CURLOPT_POST,true);
		curl_setopt($ch,CURLOPT_POSTFIELDS,$postFields);
	}
	if(!empty($header)){
		curl_setopt($ch, CURLOPT_HTTPHEADER,$header);
	}
	$result = curl_exec($ch) or die (curl_error($ch));
	curl_close($ch);
	return $result;
}
?>