TdtPOI
查阅Cesium API

new mars3d.query.TdtPOI(options)
query/TdtPOI.js 9

天地图 POI查询 工具类， 参考文档：http://lbs.tianditu.gov.cn/server/search2.html

参数名称 类型 描述信息
options object 可选

参数对象，包括以下：

参数名称 类型 默认值 描述信息
key string | Array.<string> mars3d.Token.tiandituArr 可选

天地图KEY,在实际项目中请使用自己申请的天地图KEY，因为我们的key不保证长期有效。
headers object {} 可选

将被添加到HTTP请求头。
proxy Cesium.DefaultProxy 可选

加载资源时使用的代理。

成员(属性)

readonly key : string
query/TdtPOI.js 49

轮询取单个key进行使用

keys : Array.<string>
query/TdtPOI.js 36

天地图key数组，内部轮询使用

方法

autoTip(queryOptions) → Promise.<object>
query/TdtPOI.js 161

天地图搜索提示

参数名称 类型 描述信息
queryOptions object

查询参数

参数名称 类型 描述信息
text string

输入建议关键字（支持拼音）
extent object 可选

查询的地图范围: { xmin: 70, xmax: 140, ymin: 0, ymax: 55 } ，可以传入extent: map.getExtent()
city string 可选

可以限定查询的行政区
success function 可选

查询完成的回调方法
error function 可选

查询失败的回调方法
返回值:

查询完成的Promise,等价于success参数

getAddress(queryOptions) → Promise.<object>
query/TdtPOI.js 100

根据经纬度坐标获取地址，逆地理编码

参数名称 类型 描述信息
queryOptions object

查询参数

参数名称 类型 描述信息
location LngLatPoint | Cesium.Cartesian3 | string | Array | object 可选

经纬度坐标
success function 可选

查询完成的回调方法
error function 可选

查询失败的回调方法
返回值:

查询完成的Promise,等价于success参数

query(queryOptions) → Promise.<object>
query/TdtPOI.js 247

按限定区域搜索

参数名称 类型 描述信息
queryOptions object

查询参数

参数名称 类型 默认值 描述信息
text string

检索关键字。支持多个关键字并集检索，不同关键字间以空格符号分隔，最多支持10个关键字检索。
types string '' 可选

检索分类偏好，与text组合进行检索，多个分类以","分隔（POI分类），如果需要严格按分类检索，请通过text参数设置
graphic BaseGraphic | * 可选

限定的搜索区域
city string 可选

当不存在graphic时，可以重新限定查询的城市(行政区的国标码)
limit boolean false 可选

取值为"true"，严格返回限定区域内检索结果
page number 0 可选

分页页码，默认为0, 0代表第一页，1代表第二页，以此类推。常与 count 搭配使用，仅当返回结果为poi时可以翻页。
count number 20 可选

单次召回POI数量，默认为10条记录，最大返回20条。多关键字检索时，返回的记录数为关键字个数count。多关键词检索时，单页返回总数=关键词数量count
error function 可选

查询失败的回调方法
success function 可选

查询完成的回调方法
返回值:

查询完成的Promise,等价于success参数

queryCircle(queryOptions) → Promise.<object>
query/TdtPOI.js 425

周边搜索(圆形搜索)

参数名称 类型 描述信息
queryOptions object

查询参数

参数名称 类型 默认值 描述信息
text string

检索关键字。支持多个关键字并集检索，不同关键字间以空格符号分隔，最多支持10个关键字检索。
types string '' 可选

检索分类偏好，与text组合进行检索，多个分类以","分隔（POI分类），如果需要严格按分类检索，请通过text参数设置
location LngLatPoint | Cesium.Cartesian3 | string | Array | object 可选

圆形区域检索中心点，取值范围:0-50000。规则：大于50000按默认值，单位：米
radius number 3000 可选

圆形区域检索半径，单位为米。（增加区域内数据召回权重，如需严格限制召回数据在区域内，请搭配使用radiuslimit参数），当半径过大，超过中心点所在城市边界时，会变为城市范围检索，检索范围为中心点所在城市
limit boolean false 可选

是否严格限定召回结果在设置检索半径范围内。true（是），false（否）。设置为true时会影响返回结果中total准确性及每页召回poi数量， 设置为false时可能会召回检索半径外的poi。
count number 20 可选

