すべてのプロダクト
Search

このプロダクト

    Intelligent Media Management:CreateLocationDateClusteringTask

    ドキュメントセンター

    Intelligent Media Management:CreateLocationDateClusteringTask

    最終更新日:Jan 29, 2026

    時空間クラスタリング機能は、データセット内のファイルを撮影時刻と位置情報に基づいて分類します。この機能は、撮影時刻と位置情報を含む画像や動画などのインデックス済みファイルに対して動作します。これらの分類結果は、ユーザーの旅行中に撮影された、類似したタイムスタンプと位置情報をもつファイル群を表すことができます。また、ユーザーが居住または勤務している複数の場所で撮影されたコンテンツを表すことも可能です。これらの分類結果の位置情報と時間範囲を分析することで、メディアファイルのカテゴリ分け、ハイライト動画の作成、写真・動画ストーリーの生成が可能になります。

    操作説明

    • この操作を使用する前に、Intelligent Media Management (IMM) の課金方法および料金についてご確認ください。

      重要 非同期タスクの処理時間は保証されていません。

    • この操作を呼び出す前に、データセットにファイルをインデックスしておく必要があります。CreateBinding を使用してデータソースをバインドするか、IndexFileMeta または BatchIndexFileMeta を使用してファイルをインデックスしてください。

    • この操作の各呼び出しは、指定された Dataset 内のファイルを増分的に処理します。新しいファイルを処理するには、定期的にこの操作を呼び出してください。

    • クラスタリングが完了したら、QueryLocationDateClusters 操作を呼び出してクラスタリング結果を取得できます。

    • データセットからファイルを削除しても、時空間クラスターは変更されません。既存の時空間クラスターを削除するには、DeleteLocationDateCluster 操作を呼び出してください。

    • これは非同期操作です。タスク開始後、その情報は 7 日間のみ保存されます。7 日を過ぎるとタスク情報を取得できなくなります。返された TaskId を使用して、GetTask または ListTasks 操作を呼び出すことでタスク情報を確認できます。また、Notification パラメーターを設定することで、メッセージ通知によりタスク情報を受信することも可能です。

    今すぐお試しください

    この 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:CreateLocationDateClusteringTask

    create

    *Dataset

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

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    ProjectName

    string

    必須

    プロジェクト名。詳細については、「プロジェクトの作成」をご参照ください。

    test-project
    DatasetName

    string

    必須

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

    test-dataset
    UserData

    string

    任意

    非同期通知メッセージに含まれるカスタム情報です。これにより、通知メッセージを自社システムと関連付けることができます。最大長は 2,048 バイトです。

    test-data
    Tags

    object

    任意

    非同期タスクの検索およびフィルターに使用するカスタムタグです。

    { "User": "Jane" }
    DateOptions

    object

    必須

    日付クラスタリングの設定です。

    重要 この設定を変更すると、ご利用の Dataset 内の既存の時空間クラスターにも影響します。

    GapDays

    integer

    必須

    単一の時空間グループ内で許容される最大ギャップ日数です。値は 0 ～ 99,999 の範囲内である必要があります。

    たとえば、ユーザーが 3 月 4 日～5 日および 3 月 7 日に写真を撮影しており、3 月 6 日の写真がない場合を考えます。3 月 4 日～7 日の写真が同じ旅行に属すると仮定する場合、このパラメーターを 1 day に設定します。これにより、3 月 6 日の 1 day のギャップを同じ時空間クラスターに含めることができます。

    このパラメーターには 0 ～ 3 の値を設定してください。

    1
    MinDays

    integer

    必須

    単一の時空間グループに必要な最小日数です。値は 1 ～ 99,999 の範囲内である必要があります。この値未満の日数を持つクラスターは検出・保存されません。

    たとえば、1 日の旅行を生成されたグループに含めたくない場合は、このパラメーターを 2 に設定してください。

    1
    MaxDays

    integer

    必須

    単一の時空間グループに許容される最大日数です。値は 1 ～ 99,999 の範囲内である必要があります。この値を超える日数を持つクラスターは検出・保存されません。

    たとえば、ユーザーが同一の場所で 15 日以上連続して写真を撮影している場合、その場所は旅行先ではなく居住地である可能性があります。このような期間と場所を時空間クラスターから除外したい場合は、このパラメーターを 15 に設定してください。

    15
    LocationOptions

    object

    必須

    位置クラスタリングの設定です。

    重要 この設定を変更すると、ご利用の Dataset 内の既存の時空間クラスターにも影響します。

    LocationDateClusterLevels

    array

    必須

    グループ化に使用する行政レベルの一覧です。複数のレベルを選択できます。

    たとえば、ユーザーが 3 月 3 日～5 日に杭州で撮影した写真と、3 月 6 日～8 日に嘉興で撮影した写真をアップロードした場合を考えます。このパラメーターを ["city", "province"] に設定すると、以下の時空間クラスターが生成されます。

    • 3 月 3 日～5 日、杭州

    • 3 月 6 日～8 日、嘉興

    • 3 月 3 日～8 日、浙江省

    string

    必須

    グループ化に使用する行政レベルです。

    列挙値:

    • country :

      国または地域

    • province :

      省

    • city :

      市

    • district :

      区

    • township :

      郷・鎮

    province
    Notification Notification

    任意

    メッセージ通知の構成です。詳細については、「Notification」をご参照ください。非同期通知メッセージのフォーマットについては、「非同期通知メッセージフォーマット」をご参照ください。

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    時空間クラスタリングタスクに関する情報です。

    RequestId

    string

    リクエスト ID です。

    B121940C-9794-4EE3-8D6E-F8EC525F****
    TaskId

    string

    タスク ID です。

    LocationDateClustering-c10dce07-1de7-4da7-abee-1a3aba7****
    EventId

    string

    イベント ID です。

    25B-1W2ChgujA3Q8MbBY6mSp2mh****

    例

    成功レスポンス

    JSONJSON

    {
  "RequestId": "B121940C-9794-4EE3-8D6E-F8EC525F****",
  "TaskId": "LocationDateClustering-c10dce07-1de7-4da7-abee-1a3aba7****",
  "EventId": "25B-1W2ChgujA3Q8MbBY6mSp2mh****"
}

    エラーコード

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

    変更履歴

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