İçeriğe geç
TREN
Atlıhan Harita

Yapılandırılmış Mekânsal Modelleme Kullanım Kılavuzu

Geçici Yükleme Kimlik Bilgileri

Bölüm 04 / 05Kılavuz sürümü v1.0.0.0Türkçe

Create Task and Get Upload Credentials veya Get Upload Credentials Again çağrısından sonra, modelleme girdi verilerini yüklemek için data.params içindeki geçici kimlik bilgilerini kullanın.

Genel kurallar

  • Tüm yüklemelerde çok parçalı (multipart) yükleme kullanın.
  • Geçici yükleme kimlik bilgilerinin nasıl kullanılacağı için ilgili bulut sağlayıcının resmi belgelerini izleyin.
  • Maksimum parça sayısı 10.000'dir. Büyük dosyalarda sınırı aşmamak için parça boyutunu toplam boyuta göre hesaplayın.
  • Nihai dosya Key değeri, savePath ile dosyanın göreli yolunun birleşiminden oluşur.
  • Geçici kimlik bilgileri varsayılan olarak 12 saat geçerlidir. Süreleri dolduktan sonra yenilemek için Yükleme Kimlik Bilgilerini Yeniden Alma çağrısını yapın.

Bulut Sağlayıcı Eşlemesi

Yanıttaki data.params.cloudService değeri, hangi SDK'nın kullanılacağını belirler. Her entegratör genellikle yalnızca tek bir sabit bulut sağlayıcıyla çalışır, bu nedenle hepsini desteklemeniz gerekmez.

cloudServiceBulut SağlayıcıBölüm
OSSAlibaba Cloud Nesne DepolamaAlibaba Cloud OSS
AWSAmazon S3AWS S3
KS3Kingsoft Cloud Nesne DepolamaKingsoft Cloud KS3

Alibaba Cloud OSS

ReferansBağlantı
STS Geçici Kimlik Bilgileriyle İstemci OluşturmaSTS tarafından sağlanan geçici erişim bilgileriyle OSS'ye erişim
Parçalı YüklemeParçalı yükleme (Java)
import com.aliyun.oss.*;
import com.aliyun.oss.common.auth.CredentialsProvider;
import com.aliyun.oss.common.auth.DefaultCredentialProvider;
import com.aliyun.oss.common.comm.SignVersion;
import com.aliyun.oss.model.PutObjectRequest;
import com.aliyun.oss.model.PutObjectResult;
import java.io.File;

public class Demo {
    public static void main(String[] args) throws Exception {
        // Fill in the temporary access key and SecurityToken returned by the API
        // Note: an AccessKeyId obtained from STS starts with "STS"
        String accessKeyId     = "yourSTSAccessKeyID";
        String accessKeySecret = "yourSTSAccessKeySecret";
        String stsToken        = "yourSecurityToken";
        String endpoint        = "endpoint";
        String region          = "region";
        String bucket          = "bucket";
        // key = savePath + relative file path
        String key = "prd/spatial-model/{accountId}/{taskCode}/input/render2/info/poses.json";

        CredentialsProvider credentialsProvider =
                new DefaultCredentialProvider(accessKeyId, accessKeySecret, stsToken);

        ClientBuilderConfiguration conf = new ClientBuilderConfiguration();
        conf.setSignatureVersion(SignVersion.V4);   // Explicitly use the V4 signature algorithm

        OSS ossClient = OSSClientBuilder.create()
                .endpoint(endpoint)
                .credentialsProvider(credentialsProvider)
                .clientConfiguration(conf)
                .region(region)
                .build();
        try {
            PutObjectRequest req =
                    new PutObjectRequest(bucket, key, new File("D:\\localpath\\poses.json"));
            PutObjectResult result = ossClient.putObject(req);
        } catch (OSSException oe) {
            System.out.println("Error Message:" + oe.getErrorMessage());
            System.out.println("Error Code:"    + oe.getErrorCode());
            System.out.println("Request ID:"    + oe.getRequestId());
        } catch (ClientException ce) {
            System.out.println("Error Message:" + ce.getMessage());
        } finally {
            if (ossClient != null) ossClient.shutdown();
        }
    }
}

AWS S3

ReferansBağlantı
STS Geçici Kimlik Bilgileriyle İstemci OluşturmaKimlik bilgilerini açıkça belirtme
Yükleme (Java)PutObject örneği
Yükleme (JS)@aws-sdk/lib-storage
public static void main(String[] args) throws Exception {
    String accessKeyId     = "yourSTSAccessKeyID";
    String accessKeySecret = "yourSTSAccessKeySecret";
    String securityToken   = "yourSecurityToken";
    String region = "region";
    String bucket = "bucket";
    String key    = "prd/spatial-model/{accountId}/{taskCode}/input/render2/info/poses.json";

    AwsSessionCredentials sessionCredentials = AwsSessionCredentials.create(
            accessKeyId, accessKeySecret, securityToken);
    // Initialize the S3 client with the temporary credentials
    S3Client s3Client = S3Client.builder()
            .region(Region.of(region))
            .credentialsProvider(StaticCredentialsProvider.create(sessionCredentials))
            .build();

    PutObjectRequest putObjectRequest = PutObjectRequest.builder()
            .bucket(bucket)
            .key(key)
            .build();

    s3Client.putObject(putObjectRequest, java.nio.file.Paths.get("D:\\resource\\poses.json"));
}

Kingsoft Cloud KS3

ReferansBağlantı
STS Geçici Kimlik Bilgileriyle İstemci OluşturmaKS3 geçici kimlik bilgileri
Parçalı YüklemeKS3 yükleme
public Ks3Client initKs3Client() {
    String accessKeyId     = "yourSTSAccessKeyID";
    String accessKeySecret = "yourSTSAccessKeySecret";
    String securityToken   = "yourSecurityToken";
    String endpoint        = "yourEndpoint";
    String region          = "region";

    Ks3ClientConfig config = new Ks3ClientConfig();
    config.setEndpoint(endpoint);
    config.setRegion(Region.valueOf(region));
    config.setProtocol(Ks3ClientConfig.PROTOCOL.http);
    config.setHttpClientConfig(new HttpClientConfig());

    return new Ks3Client(accessKeyId, accessKeySecret, securityToken, config);
}

Yüklemeden Sonra

status = 3 ile Yükleme Durumunu Güncelleme çağrısını yapın; aksi halde modelleme başlamaz.

Bu bölüm XGRIDS'in resmî kullanım kılavuzundan Türkçeye çevrildi; ekran görüntüleri ve arayüz adları özgün haliyle İngilizcedir. İngilizce aslı (yeni sekmede açılır) · Güncelleme:

XGRIDS Türkiye

Kurulumda ve Sahada Yanınızdayız

Atlıhan Harita; cihaz kurulumu, firmware güncellemesi, yazılım kullanımı ve saha uygulamalarında eğitim ve teknik destek verir. Sorunuzu iletin, uzmanımız size dönsün.

+90 216 546 0804