单次召回POI数量，最大返回25条。多关键字检索时，返回的记录数为关键字个数count。多关键词检索时，单页返回总数=关键词数量count
page number 0 可选

分页页码，默认为0, 0代表第一页，1代表第二页，以此类推。常与 count 搭配使用，仅当返回结果为poi时可以翻页。
success function 可选

查询完成的回调方法
error function 可选

查询失败的回调方法
返回值:

查询完成的Promise,等价于success参数

queryExtent(queryOptions) → Promise.<object>
query/TdtPOI.js 651

视野内搜索

参数名称 类型 描述信息
queryOptions object

查询参数

参数名称 类型 默认值 描述信息
text string

检索关键字。支持多个关键字并集检索，不同关键字间以空格符号分隔，最多支持10个关键字检索。
types string '' 可选

检索分类偏好，与text组合进行检索，多个分类以","分隔（POI分类），如果需要严格按分类检索，请通过text参数设置
extent Array.<Array> | object

可传入左上右下两顶点坐标对或{ xmin: 70, xmax: 140, ymin: 0, ymax: 55 }；
count number 20 可选

单次召回POI数量，最大返回25条。多关键字检索时，返回的记录数为关键字个数count。多关键词检索时，单页返回总数=关键词数量count
page number 0 可选

分页页码，默认为0, 0代表第一页，1代表第二页，以此类推。常与 count 搭配使用，仅当返回结果为poi时可以翻页。
success function 可选

查询完成的回调方法
error function 可选

查询失败的回调方法
返回值:

查询完成的Promise,等价于success参数

queryPolygon(queryOptions) → Promise.<object>
query/TdtPOI.js 535

多边形搜索

参数名称 类型 描述信息
queryOptions object

查询参数

参数名称 类型 默认值 描述信息
text string

检索关键字。支持多个关键字并集检索，不同关键字间以空格符号分隔，最多支持10个关键字检索。
types string '' 可选

检索分类偏好，与text组合进行检索，多个分类以","分隔（POI分类），如果需要严格按分类检索，请通过text参数设置
polygon Array.<Array>

经纬度数组，经纬度小数点后不得超过6位。多边形为矩形时，可传入左上右下两顶点坐标对；其他情况下首尾坐标对需相同。
limit boolean false 可选

是否严格限定召回结果在设置检索的多边形或矩形范围内。true（是），false（否）。设置为true时会影响返回结果中total准确性及每页召回poi数量， 设置为false时可能会召回检索半径外的poi。
count number 20 可选

单次召回POI数量，最大返回25条。多关键字检索时，返回的记录数为关键字个数count。多关键词检索时，单页返回总数=关键词数量count
page number 0 可选

分页页码，默认为0, 0代表第一页，1代表第二页，以此类推。常与 count 搭配使用，仅当返回结果为poi时可以翻页。
success function 可选

查询完成的回调方法
error function 可选

查询失败的回调方法
返回值:

查询完成的Promise,等价于success参数

queryText(queryOptions) → Promise.<object>
query/TdtPOI.js 338

关键字搜索

参数名称 类型 描述信息
queryOptions object

查询参数

参数名称 类型 默认值 描述信息
text string

检索关键字。支持多个关键字并集检索，不同关键字间以空格符号分隔，最多支持10个关键字检索。
types string '' 可选

检索分类偏好，与text组合进行检索，多个分类以","分隔（POI分类），如果需要严格按分类检索，请通过text参数设置
city string 可选

可以重新限定查询的城市(行政区的国标码)
level string 18 可选

查询的级别,1-18级
extent object 可选

查询的地图范围: { xmin: 70, xmax: 140, ymin: 0, ymax: 55 } ，可以传入extent: map.getExtent()
count number 20 可选

单次召回POI数量，最大返回300条。多关键字检索时，返回的记录数为关键字个数count。多关键词检索时，单页返回总数=关键词数量count
page number 0 可选

分页页码，默认为0, 0代表第一页，1代表第二页，以此类推。常与 count 搭配使用，仅当返回结果为poi时可以翻页。
success function 可选

查询完成的回调方法
error function 可选

查询失败的回调方法
返回值:

查询完成的Promise,等价于success参数