跳转到：导航, 搜索

2012年11月21日 (三) 10:31的版本

location/pois/search/by_geo

根据关键词按坐标点范围获取POI点的信息

URL

https://api.weibo.com/2/location/pois/search/by_geo.json

支持格式

JSON

HTTP请求方式

GET

是否需要登录

是
关于登录授权，参见如何登录授权

访问授权限制

访问级别：普通接口
频次限制：是
关于频次限制，参见接口访问权限说明

请求参数

	必选	类型及范围	说明
access_token	true	string	采用OAuth授权方式为必填参数，OAuth授权后获得。
q	false	string	查询的关键词，必须进行URLencode，与category参数必选其一。
coordinate	false	string	查询的中心点坐标，经度纬度用逗号分隔，与pid参数必选其一，pid优先。例：116.322479,39.980781。
cenname	false	string	中心点名称，如：理想国际大厦。
city	false	string	城市编码:支持编码和名称形式，如0010或者北京，需要进行urlencode编码，默认为全国搜索。
range	false	string	查询范围半径，默认为3000。
page	false	int	返回结果的页码，默认为1，最大为40。
count	false	int	单页返回的记录条数，默认为10，最大为200。
searchtype	false	string	查询类型:POI分类类型，需要进行urlencode编码，如：住宅小区。
srctype	false	string	数据源类型，POI：基础库，BUS：公交站台。可混合查询。例如公交数据+基础库数据查询，srctype取值为“BUS:1000%2bPOI ”，代表前1000条数据为公交数据，后面为基础库数据。
naviflag	false	int	航距离排序标识，默认为0，不按照导航距离排序，如果为1将按照导航距离排序，但性能比直线距离排序差。
sr	false	int	排序参数， sr为1代表按照距离排序。

注意事项

此接口为综合查询接口coordinate、cenname、q，3个参数中，选择q：为关键字查询；选择coordinate+q：根据中心点坐标查询周边poi；选择cenname+q：根据中心点关键字查询周边poi

调用样例及调试工具

API测试工具

返回结果

JSON示例

{
    "message": "ok",
    "bounds": "116.310034;39.984397;116.310034;39.984397",
    "total": "4908",
    "record": "2",
    "cache": "false",
    "count": "200",
    "poilist": [
        {
            "gridcode": "5916728402",
            "typecode": "170206",
            "tel": "",
            "newtype": "170206",
            "xml": "",
            "code": "110108",
            "type": "公司企业;公司;网络科技",
            "imageid": "0a802008042600000673",
            "url": "",
            "citycode": "010",
            "timestamp": "2012-09-10",
            "distance": "0",
            "buscode": "",
            "pguid": "B000A7JKB1",
            "address": "北四环西路58号理想国际大厦408",
            "name": "华旅信通(安游网)",
            "linkid": "",
            "match": "10",
            "drivedistance": "0",
            "srctype": "poi",
            "y": "39.984397",
            "x": "116.310034"
        },
        {
            "gridcode": "5916728402",
            "typecode": "170206",
            "tel": "",
            "newtype": "170206",
            "xml": "",
            "code": "110108",
            "type": "公司企业;公司;网络科技",
            "imageid": "0a802008042600000673",
            "url": "",
            "citycode": "010",
            "timestamp": "2012-09-10",
            "distance": "0",
            "buscode": "",
            "pguid": "B000A7WGK6",
            "address": "北四环西路58号理想国际大厦705",
            "name": "分水(北京)科技有限公司",
            "linkid": "",
            "match": "10",
            "drivedistance": "0",
            "srctype": "poi",
            "y": "39.984397",
            "x": "116.310034"
        }
    ],
    "searchtime": "64",
    "cenpoi": {
        "gridcode": "5916728402",
        "typecode": "120201",
        "tel": "",
        "newtype": "120201",
        "xml": "",
        "code": "110108",
        "type": "商务住宅;楼宇;商务写字楼",
        "imageid": "0a802008042600000673",
        "url": "",
        "citycode": "010",
        "timestamp": "2012-02-14",
        "distance": "0",
        "buscode": "",
        "pguid": "B000A843BB",
        "address": "北四环西路58",
        "name": "理想国际大厦",
        "linkid": "",
        "match": "10",
        "drivedistance": "0",
        "srctype": "poi",
        "y": "39.984392",
        "x": "116.310026"
    },
    "cplist": "",
    "pinyin": {
        "list": ""
    },
    "adlist": ""
}

关于错误返回值与错误代码，参见错误代码说明

返回字段说明

无

其他

无

@@ 第8行： / 第8行： @@
 params=
 {{api_args|q|false|string|查询的关键词，必须进行URLencode，与category参数必选其一。}}
-{{api_args|category|false|string|查询的分类代码，与q参数必选其一，取值范围见：分类代码对应表。}}
+{{api_args|coordinate|false|string|查询的中心点坐标，经度纬度用逗号分隔，与pid参数必选其一，pid优先。例：116.322479,39.980781。}}
-{{api_args|coordinate|false|string|查询的中心点坐标，经度纬度用逗号分隔，与pid参数必选其一，pid优先。}}
+{{api_args|cenname|false|string|中心点名称，如：理想国际大厦。}}
-{{api_args|pid|false|string|查询的中心点POI的ID，与coordinate参数必选其一，pid优先。}}
+{{api_args|city|false|string|城市编码:支持编码和名称形式，如0010或者北京，需要进行urlencode编码，默认为全国搜索。}}
-{{api_args|city|false|string|城市代码，默认为全国搜索。}}
+{{api_args|range|false|string|查询范围半径，默认为3000。}}
-{{api_args|range|false|string|查询范围半径，默认为500，最大为500。}}
 {{api_args|page|false|int|返回结果的页码，默认为1，最大为40。}}
