Cintoo Connect CLI(コマンドラインインターフェース)



この記事では、Cintoo Connect CLI(コマンドラインインターフェース)のリリースによって利用できるようになった新しい可能性について説明します。これはグラフィカルインターフェースを持たず、強力なカスタマイズ機能を備えたバージョンです。このツールは、Cintoo Connectの従来のインターフェースに不慣れなユーザーに代わって、特定のインポート/エクスポートタスクを自動化するために使用できます。

環境とパラメーターを設定すると、反復的なインポート/エクスポートタスクが簡単かつスムーズになります。さらに、社内固有の手順やデータ標準の実装も実現できます。


注:インストールフォルダー内に実行可能なCLIファイルを含めるには、Cintoo Connectのバージョンが2.13より新しい必要があります。最新バージョンのCintoo Connectをダウンロードするには、次のリンクを使用してください。


目次


権限

Cintoo Connect CLIを使用するには、ユーザーの役割に次のものが含まれている必要があります。

  • リアリティデータのアップロードまたは削除権限(スキャンのインポート用)
  • リアリティデータのエクスポートまたはダウンロード権限(スキャンのエクスポート用)

ヘルプ

コマンドラインでこれらのコマンドを使用してCintoo Connect CLIを使用するプロセスの詳細については、Help を使用してください。

./cintooconnect-cli.exe --help
./cintooconnect-cli.exe [IMPORT-TYPE] --help

ユースケース

  • Pythonスクリプトを作成してスキャンを一括インポートします。コメント付きのスクリプトの例。
  • Pythonスクリプトを作成してスキャンを一括エクスポートします
  • 組織固有のワークフローを作成します


次のことが可能です。

  • プロジェクト内でインポートパスをルーティングする
  • エクスポート用に特定のワークゾーンを指定する
  • イベント駆動型スクリプトを作成する(例:スキャンがフォルダーに配置されると、Cintooに自動的にインポートされる)

インポートコマンドの一覧

import-static --token=$token --tenant=$tenant --accountId=$accout_Id --projectId=$project_Id --workzoneId=$workzone_Id --file-ref=$file_ref
import-static --cintoo-uri=$job_uri --file-ref=$file_ref

地上型スキャンデータをインポートするコマンド。トークンとIDの取得手順は、

API呼び出しのガイダンス セクションに記載されています。


import-mobile --cintoo-uri=$job_uri --file-ref $local_file_path --device "$device_name" --position-sampling $position_sampling

スキャン経路なしでモバイルスキャンデータをインポートするコマンド。

$device_nameには、次の値を指定できます。

  • GeoSLAM Zeb Structured
  • Leica BLK2GO
  • NavVis Ivion


import-mobile --cintoo-uri=$job_uri --file-ref $local_file_path --device "$device_name" --scanning-path $scanning_path --position-sampling $position_sampling

スキャン経路ありでモバイルスキャンデータをインポートするコマンド。

$device_nameには、次の値を指定できます。

  • NavVis VLX and M6
  • GeoSLAM Zeb series
  • Viametris Backpack Mobile Scanner
  • Emesent Hovermap
  • Generic E57/LAS/LAZ


import-drone --cintoo-uri=$job_uri --file-ref $local_file_path --distance $distance_float

ドローンスキャンデータをインポートするコマンド。


import-360-images --cintoo-uri=$job_uri --tenant=$tenant --accountId=$accout_Id --projectId=$project_Id --workzoneId=$workzone_Id --file-ref=$file_ref

360画像データをインポートするコマンド。


注:補足のCSVは、画像と同じフォルダーに保存する必要があります。


エクスポートコマンドの一覧

export scans --cintoo-uri=$job_uri  --type structured  --format E57/RCP--destination-folder PATH  --destination-name TEXT

構造化スキャンデータをエクスポートするコマンド。
サポートされている形式:E57、RCP。


export scans --cintoo-uri=$job_uri  --type unified  --format E57/POD/RCS/RCP  --decimation-spacing FLOAT RANGE  --destination-folder PATH  --destination-name TEXT

統合スキャンデータをエクスポートするコマンド。

サポートされている形式:E57、POD、RCS、RCP。



API呼び出しのガイダンス

  • トークンの取得
トークンは、Cintooへの認証時に取得されます。
取得方法については、APIドキュメントをご覧ください。
こちらでベストプラクティスを、トークンの使用について確認できます。

  • アカウントIDの取得

すべてのアカウントを一覧表示するには、次のAPI呼び出しを使用し、その結果を解析してアカウントIDを取得します。


  • プロジェクトIDの取得

既存のプロジェクトがある場合は、すべてのプロジェクトを一覧表示するには、次のAPI呼び出しを使用し、その結果を、このAPI呼び出し で解析してプロジェクトIDを取得します。

プロジェクトを作成する場合は、新しいプロジェクトを作成するには、次のAPI呼び出しを使用し、その結果を解析してIDを取得します。


  • ワークゾーンIDの取得

既存のワークゾーンがある場合は、ワークゾーンの一覧を取得するには、次のAPI呼び出しを使用します。一覧から、必要なワークゾーンIDを取得します。

ワークゾーンを作成する場合は、新しいワークゾーンを作成してそのIDを取得するには、次のAPI呼び出しを使用します。


ヒントと制限事項

  • データは、ローカルストレージとクラウドのBLOBストレージの両方からインポートできるため、ローカルのファイルパスとクラウドのURLのどちらも使用できます。
    クラウドデータ(AWS、Azureなど)にアクセスするには、リンクに署名が含まれている必要があり、E57形式のファイルのみが受け入れられます。
    パスの例:
C:\data\Scans\Mobile\Scan
https://myaccount.blob.core.windows.net/mycontainer/myblob.txt?sv=2021-08-06&st=2024-02-28T10%3A00%3A00Z&se=2024-02-29T10%3A00%3A00Z&sr=b&sp=r&sig=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx%3D
  • サブスクリプションのスキャンと360画像の容量にご注意ください。Cintoo Connect CLIによるインポートにも、標準の手順と同じ制限が適用されます。
    スキャン/360画像の容量を超えることはできません。
  • インポート/エクスポートをより速く実行するためにコア数を増やすには(PCの性能が許す場合)、次のパラメーターを、2(デフォルト)より大きい任意の整数で追加します。
    --nb-threads INTEGER RANGE

  • ジョブのログを保存する場所を指定するには、次のコマンドを追加します。
    --log-path FILE



この記事は役に立ちましたか?

それは素晴らしい!

フィードバックありがとうございます

お役に立てず申し訳ございません!

フィードバックありがとうございます

この記事に改善できることがあれば教えてください。

少なくとも一つの理由を選択してください
CAPTCHA認証が必要です。

フィードバックを送信しました

記事の改善におけるご協力ありがとうございます。