文档

SearchAddressGroups - 根据地点列表查询地点聚类

更新时间:

根据地点列表查询地点聚类。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

当前API暂无授权信息透出。

请求语法

POST /v2/image/search_address_groups

请求参数

名称类型必填描述示例值
bodyobject

请求体参数。

drive_idstring

空间 id

1
tl_geo_pointstring

矩形的左顶点位置(维度,经度)

39.121,101.2121
br_geo_pointstring

矩形的右底点位置(维度,经度)

40.121,105.2121
address_levelstring

查询的地点级别

枚举值:
  • countrycountry
  • provinceprovince
  • citycity
  • districtdistrict
  • townshiptownship
city 一共有5个值可选:如下所示 - country - province - city - district - township
address_namesarray

地点列表

string

地点列表, 数组内个数最多 10 个, 内部的值需要与 address_level 级别对应, 该参数与上边 tl_geo_point 和 br_geo_point 参数互斥,二者选其一

["杭州市","北京市"]
image_thumbnail_processstring

图片缩略图处理样式

image/resize,w_200
video_thumbnail_processstring

视频缩略图处理样式

video/snapshot,t_7000,f_jpg,w_800,h_600,m_fast

返回参数

名称类型描述示例值
object

Schema of Response

itemsarray

地点聚类列表

AddressGroup

地点聚类

示例

正常返回示例

JSON格式

{
  "items": [
    {
      "name": "",
      "location": "30.12231,120.1212",
      "count": 10,
      "cover_url": "",
      "cover_file_id": "",
      "address_detail": {
        "country": "中国",
        "province": "浙江省",
        "city": "杭州市",
        "district": "余杭区",
        "township": "文一西路"
      }
    }
  ]
}

错误码

访问错误中心查看更多错误码。