すべてのプロダクト
Search

このプロダクト

    Object Storage Service:点群圧縮

    ドキュメントセンター

    Object Storage Service:点群圧縮

    最終更新日:Nov 09, 2025

    点群を保存すると、大量のストレージ容量が消費されます。非圧縮の点群ファイルを転送するには、かなりの帯域幅が必要となり、伝送コストが高くなります。したがって、点群を圧縮する必要があります。

    シナリオ

    • 自動運転: レーダースキャンによって生成された点群データを圧縮します。

    • デジタル文化遺産: 文化遺産の点群データを圧縮してデジタル保存します。

    • スマートシティ: 3D 都市再構築から生成された点群データを圧縮して、スムーズなデータレンダリングと表示を可能にします。

    • 複合現実: 点群データにリアルタイムのエンコーディングおよびデコーディング機能を提供します。

    注意

    • 点群圧縮は、同期処理 (x-oss-process メソッド) のみをサポートします。

    • 点群圧縮を使用する前に、IMM プロジェクトをアタッチする必要があります。コンソールまたは API を使用してプロジェクトをアタッチする方法の詳細については、「クイックスタート」および「AttachOSSBucket - OSS バケットのアタッチ」をご参照ください。

    • 匿名アクセスは拒否されます。

    • この機能を使用するには、必要な権限が必要です。詳細については、「権限」をご参照ください。

    パラメーター

    アクション: pointcloud/compress

    次の表にパラメーターを示します。

    パラメーター

    タイプ

    必須

    説明

    f

    string

    いいえ

    PCD ファイルのフォーマット。現在、pcd フォーマットのみがサポートされています。

    m

    string

    はい

    点群ファイルの圧縮メソッド。有効な値:

    • kdtree: K-d tree。

    • octree: Octree。

    fs

    string

    いいえ

    圧縮する PCD プロパティフィールドと圧縮順序。圧縮後、データはこの順序で解凍されます。現在、xyz プロパティのみがサポートされています。

    説明

    このパラメーターは、URL セーフな Base64 でエンコードする必要があります。たとえば、`xyz` を指定するには、リクエストで `eHl6` を使用します。

    次のパラメーターは Octree 圧縮メソッド用です。これらのパラメーターを /octree パラメーターの後に追加します。

    次の表にパラメーターを示します。

    パラメーター

    タイプ

    必須

    説明

    lib

    string

    いいえ

    圧縮ライブラリの名前。現在、pcl のみがサポートされています。

    pr

    float

    いいえ

    点群の解像度。この変数は、エンコーディング中の点座標の精度を決定します。デフォルト値は 0.01 です。値の範囲は 0 から 1 です。

    or

    float

    いいえ

    Octree をパーティション分割するときの最小ブロックサイズ。これはボクセルのエッジ長です。デフォルト値は 0.01 です。値の範囲は 0 から 1 です。

    d

    int

    いいえ

    ダウンサンプリングを使用するかどうかを指定します。値 1 は、ダウンサンプリングが使用されることを示します。デフォルトではダウンサンプリングが使用されます。

    次のパラメーターは Kdtree 圧縮メソッド用です。これらのパラメーターを /kdtree パラメーターの後に追加します。

    次の表にパラメーターを示します。

    パラメーター

    タイプ

    必須

    説明

    lib

    string

    いいえ

    圧縮ライブラリの名前。現在、draco のみがサポートされています。

    cl

    int

    はい

    圧縮レベル。値が大きいほど、詳細が保持されます。値の範囲は 0 から 10 です。

    qb

    int

    はい

    量子化ビット数。値が大きいほど、詳細が保持されます。値の範囲は 1 から 31 です。

    REST API の使用

    Octree メソッドを使用した点群ファイルの圧縮

    処理メソッド

    • 圧縮ファイル名: example.pcd

    • 圧縮メソッド: Octree

      • 圧縮ライブラリ: pcl

      • 点群解像度: 0.01

      • 最小 Octree ブロックサイズ: 0.01

      • ダウンサンプリングの使用: 1

    • 圧縮する PCD フィールド: xyz

    リクエスト例

    GET /example.pcd?x-oss-process=pointcloud/compress,m_octree,fs_eHl6/octree,or_0.001,pr_0.001,d_1,lib_pcl  HTTP/1.1
