全部產品
Search

搜尋本產品

    Intelligent Media Management：QueryLocationDateClusters - 查詢時空聚類

    文件中心

    Intelligent Media Management：QueryLocationDateClusters - 查詢時空聚類

    更新時間：Feb 26, 2026

    查詢時空聚類列表資訊，支援多種條件，詳情請參考請求參數。

    介面說明

    • 請確保在使用該介面前，已充分瞭解Intelligent Media Management產品的收費方式和價格。

    • 調用該介面前，請先通過 CreateLocationDateClusteringTask 介面進行時空聚類。

    調試

    您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

    調試

    授權資訊

    下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

    • 操作：是指具體的許可權點。

    • 存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。

    • 資源類型：是指操作中支援授權的資源類型。具體說明如下：

      • 對於必選的資源類型，用前面加 * 表示。

      • 對於不支援資源級授權的操作，用全部資源表示。

    • 條件關鍵字：是指雲產品自身定義的條件關鍵字。

    • 關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    imm:QueryLocationDateClusters

    list

    *Dataset

    acs:imm:{#regionId}:{#accountId}:project/{#ProjectName}/dataset/{#DatasetName}

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    ProjectName

    string

    是

    專案名稱，擷取方式請參見建立專案。

    test-project
    DatasetName

    string

    是

    資料集名稱，擷取方式請參見建立資料集。

    test-dataset
    ObjectId

    string

    否

    要查詢的分組 ID。如果您需要獲得某個特定時空聚類分組的資訊，則傳入該參數。否則留空，通過其他參數查詢符合匹配條件的分組。

    location-date-cluster-71dd4f32-9597-4085-a2ab-3a7b0fd0aff9
    Title

    string

    否

    時空聚類的標題，精確匹配。

    杭州
    Address Address

    否

    地址資訊。

    LocationDateClusterLevels

    array

    否

    要查詢的時空聚類分組的行政層級。

    string

    否

    分組行政層級。

    枚舉值：

    • country :

      國家或地區

    • province :

      省

    • district :

      區

    • city :

      市

    • township :

      街道

    province
    LocationDateClusterStartTimeRange TimeRange

    否

    分組起始時間的範圍。

    LocationDateClusterEndTimeRange TimeRange

    否

    分組結束時間的範圍。

    CreateTimeRange TimeRange

    否

    時空聚類分組產生的時間範圍。

    UpdateTimeRange TimeRange

    否

    時空聚類分組更新的時間範圍。

    NextToken

    string

    否

    翻頁標記。

    MzQNjmY2MzYxNhNjk2ZNjEu****
    MaxResults

    integer

    否

    每頁顯示數量，取值範圍為[1,100]，預設值為 20。

    20
    CustomLabels

    string

    否

    自訂標籤查詢條件。

    key=value
    Sort

    string

    否

    排序欄位。

    枚舉值：

    • LocationDateClusterEndTime :

      時空聚類分組的結束時間

    • CreateTime :

      時空聚類分組的建立時間

    • UpdateTime :

      時空聚類分組的更新時間

    • LocationDateClusterStartTime :

      【預設】時空聚類分組的開始時間

    LocationDateClusterStartTime
    Order

    string

    否

    排序次序。

    枚舉值：

    • asc :

      【預設】升序

    • desc :

      降序

    asc

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    Schema of Response

    RequestId

    string

    請求 ID。

    7055FCF7-4D7B-098E-BD4D-DD2932B0****
    LocationDateClusters

    array

    時空分組列表。

    LocationDateCluster

    時空聚類資訊。

    NextToken

    string

    翻頁標記。

    MzQNjmY2MzYxNhNjk2ZNjEu****

    樣本

    正常返回樣本

    JSON格式

    {
  "RequestId": "7055FCF7-4D7B-098E-BD4D-DD2932B0****",
  "LocationDateClusters": [
    {
      "Title": "杭州一日遊",
      "LocationDateClusterLevel": "province",
      "LocationDateClusterStartTime": "2022-05-01T00:00:00+08:00",
      "LocationDateClusterEndTime": "2022-05-02T23:59:59.999999999+08:00",
      "Addresses": [
        {
          "Language": "zh-Hans",
          "AddressLine": "中國浙江省杭州市餘杭區文一西路969號",
          "Country": "中國",
          "Province": "浙江省",
          "City": "杭州市",
          "District": "餘杭區",
          "Township": "文一西路"
        }
      ],
      "ObjectId": "location-date-cluster-14f48cb3-079d-4595-80c4-5735284b****",
      "UpdateTime": "2022-11-16T13:15:05.65746784+08:00",
      "CreateTime": "2022-11-16T13:14:34.882523669+08:00",
      "CustomId": "user-01",
      "CustomLabels": {
        "User": "Jane"
      }
    }
  ],
  "NextToken": "MzQNjmY2MzYxNhNjk2ZNjEu****"
}

    錯誤碼

    訪問錯誤中心查看更多錯誤碼。

    變更歷史

    更多資訊，參考變更詳情。