O que é compressão de nuvem de pontos - Object Storage Service: Central de Documentação do Alibaba Cloud

Casos de uso

Direção autônoma: Compacte dados de nuvem de pontos gerados por varreduras de radar.
Patrimônio cultural digital: Compacte dados de nuvem de pontos de relíquias culturais para preservação digital.
Cidade inteligente: Compacte dados de reconstrução 3D de cidades para garantir renderização e exibição fluidas.
Realidade mista: Compacte dados de nuvem de pontos com suporte a codificação e decodificação em tempo real.

Pré-requisitos

Antes de começar, verifique se você tem:

Um bucket do OSS com um projeto do IMM vinculado. Consulte Início rápido (console) ou AttachOSSBucket (API).
As permissões necessárias para usar a compressão de nuvem de pontos. Consulte Permissões.
Um arquivo PCD armazenado no bucket.

Nota

O acesso anônimo é negado. É necessário usar solicitações autenticadas.

Escolha um método de compressão

O OSS oferece dois métodos de compressão. Escolha com base nos requisitos de precisão e tamanho de arquivo:

	Octree	Árvore K-d
Biblioteca de compressão	PCL (Point Cloud Library)	Draco (biblioteca de código source do Google para compressão de dados 3D)
Parâmetros obrigatórios	Nenhum (todos são opcionais)	`cl`, `qb`
Principal compromisso	Equilíbrio entre velocidade de compressão e precisão espacial via configurações de voxel e resolução	Balanço entre taxa de compressão e detalhe dos pontos via nível de compressão e bits de quantização
Mais indicado para	Compressão espacial flexível com suporte a downsampling	Alta taxa de compressão com controle de qualidade refinado

Parâmetros

Ação: pointcloud/compress

Parâmetros comuns

Estes parâmetros aplicam-se a ambos os métodos de compressão.

Parâmetro	Tipo	Obrigatório	Descrição
`f`	string	Não	Formato do arquivo PCD. Apenas `pcd` é suportado.
`m`	string	Sim	Método de compressão. Valores válidos: `octree`, `kdtree`.
`fs`	string	Não	Campos de propriedade do PCD a compactar e sua ordem de compressão. Somente `xyz` é suportado. Deve ser codificado em Base64 seguro para URL. Por exemplo, codifique `xyz` como `eHl6`.

Parâmetros da Octree

Anexe estes parâmetros após /octree na solicitação.

Parâmetro	Tipo	Obrigatório	Descrição
`lib`	string	Não	Biblioteca de compressão. Apenas `pcl` é suportada.
`pr`	float	Não	Resolução da nuvem de pontos. Controla a precisão das coordenadas dos pontos durante a codificação. Padrão: `0.01`. Intervalo: `0`–`1`.
`or`	float	Não	Tamanho mínimo do bloco octree (comprimento da aresta do voxel). Padrão: `0.01`. Intervalo: `0`–`1`.
`d`	int	Não	Downsampling. Defina como `1` para ative o downsampling. O downsampling está ativado por padrão.

Parâmetros da árvore K-d

Adicione estes parâmetros após /kdtree na solicitação.

Parâmetro	Tipo	Obrigatório	Descrição
`lib`	string	Não	Biblioteca de compressão. Somente `draco` é suportada.
`cl`	int	Sim	Nível de compressão. Um valor maior retém mais detalhes dos pontos. Intervalo: `0`–`10`.
`qb`	int	Sim	Número de bits de quantização. Valores maiores preservam mais detalhes dos pontos. Intervalo: `1`–`31`.

Compacte um arquivo de nuvem de pontos

A compressão de nuvem de pontos suporta apenas processamento síncrono por meio do parâmetro de consulta x-oss-process.

Método Octree

Este exemplo compacta example.pcd usando o método Octree com PCL, resolução de nuvem de pontos de 0.001, tamanho de voxel de 0.001, downsampling ativado e campos xyz compactados.

String de parâmetros da solicitação:

x-oss-process=pointcloud/compress,m_octree,fs_eHl6/octree,or_0.001,pr_0.001,d_1,lib_pcl

Solicitação completa:

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

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}}

Método Árvore K-d

Este exemplo compacta example.pcd usando o método Árvore K-d com Draco, nível de compressão 0, 0 bits de quantização e campos xyz compactados.

String de parâmetros da solicitação:

x-oss-process=pointcloud/compress,m_kdtree,fs_eHl6/kdtree,cl_0,qb_0,lib_draco

Solicitação completa:

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

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}}

Use um SDK

A compressão de nuvem de pontos aceita somente processamento síncrono. Para uso com SDK, consulte Usar um SDK.

Faturamento

A compressão de nuvem de pontos gera itens faturáveis tanto para o OSS quanto para o IMM.

Itens faturáveis do OSS

Para preços do OSS, 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.
GetObject	Tráfego de saída pela internet	Aplica-se ao chamar 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`). A cobrança é baseada no tamanho dos dados.
GetObject	Recuperação de dados do armazenamento de Acesso Infrequente (IA)	Aplica-se quando os dados recuperados estão na classe de armazenamento IA. O custo depende do volume de dados recuperados.
GetObject	Aceleração de transferência	Aplica-se quando a aceleração de transferência está ativada e o acesso ao bucket ocorre via endpoint de aceleração. A tarifa varia conforme o tamanho dos dados.

Itens faturáveis do IMM

Para informações sobre preços do IMM, consulte Itens faturáveis do IMM.

Importante

A partir das 11:00 de 28 de julho de 2025 (UTC+8), a compressão de nuvem de pontos do IMM tornou-se um serviço pago. Para detalhes, 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.