ラベル | 説明 | データ タイプ |
入力パッケージ | 抽出される入力パッケージ。 | File |
出力フォルダー (オプション) | パッケージのコンテンツが含まれる出力フォルダー。 指定されたフォルダーが存在しない場合、フォルダーが作成されます。 | Folder |
パッケージのキャッシュ (オプション) | パッケージのコピーをプロファイルにキャッシュするかどうかを指定します。 パッケージを抽出すると、まず出力がユーザー プロファイルに抽出され、一意の ID が付加されてから、[出力フォルダー] パラメーターで指定したディレクトリにコピーが作成されます。 同じパッケージの後続バージョンをダウンロードして抽出すると、この場所のみが更新されます。 このパラメーターを使用する場合、ユーザー プロファイルにパッケージのキャッシュ バージョンを手動で作成する必要はありません。 入力パッケージがベクター タイル パッケージ (.vtpk) またはタイル パッケージ (.tpk および .tpkx) の場合、このパラメーターは無効になります。
| Boolean |
ストレージ フォーマット タイプ (オプション) | 抽出したキャッシュに使用される格納形式を指定します。 このパラメーターは、入力パッケージがベクター タイル パッケージ (.vtpk) の場合にのみ適用されます。
| String |
すぐに使えるキャッシュ データセットの作成 (オプション) | ArcGIS Enterprise のすぐに使える形式を作成するかどうかを指定します。 入力パッケージがベクター タイル パッケージ (.vtpk) またはタイル パッケージ (.tpkx) の場合にのみ、このパラメーターは有効になります。
| Boolean |
ターゲット クラウド コネクション (オプション) | パッケージのコンテンツの抽出先となるターゲット .acs ファイル。 入力パッケージがシーン レイヤー パッケージ (.slpk)、ベクター タイル パッケージ (.vtpk)、またはタイル パッケージ (.tpkx) の場合にのみ、このパラメーターは有効になります。 | Folder |
サマリー
パッケージのコンテンツを指定のフォルダーに抽出します。 出力フォルダーは、入力パッケージから抽出されたコンテンツで更新されます。
使用法
サポートされるパッケージ タイプは以下のとおりです。
- ジオプロセシング パッケージ (.gpk および .gpkx)
- レイヤー パッケージ (.lpk および .lpkx)
- ロケーター パッケージ (.gcpk)
- マップ パッケージ (.mpk および .mpkx)
- モバイル マップ パッケージ (.mmpk)
- プロジェクト パッケージとプロジェクト テンプレート (.ppkx および .aptx)
- シーン レイヤー パッケージ (.slpk)
- タイル パッケージ (.tpk および .tpkx)
- ベクター タイル パッケージ (.vtpk)
出力フォルダーは、新しいフォルダーでも既存のフォルダーでもかまいません。 既存のフォルダーに抽出する場合は、既存のファイルおよびフォルダーにパッケージのコンテンツが追加されます。 出力フォルダーにパッケージから抽出されたコンテンツが含まれている場合は、既存のコンテンツが上書きされます。
アタッチメント ファイルを含むパッケージでは、添付されたファイルが出力フォルダーの commondata\userdata\ サブフォルダーに解凍されます。 通常、パッケージ内のファイルは、.pdf、.docx、または画像などのファイルをサポートしています。 これらのファイルを開くには、Microsoft File Explorer で抽出されたディレクトリを参照します。
ベクター タイル パッケージ (.vtpk) を抽出すると、パッケージのコンテンツが出力フォルダーに抽出されます。 [ストレージ フォーマット タイプ] パラメーターを使用して、キャッシュ格納形式をコンパクト (.bundle ファイル) からエクスプロード (.pbf ファイル) に切り替えることができます。 抽出された .pbf ファイルは、Mapbox などの他のクライアント アプリケーションで使用できます。
注意:
フラット キャッシュの抽出には時間がかかることがあり、パッケージのデータの範囲、詳細レベル、ハードウェアの構成によっては、数十億個のタイルが抽出されることがあります。
ベクター、タイル、またはシーン レイヤー パッケージ (.vtpk、.tpk、.tpkx、または .slpk) を抽出する場合は、[パッケージのキャッシュ] パラメーターが非アクティブになります。
ベクター、タイル、またはシーン (バージョン 1.7 以降) レイヤー パッケージを抽出する場合は、パッケージのコンテンツをファイル システムのフォルダーか、クラウド上 (Amazon S3、Azure Blob ストレージ、Alibaba OSS など) にあるオブジェクト ストアに抽出できます。 このコンテンツはタイルまたはシーン レイヤーとしてすぐに提供できる状態にあり、選択した場所は、ArcGIS Enterprise にユーザー管理データ ストアとして登録されている必要があります。
[クラウド ストレージ コネクション ファイルの作成 (Create Cloud Storage Connection File)] ツールを使用してコネクション ファイル (.acs) を作成できます。
以前のバージョンのシーン レイヤー パッケージは、[シーン レイヤーのアップグレード (Upgrade Scene Layer)] ツールを使用して最新バージョンにアップグレードできます。
注意:
クラウドのオブジェクト ストアにシーン レイヤー パッケージを抽出する場合 (.i3sREST)、シーン キャッシュ ストレージ形式はファイル システムのフォルダーに抽出するとき (.eslpk) と同じではありません。これら 2 つの形式には互換性はありません。
パラメーター
arcpy.management.ExtractPackage(in_package, {output_folder}, {cache_package}, {storage_format_type}, {create_ready_to_serve_format}, {target_cloud_connection})
名前 | 説明 | データ タイプ |
in_package | 抽出される入力パッケージ。 | File |
output_folder (オプション) | パッケージのコンテンツが含まれる出力フォルダー。 指定されたフォルダーが存在しない場合、フォルダーが作成されます。 | Folder |
cache_package (オプション) | パッケージのコピーをプロファイルにキャッシュするかどうかを指定します。 パッケージを抽出すると、まず出力がユーザー プロファイルに抽出され、一意の ID が付加されてから、output_folder パラメーターで指定したディレクトリにコピーが作成されます。 同じパッケージの後続バージョンをダウンロードして抽出すると、この場所のみが更新されます。 このパラメーターを使用する場合、ユーザー プロファイルにパッケージのキャッシュ バージョンを手動で作成する必要はありません。 入力パッケージがベクター タイル パッケージ (.vtpk) またはタイル パッケージ (.tpk および .tpkx) の場合、このパラメーターは無効になります。
| Boolean |
storage_format_type (オプション) | 抽出したキャッシュに使用される格納形式を指定します。 このパラメーターは、入力パッケージがベクター タイル パッケージ (.vtpk) の場合にのみ適用されます。
| String |
create_ready_to_serve_format (オプション) | ArcGIS Enterprise のすぐに使える形式を作成するかどうかを指定します。 入力パッケージがベクター タイル パッケージ (.vtpk) またはタイル パッケージ (.tpkx) の場合にのみ、このパラメーターは有効になります。
| Boolean |
target_cloud_connection (オプション) | パッケージのコンテンツの抽出先となるターゲット .acs ファイル。 入力パッケージがシーン レイヤー パッケージ (.slpk)、ベクター タイル パッケージ (.vtpk)、またはタイル パッケージ (.tpkx) の場合にのみ、このパラメーターは有効になります。 | Folder |
コードのサンプル
以下の Python ウィンドウ スクリプトは、ArcGIS Enterprise の公開ワークフローですぐに使用できるキャッシュ データセットを生成する際の ExtractPackage 関数の使用方法を示しています。
import arcpy
arcpy.management.ExtractPackage(r"C:\Data\packages\MyVectorPackage.vtpk",
r"C:\Data\packages\Extracted", "CACHE",
"COMPACT", "READY_TO_SERVE_CACHE_DATASET")
次の Python ウィンドウ スクリプトは、ArcGIS Enterprise 公開ワークフローで使用可能なシーン レイヤー パッケージをオブジェクト ストアに抽出する際の ExtractPackage 関数の使用方法を示しています。
import arcpy
arcpy.management.ExtractPackage(r"C:\Data\packages\ChicagoBuildings.slpk",
None, "CACHE",
"COMPACT", "EXTRACTED_PACKAGE",
r"C:\CloudConnections\AWS.acs")
次の Python ウィンドウ スクリプトは、ArcGIS Enterprise 公開ワークフローで使用可能なベクター タイル レイヤー パッケージをオブジェクト ストアに抽出する際の ExtractPackage 関数の使用方法を示しています。
import arcpy
arcpy.management.ExtractPackage(r"C:\Data\packages\London.vtpk",
None, "CACHE",
"COMPACT", "EXTRACTED_PACKAGE",
r"C:\CloudConnections\AWS.acs")
指定のフォルダー内のすべてのジオプロセシング パッケージを検索し、ExtractPackage 関数でコンテンツを指定のフォルダーに抽出します。
# Name: ExtractPackage.py
# Description: Find geoprocessing packages in a specified folder and extract
# contents.
import arcpy
import os
arcpy.env.overwriteOutput = True
# set folder that contains packages to extract
arcpy.env.workspace = "C:/geoprocessing/gpks"
wrksp = arcpy.env.workspace
for gpk in arcpy.ListFiles("*.gpk"):
print("Extracting... " + gpk)
arcpy.management.ExtractPackage(gpk, os.path.splitext(gpk)[0])
print("done")
ライセンス情報
- Basic: Yes
- Standard: Yes
- Advanced: Yes