概述

提供终端位置搜索能力。 支持按城市范围、指定位置周边范围、矩形范围，并结合自定义字段筛选功能，搜索符合条件的终端。
如网约车业务：搜索某叫车乘客附近3公里有哪些空载的车辆

终端搜索

请求URL

URL：https://apis.map.qq.com/tracks/entity/search
Method：GET

请求参数

filter（按条件筛选）

按字段值筛选

1. 支持多条件且关系，多个条件用 and 连接（注：and前后有空格）
2. 支持 number 型自定义字段 和 last_loctime 按值筛选： a) 基本条件表达式： 不等于<> ，等于= ，大于等于 >= ，小于等于<= ，大于> ，小于 < b) in枚举表达式 例：filter=entity_fields.ccid in(111,222,333)
3. 支持 string 型 自定义字段 和entity_name,entity_id 用 = 和 in 条件筛选，例： entity_fields.source=“tencent” 及 entity_fields.source in(“tencent”)

orderby（排序方式）

排序方式：

1. 默认按last_loctime倒序（最新的排在最前面）
2. 参数格式：
   orderby=排序字段 排序方式 （排序字段与排序方式之间用空格分隔） 排序方式支持：asc升序 desc降序 多个排序条件用英文逗号分隔
3. 排序字段支持：
   a. last_loctime：终端位置最后更新时间
   b. _distance(lat,lng)：按距离（仅周边搜索支持，按搜索中心点到到的终端位置的距离由近到远升序排序，注：不支持desc降序）
   c. 自定义number型字段
4. 示例：
   orderby=last_loctime desc
   orderby=_distance(39.976194,116.317987)
   orderby=last_loctime,_distance(39.976194,116.317987)
   注意：指定不存在的字段系统将自动忽略（不生效）

响应结果

响应示例

{
    "status": 0,
    "message": "OK",
    "request_id": "64f213e8-ce72-4bd0-840e-e7c0458c6c53-046ffc6285b663c8",
    "result": {
        "count": 1,
        "data": [
            {
                "entity_name": "test-001",
                "entity_id": "entity_001",
                "entity_desc": "测试",
                "create_time": 1652261719,
                "entity_fields": {},
                "last_location": {
                    "lat": 39.120373,
                    "lng": 116.193401,
                    "loctime": 1652263075,
                    "speed": 14,
                    "direction": 0,
                    "altitude": 10,
                    "accuracy": 10,
                    "trace_fields": {}
                }
            }
        ]
    }
}

终端最新位置查询

请求URL

URL：https://apis.map.qq.com/tracks/entity/get_last_location
Method：GET

请求参数

响应结果

响应示例

{
	"status":0,
	"message":"ok",
        "request_id": "5e5ace5e-8873-4afa-a8e4-c539c81ee113-47fb656b130f8eba",
	"result":{
		"last_location":{
			"lat":39.929495,  
			"lng":116.393945, 
			"loctime":1649229527, 
			"speed":15,
			"direction":99,
			"altitude":22, 
			"accuracy":20, 
			"trace_fields":{
				"sheng_yu_you_liang":10.8,  
			}
		}
	}
}