Todos os produtos
Search
Central de documentação

Object Storage Service:Point cloud compression

Última atualização: Aug 27, 2026

O armazenamento de nuvens de pontos consome muito espaço. Transferir arquivos de nuvem de pontos sem compressão exige largura de banda significativa e gera altos custos de transmissão. Por isso, comprima as nuvens de pontos.

Cenários

  • Condução autônoma: comprima dados de nuvem de pontos gerados por varreduras de radar.

  • Patrimônio cultural digital: comprima dados de nuvem de pontos de relíquias culturais para preservação digital.

  • Cidade inteligente: comprima dados de nuvem de pontos da reconstrução 3D da cidade para viabilizar renderização e exibição fluidas.

  • Realidade mista: ofereça recursos de codificação e decodificação em tempo real para dados de nuvem de pontos.

Observações

  • A compressão de nuvem de pontos suporta apenas processamento síncrono (método x-oss-process).

  • Antes de usar a compressão de nuvem de pontos, vincule um projeto IMM. Para saber como vincular um projeto no console ou por API, consulte Quick Start e AttachOSSBucket - Attach an OSS bucket.

  • O acesso anônimo será negado.

  • Você precisa ter as permissões necessárias para usar este recurso. Para mais informações, consulte permissions.

Parâmetros

Ação: pointcloud/compress

A tabela a seguir descreve os parâmetros.

Parâmetro

Tipo

Obrigatório

Descrição

f

string

Não

Formato do arquivo PCD. Atualmente, apenas o formato pcd é suportado.

m

string

Sim

Método de compressão do arquivo de nuvem de pontos. Valores válidos:

  • kdtree: Árvore K-d.

  • octree: Octree.

fs

string

Não

Campos de propriedade do PCD a comprimir e ordem de compressão. Após a compressão, os dados são descomprimidos nessa ordem. Atualmente, apenas a propriedade xyz é suportada.

Nota

Codifique este parâmetro em Base64 seguro para URL. Por exemplo, para especificar xyz, use eHI6 na solicitação.

Os parâmetros a seguir aplicam-se ao método de compressão Octree. Acrescente-os após o parâmetro /octree.

A tabela a seguir descreve os parâmetros:

Parâmetro

Tipo

Obrigatório

Descrição

lib

string

Não

Nome da biblioteca de compressão. Atualmente, apenas pcl é suportado.

pr

float

Não

Resolução da nuvem de pontos. Esta variável determina a precisão das coordenadas dos pontos durante a codificação. O valor padrão é 0,01. O intervalo válido vai de 0 a 1.

or

float

Não

Tamanho mínimo do bloco ao particionar a octree, correspondente ao comprimento da aresta de um voxel. O valor padrão é 0,01. O intervalo válido vai de 0 a 1.

d

int

Não

Define se a subamostragem será usada. O valor 1 indica que a subamostragem está ativada. A subamostragem é usada por padrão.

Os parâmetros a seguir aplicam-se ao método de compressão Kdtree. Acrescente-os após o parâmetro /kdtree.

A tabela a seguir descreve os parâmetros:

Parâmetro

Tipo

Obrigatório

Descrição

lib

string

Não

Nome da biblioteca de compressão. Atualmente, apenas draco é suportado.

cl

int

Sim

Nível de compressão. Valores maiores indicam melhor preservação de detalhes. O intervalo válido vai de 0 a 10.

qb

int

Sim

Número de bits de quantização. Valores maiores indicam que mais detalhes são preservados. O intervalo válido vai de 1 a 31.

Usar a API REST

Comprimir um arquivo de nuvem de pontos usando o método Octree

Método de processamento

  • Nome do arquivo comprimido: example.pcd

  • Método de compressão: Octree

    • Biblioteca de compressão: pcl

    • Resolução da nuvem de pontos: 0,01

    • Tamanho mínimo do bloco da octree: 0,01

    • Uso de subamostragem: 1

  • Campos PCD a comprimir: xyz

Exemplo de solicitação

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

Exemplo de resposta

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

{{Binary data of the compressed file}}

Comprimir um arquivo de nuvem de pontos usando o método Kdtree

Método de processamento

  • Nome do arquivo comprimido: example.pcd

  • Método de compressão: Kdtree

    • Biblioteca de compressão: draco

    • Nível de compressão: 1

    • Bits de quantização: 1

  • Campos PCD a comprimir: xyz

Exemplos

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

Exemplo de resposta

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

{{Binary data of the compressed file}}

Usar um SDK

A compressão de nuvem de pontos suporta apenas processamento síncrono. Para mais informações sobre como usar um SDK, consulte Use an SDK.

Faturamento

A compressão de nuvem de pontos gera os seguintes itens faturáveis para OSS e IMM:

  • OSS: Para mais informações sobre preços, consulte Preços do OSS.

    API

    Item faturável

    Descrição

    GetObject

    Solicitações GET

    As taxas são calculadas com base no número de solicitações bem-sucedidas.

    Tráfego de saída pela internet

    Ao chamar a operação GetObject usando um endpoint público (por exemplo, oss-cn-hangzhou.aliyuncs.com) ou um endpoint de aceleração de transferência (por exemplo, oss-accelerate.aliyuncs.com), são geradas taxas de tráfego de saída pela internet. Essas taxas são cobradas com base no tamanho dos dados.

    Recuperação de dados do armazenamento de Acesso Pouco Frequente (IA)

    Se os dados recuperados estiverem armazenados na classe de armazenamento IA, serão geradas taxas de recuperação de dados. Essas taxas são cobradas com base no volume de dados recuperados.

    Aceleração de transferência

    Se você ativar a aceleração de transferência e usar um endpoint de aceleração para acessar seu bucket, serão geradas taxas de aceleração de transferência. Essas taxas são cobradas com base no tamanho dos dados.

  • IMM: Para mais informações sobre preços, consulte IMM billable items.

    Importante

    A partir das 11h00 de 28 de julho de 2025 (UTC+8), o service de compressão de nuvem de pontos do IMM será atualizado de service gratuito para service pago. O item faturável específico é PointCloudCompress. Para mais informações, consulte Anúncio de ajuste de faturamento do IMM.

    API

    Item faturável

    Descrição

    CreateCompressPointCloudTask

    PointCloudCompress

    As taxas são calculadas com base no número de solicitações bem-sucedidas.