Skip to main content

出力イメージ サービスの使用

ラスター出力のある Web ツールまたはジオプロセシング サービスを使用する場合、出力はサーバーで生成され、URL を含む .tif ファイルとしてクライアントに返されます。 この .tif ファイルの使用は制限されており、特に大規模なラスターでは、パフォーマンスの問題が発生します。 さらに、多次元ラスター データなどの結果ラスターを .tif ファイルに変換するときに、重大な情報が失われる可能性があります。

出力イメージ サービスを使用すると、ラスター出力がイメージ サービスになり、これには、大規模なラスターでもクライアントが迅速にアクセスできる、その場で画像を迅速に処理できる、追加の分析を実行できるなど、イメージ サービスを使用するメリットが得られます。

公開

Web ツールまたはジオプロセシング サービスを出力イメージ サービスと共有するには、ArcGIS Pro 3.4 以降を使用し、ArcGIS Enterprise 11.4 以降に公開します。 スタンドアロン ArcGIS Server もサポートされています。 ArcGIS Enterprise on Kubernetes は、出力イメージ サービスをサポートしていません。

Web ツールまたはジオプロセシング サービスは非同期である必要があり、マップ イメージ レイヤーの出力を表示 オプションをオフにする必要があります。

ラスター データ タイプと、複合で許可されるタイプの 1 つとしてラスター データ タイプを含む複合データ タイプもサポートされますが、複数値ラスター出力やラスター列を含む出力値テーブルはサポートされません。

出力イメージ サービスを使用した ArcGIS Pro で Web ツールまたはジオプロセシング サービスを公開するには、以下の手順を実行します:

  1. ローカルでジオプロセシング ツールをエラーなしで正常に実行します。

  2. Web ツールとして共有 または ジオプロセシング サービスの公開 ウィンドウを開きます。

    Web ツールまたはジオプロセシング サービスの公開または上書きの詳細

  3. コンテンツ タブをクリックします。

  4. ツールのプロパティの構成 ボタン をクリックし、出力イメージ サービスで使用するタスクを編集します。

  5. パラメーターの構成 セクションで、出力イメージ サービスの追加 (オプション) チェックボックスをオンにします。

    入力文字列パラメーター (オプション) は、公開プロセス中にツールに追加されます。

    パラメーターの表示名は 出力イメージ サービス、パラメーター名は esri_out_image_service です。 デフォルト値はありません。

Python を使用して Web ツールやジオプロセシング サービスを公開するには、GeoprocessingSharingDraft クラスを使用し、enableOutputImageService プロパティを True に設定します。

出力イメージ サービスの使用要件

出力イメージ サービスの使用には次の要件があります。

  • イメージ サーバーのライセンスや構成に関係なく、Web ツールやジオプロセシング サービスを実行するサーバーでは、ラスター レンダリング システムのイメージ サービスが実行されている必要があります。 そうでない場合、イメージ サービスは作成されず、ツールの使用時にエラーが発生します。

  • Web ツールまたはジオプロセシング サービスのコンピューターの入力サーバー ディレクトリーに十分なディスク スペースがあることを確認してください。 これは、大規模なラスター結果を頻繁に生成する場合に特に重要です。 ラスター ストアを登録していても、ラスター ストアは出力イメージ サービスのストレージ オプションとしてはサポートされていません。

  • イメージ サービスの公開に必要な権限またはロールを持っていなければなりません。 詳細については、「イメージ サービスの公開」をご参照ください。

  • ラスター結果がモザイク データセットの場合、ArcGIS Server にイメージ サーバー ロールのライセンスがあることを確認します。 システム管理者に連絡するか、ArcGIS Server を認証してください。

出力イメージ サービス パラメーターに値を指定する場合は、特殊文字が存在しないことを確認します。 サポートされているのは、英数字、スペース、アンダースコアのみです。 イメージ サービスでは、スペースはアンダースコアに変換されます。 指定した名前は接頭辞になります。 完全なイメージ サービス名は、prefix_<output raster parameter name> 形式になります。 複数の出力ラスター パラメーターがある場合は、複数のイメージ サービスが生成されます。 出力ラスター パラメーター (オプション) に結果が含まれていない場合、イメージ サービスは生成されません。 可能な場合、短い接頭辞を使用してください。完全なイメージ サービス名の最大文字数は 120 文字です。

出力イメージ サービスの作成

ArcGIS Enterprise で Web ツールの出力イメージ サービスを使用するには、出力イメージ サービス 名の接頭辞を入力します。 ツールが正常に実行されると、Web イメージ レイヤーのポータル アイテムがポータル フォルダーに配置されます。 対応するイメージ サービスは、ArcGIS Server のルート ディレクトリーにあります。

スタンドアロン ArcGIS Server でジオプロセシング サービスの出力イメージ サービスを使用するには、接頭辞を入力します。 結果イメージ サービスは、ArcGIS Server のルート ディレクトリーにもあります。

可能な場合、ラスター結果の元の形式は、モザイク データセットなどのジオデータベース内であっても、TIFF や CRF などのファイル形式であっても維持されます。 ラスター結果は、イメージ サービスの作成に使用されます。 結果ラスターがメモリー内にある場合は、メモリ内の結果ラスターから変換された CRF 形式に基づくイメージ サービスが作成されます。 結果のラスター サイズが大きくなる場合は、ラスター結果にメモリーを使用しないようにします。 メモリー内で使用する場合にヒープ サイズを増やす方法については、「Web ツールの使用に関する一般的な注意事項」をご参照ください。

ジオプロセシング ジョブを送信する際に ArcGIS REST API を使用するには、JSON スキーマに基づく文字列または JSON を指定します。 フォルダーやメタデータを指定するには、ArcGIS REST API を使用し、各出力イメージ サービスに明示的な名前を指定して、prefix_<output raster parameter name> 形式を使用しないようにします。

出力イメージ サービスの上書き

Web ツールまたはジオプロセシング サービスが ArcGIS Enterprise またはスタンドアロン ArcGIS Server 11.5 以降で実行されている場合、既存のイメージ サービスを上書き チェックボックスをオンにすると、接頭辞が ArcGIS Pro 3.5 で始まる既存のイメージ サービスを上書きすることができます。

サービスを上書きするには、既存のイメージ サービスの所有者か、ArcGIS Enterprise またはスタンドアロン ArcGIS Server の管理者である必要があります。 出力イメージ サービスの作成に関するその他のすべての要件が適用されます。 prefix_<output raster parameter name> 形式に従っていない名前のイメージ サービスを上書きするか、既存のメタデータを上書きするには、ジオプロセシング ジョブを送信する際に ArcGIS REST API を使用します。