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:
|
|
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 |
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.
ImportanteA 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.