-{{api_args|count|false|int|单页返回的记录条数，默认为10，最大为20。}}|
+{{api_args|count|false|int|单页返回的记录条数，默认为10，最大为200。}}
+{{api_args|searchtype|false|string| 查询类型:POI分类类型，需要进行urlencode编码，如：住宅小区。}}
+{{api_args|srctype|false|string|数据源类型，POI：基础库，BUS：公交站台。可混合查询。例如公交数据+基础库数据查询，srctype取值为“BUS:1000%2bPOI ”，代表前1000条数据为公交数据，后面为基础库数据。}}
+{{api_args|naviflag|false|int|航距离排序标识， 默认为0，不按照导航距离排序，如果为1将按照导航距离排序，但性能比直线距离排序差。}}
+{{api_args|sr|false|int|排序参数， sr为1代表按照距离排序。}}
+|
 apiToolPara=key1=q&value1=理想国际大厦&key2=coordinate&value2=116.322479,39.980781|
 relat_qa=<html><div id="relat_qa" data="location/pois/search/by_geo 位置"></div></html>|
@@ 第20行： / 第25行： @@
 <pre>
 {
-     "center_poi": {
+     "message": "ok",
-        "pid": "P010A00CHR9",
+    "bounds": "116.310034;39.984397;116.310034;39.984397",
-        "longitude": "116.39794",
+    "total": "4908",
-        "latitude": "39.90817",
+    "record": "2",
-        "name": "理想国际大厦",
+    "cache": "false",
-        "city_name": "北京",
+    "count": "200",
-        "province_name": "北京",
+     "poilist": [
-        "address": "北四环西路58号",
-        "telephone": "62670000",
-        "category": "110201",
-        "navigator": "写字楼",
-        "pic_url": "http://sinaimg/34759324759.jpg"
-    },
-     "pois": [
          {
-             "pid": "P010A00CHR9",
+             "gridcode": "5916728402",
-             "longitude": "116.39794",
+             "typecode": "170206",
-             "latitude": "39.90817",
+             "tel": "",
-             "name": "理想国际大厦",
+             "newtype": "170206",
-             "city_name": "北京",
+             "xml": "",
-             "province_name": "北京",
+             "code": "110108",
-             "address": "北四环西路58号",
+            "type": "公司企业;公司;网络科技",
-             "telephone": "62670000",
+            "imageid": "0a802008042600000673",
-             "category": "110201",
+            "url": "",
-             "navigator": "写字楼",
+            "citycode": "010",
-             "pic_url": "http://sinaimg/34759324759.jpg"
+            "timestamp": "2012-09-10",
+            "distance": "0",
+            "buscode": "",
+            "pguid": "B000A7JKB1",
+             "address": "北四环西路58号理想国际大厦408",
+             "name": "华旅信通(安游网)",
+             "linkid": "",
+             "match": "10",
+             "drivedistance": "0",
+            "srctype": "poi",
+            "y": "39.984397",
+            "x": "116.310034"
          },
-         ...
+         {
+            "gridcode": "5916728402",
+            "typecode": "170206",
+            "tel": "",
+            "newtype": "170206",
+            "xml": "",
+            "code": "110108",
+            "type": "公司企业;公司;网络科技",
+            "imageid": "0a802008042600000673",
+            "url": "",
+            "citycode": "010",
+            "timestamp": "2012-09-10",
+            "distance": "0",
+            "buscode": "",
+            "pguid": "B000A7WGK6",
+            "address": "北四环西路58号理想国际大厦705",
+            "name": "分水(北京)科技有限公司",
+            "linkid": "",
+            "match": "10",
+            "drivedistance": "0",
+            "srctype": "poi",
+            "y": "39.984397",
+            "x": "116.310034"
+        }
      ],
-     "total_number": 36
+     "searchtime": "64",
+    "cenpoi": {
+        "gridcode": "5916728402",
+        "typecode": "120201",
+        "tel": "",
+        "newtype": "120201",
+        "xml": "",
+        "code": "110108",
+        "type": "商务住宅;楼宇;商务写字楼",
+        "imageid": "0a802008042600000673",
+        "url": "",
+        "citycode": "010",
+        "timestamp": "2012-02-14",
+        "distance": "0",
+        "buscode": "",
+        "pguid": "B000A843BB",
+        "address": "北四环西路58",
+        "name": "理想国际大厦",
+        "linkid": "",
+        "match": "10",
+        "drivedistance": "0",
+        "srctype": "poi",
+        "y": "39.984392",
+        "x": "116.310026"
+    },
+    "cplist": "",
+    "pinyin": {
+        "list": ""
+    },
+    "adlist": ""
 }
 </pre>|
 resultDes=无|
-useAge=无|
+useAge=
+*此接口为综合查询接口coordinate、cenname、q，3个参数中，选择q：为关键字查询；选择coordinate+q：根据中心点坐标查询周边poi；选择cenname+q：根据中心点关键字查询周边poi
+|
 otherInfo=无
 }}{{#a:showgrade}}

微博开放平台

首页

平台政策与指引

微博登录接入

移动应用接入

媒体接入平台

电商接入平台

粉丝服务平台

商业接口

网站接入

微博API

资源下载

常见问题

联系我们

工具箱

2012年11月21日 (三) 10:31的版本

location/pois/search/by_geo

URL

支持格式

HTTP请求方式

是否需要登录

访问授权限制

请求参数

注意事项

调用样例及调试工具

返回结果

返回字段说明

其他

相关问题