Host: file-demo.oss-cn-hangzhou.aliyuncs.com
Date: Fri, 28 Oct 2022 06:40:10 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

    レスポンス例

    HTTP/1.1 200 OK
Server: AliyunOSS
Date: Wed, 25 May 2022 12:15:44 GMT
Content-Type: application/octet-stream
Transfer-Encoding: chunked
Connection: keep-alive
x-oss-request-id: 628E1DEF184E20BB21000004
x-oss-transfer-acc-type: acc-none
x-oss-data-location: oss-cn-hangzhou-a
ETag: "E168EDBFAB5130BCA80EDF84E4E10B59"
Last-Modified: Sat, 02 Apr 2022 11:53:20 GMT
x-oss-object-type: Normal
x-oss-hash-crc64ecma: 5454933848876226229
x-oss-storage-class: Standard
x-oss-server-time: 865

{{圧縮ファイルのバイナリデータ}}

    Kdtree メソッドを使用した点群ファイルの圧縮

    処理メソッド

    • 圧縮ファイル名: example.pcd

    • 圧縮メソッド: Kdtree

      • 圧縮ライブラリ: draco

      • 圧縮レベル: 1

      • 量子化ビット: 1

    • 圧縮する PCD フィールド: xyz

    例

    GET /example.pcd?x-oss-process=pointcloud/compress,m_kdtree,fs_eHl6/kdtree,cl_0,qb_0,lib_draco  HTTP/1.1
Host: file-demo.oss-cn-hangzhou.aliyuncs.com
Date: Fri, 28 Oct 2022 06:40:10 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

    レスポンス例

    HTTP/1.1 200 OK
Server: AliyunOSS
Date: Wed, 25 May 2022 12:15:44 GMT
Content-Type: application/octet-stream
Transfer-Encoding: chunked
Connection: keep-alive
x-oss-request-id: 628E1DEF184E20BB21000004
x-oss-transfer-acc-type: acc-none
x-oss-data-location: oss-cn-hangzhou-a
ETag: "E168EDBFAB5130BCA80EDF84E4E10B59"
Last-Modified: Sat, 02 Apr 2022 11:53:20 GMT
x-oss-object-type: Normal
x-oss-hash-crc64ecma: 5454933848876226229
x-oss-storage-class: Standard
x-oss-server-time: 865

{{圧縮ファイルのバイナリデータ}}

    SDK の使用

    点群圧縮は同期処理のみをサポートします。SDK の使用方法の詳細については、「SDK の使用」をご参照ください。

    課金

    点群圧縮では、OSS と IMM に対して次の課金項目が生成されます。

    • OSS: 料金の詳細については、「OSS 料金」をご参照ください。

      API

      課金項目

      説明

      GetObject

      GET リクエスト

      料金は成功したリクエストの数に基づいて計算されます。

      インターネット経由のアウトバウンドトラフィック

      パブリックエンドポイント (例: oss-cn-hangzhou.aliyuncs.com) または転送アクセラレーションエンドポイント (例: oss-accelerate.aliyuncs.com) を使用して GetObject 操作を呼び出すと、インターネット経由のアウトバウンドトラフィックの料金が発生します。これらの料金はデータサイズに基づいて課金されます。

      低頻度アクセス (IA) ストレージからのデータ取得

      取得したデータが IA ストレージクラスに保存されている場合、データ取得料金が発生します。これらの料金は、取得したデータの量に基づいて課金されます。

      転送アクセラレーション

      転送アクセラレーションを有効にし、アクセラレーションエンドポイントを使用してバケットにアクセスすると、転送アクセラレーション料金が発生します。これらの料金はデータサイズに基づいて課金されます。

    • IMM: 料金の詳細については、「IMM 課金項目」をご参照ください。

      重要

      2025 年 7 月 28 日 11:00 (UTC + 08:00) から、IMM 点群圧縮サービスは無料サービスから有料サービスにアップグレードされます。特定の課金項目は PointCloudCompress です。詳細については、「IMM 請求調整のお知らせ」をご参照ください。

      API

      課金項目

      説明

      CreateCompressPointCloudTask

      PointCloudCompress

      料金は成功したリクエストの数に基づいて計算されます。