すべてのプロダクト
Search
ドキュメントセンター

Intelligent Media Management:QueryLocationDateClusters

最終更新日:Feb 26, 2026

指定された条件に基づいて、時空間クラスターのリストをクエリします。

操作説明

  • この操作を呼び出す前に、IMM の課金について理解しておく必要があります。

  • この操作を呼び出す前に、CreateLocationDateClusteringTask 操作を呼び出して、プロジェクトに時空間クラスターを作成しておく必要があります。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

  • アクション:特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。

  • API:アクションを具体的に実行するための API。

  • アクセスレベル:各 API に対して事前定義されているアクセスの種類。有効な値:create、list、get、update、delete。

  • リソースタイプ:アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。

    • リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。

    • リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。

  • 条件キー:サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。

  • 依存アクション:ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

imm:QueryLocationDateClusters

list

*Dataset

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

なし なし

リクエストパラメーター

パラメーター

必須 / 任意

説明

ProjectName

string

必須

プロジェクト名。プロジェクト名は CreateProject 操作の応答から取得できます。

test-project

DatasetName

string

必須

データセット名。データセットの作成方法については、「CreateDataset」をご参照ください。

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

列挙値:

  • country :
  • province :
  • district :
  • city :
  • township :

province

LocationDateClusterStartTimeRange TimeRange

任意

クラスター内の最も古い写真が撮影された時間範囲。

LocationDateClusterEndTimeRange TimeRange

任意

クラスター内の最新の写真が撮影された時間範囲。

CreateTimeRange TimeRange

任意

時空間クラスターが生成された時間範囲。

UpdateTimeRange TimeRange

任意

時空間クラスターが更新された時間範囲。

NextToken

string

任意

ページネーショントークン。

MzQNjmY2MzYxNhNjk2ZNjEu****

MaxResults

integer

任意

1ページあたりのエントリ数。有効値:[1,100]。デフォルト値:20。

20

CustomLabels

string

任意

カスタムラベル。

key=value

Sort

string

任意

クエリ結果のソートに使用するフィールド。

有効値:

  • LocationDateClusterEndTime:クラスター内の最新の写真が撮影された時間。

  • CreateTime:時空間クラスターの作成時間。

  • UpdateTime:時空間クラスターの更新時間。

  • LocationDateClusterStartTime:クラスター内の最も古い写真が撮影された時間。これがデフォルト値です。

列挙値:

  • LocationDateClusterEndTime :
  • CreateTime :
  • UpdateTime :
  • LocationDateClusterStartTime :

LocationDateClusterStartTime

Order

string

任意

クエリ結果のソート順。

有効値:

  • asc:昇順。これがデフォルト値です。

  • desc:降順。

列挙値:

  • asc :
  • desc :

asc

レスポンスフィールド

フィールド

説明

object

応答のスキーマ

RequestId

string

リクエスト ID。

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

LocationDateClusters

array

時空間クラスターのリスト。

LocationDateCluster

時空間クラスター情報。

NextToken

string

ページネーショントークン。このトークンを次のリクエストに含めることで、続きのページの結果を取得できます。

MzQNjmY2MzYxNhNjk2ZNjEu****

成功レスポンス

JSONJSON

{
  "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****"
}

エラーコード

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。