跳转到: 导航, 搜索

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。
coordinate false string 查询的中心点坐标,经度纬度用逗号分隔。例: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。
  • 通过该接口获取到的poi信息,不适用于Place系列的位置服务。如需使用Place系列定位服务,建议使用place/nearby/pois接口或place/nearby/pois接口。

调用样例及调试工具

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": ""
}

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

返回字段说明

其他

相关问题


帮助中心 查看更多问题或提问


Language: [[{{{2/uri}}}|中文]]




文档更新时间: 2014-02-21