イメージ サービスのパラメータ
イメージ サービスには多数の標準パラメータがあり、これらのデフォルトの値は ArcGIS Server サービスのほとんどで適切に機能します。これらには、プール オプションやその他のオプションが含まれます。さらに、ラスタおよび画像データの特性により、イメージ サービスの処理速度、ダウンロード可能なデータ、検索など、さまざまなオプションに影響を与えるパラメータもあります。
パラメータのいくつかは、特定の機能を有効化しているときに必須です。たとえば、ダウンロード機能が有効な場合は、ダウンロード関連のパラメータを変更する必要があります。カタログ、編集、および計測機能でも同様です。
画像データを制御するデフォルト パラメータ
イメージ サービスのパラメータはいくつかのセクションに分かれており、各セクションはイメージ サービスの入力によって決まります。これらのパラメータのほとんどは、モザイク データセットを公開するイメージ サービスを対象としており、ラスタ データセットまたはレイヤから作成されたイメージ サービスにはあまり影響を与えません。モザイク データセットに関するパラメータの多くは、モザイク データセットの作成時に設定されます。サーバ管理者は一部のパラメータを変更できますが、モザイク データセットのプロパティで設定した最大値より大きくすることはできません。たとえば、許可されるモザイク手法を 3 つだけに制限すると、管理者は 4 つ目の手法を追加できなくなります。または、ダウンロード可能なアイテムの最大数を設定した場合、サーバ管理者はこの数を減らすことはできても、増やすことはできません。
モザイク データセットのパラメータの制限値（リクエストの最大サイズなど）を変更した場合は、そのモザイク データセットをもう一度公開し、サーバのイメージ サービスが変更後の値を読み込めるようにする必要があります。イメージ サービスを停止して開始するだけでは、モザイク データセットの変更したプロパティは有効になりません。一方、イメージ サービス自体のプロパティを変更した場合は、イメージ サービスを停止して開始するだけで変更内容が有効になります。
イメージ関連のパラメータ
イメージ関連のパラメータは、イメージ サービスへ接続したときに表示される画像に影響を与えます。
パラメータ | 説明 |
|---|---|
データ ソース | イメージ サービスのソース データセットの場所と名前。 すべての入力に適用されます。 |
リクエストあたりの最大イメージ サイズ | クライアント リクエストでサーバが許可するピクセルの行と列の最大数。 クライアントのリクエストがこの値を上回る場合は、ピクセルが何も返されません。 すべての入力に適用されます。 |
デフォルトのリサンプリング方法 | リクエストで使用されるリサンプリング方法。次の方法があります。
すべての入力に適用されます。 |
許可される圧縮方法 | イメージ サービスで使用できる圧縮方法。次の 3 種類の圧縮方法があります。
[JPEG 品質] および [LERC 許容値] のデフォルト値は、[許可リストの構成] ダイアログ ボックスで設定できます。 クライアントは、転送時に使用する圧縮方法を選択できます。これは、[レイヤ プロパティ] ダイアログ ボックスの [表示] タブで設定できます。 このパラメータは、SOAP GetImage 方式を使用してイメージ サービスにアクセスするクライアント（ArcGIS for Desktop、ArcObjects が組み込まれたアプリケーションなど）にのみ適用されます。 REST を使用してサービスにアクセスするクライアントの場合は、どの圧縮方法が定義されているかに関係なく、要求された形式に基づいて自動的に圧縮が適用されます。 |
JPGPNG を JPG として返す | ユーザが JPGPNG 形式を使用して画像を要求したときに、透過表示が使用されている場合は PNG が返され、それ以外の場合は JPG が返されます。PNG は通常 JPG よりもはるかに大きいため、転送に時間がかかります。透過表示が不要で、イメージ サービスが常に小さい画像サイズを使用して転送されるようにしたい場合は、このチェックボックスをオンにします。 すべての入力に適用されます。 |
クラスタ パラメータ
デフォルトでは、すべての ArcGIS Server サイトが 1 つのクラスタを持ちます。複数のサーバ コンピュータがある場合は、それらが 1 つのクラスタで動作するように構成できます。各クラスタが専用のサービス セットを実行するように構成できます。[サービスをホストするクラスタの選択] パラメータを使用すると、イメージ サービスが動作するクラスタを選択できます。
出力ディレクトリ パラメータ
|
パラメータ |
説明 |
|---|---|
|
ディレクトリ |
一時ファイルを作成する出力ディレクトリを選択します。出力ディレクトリを指定しない場合は、画像が MIME データとしてのみ返されます。出力ディレクトリを指定すると、返される画像に URL アドレスを使用してアクセスすることもできます。 すべての入力に適用されます。 |
|
サポートされるイメージのリターン タイプ |
ArcGIS Server によって生成された画像が MIME データとしてのみ返されるか、MIME と URL の両方で返されるかを表示します。ArcGIS Server が生成した画像にインターネット経由でアクセスするには、出力画像の出力ディレクトリを指定する必要があります。 すべての入力に適用されます。 |
イメージ サービスのカタログを制御するパラメータ
カタログ関連のパラメータは、モザイク データセットをイメージ サービスとして公開するときにのみ適用されます。カタログ関連のパラメータは、メタデータやカタログ フィールドに対するユーザ アクセスを制御または制限します。さらに、モザイク データセット テーブルのレコードに対するリクエストも制限します。これらのパラメータは、サーバ側の負荷に影響を与えます。ユーザが表示またはクエリ可能なデータを増やすほど、サーバ側の描画負荷が大きくなります。
モザイク パラメータ
|
パラメータ |
説明 |
|---|---|
|
モザイクごとの最大ラスタ数 |
リクエストごとにモザイク処理できる最大ラスタ数。これによってサーバは、1 つのリクエストで大量のラスタを開いて処理する必要がなくなります。 クライアントのリクエストが、この数よりも多いラスタへのアクセスを要求した場合、アクセスされるラスタは、この数に制限されます。その他のラスタのピクセルが返されないため、描画される画像に空白が生じる可能性があります。クライアントに空白が表示されないように、概観図を作成することをお勧めします。 モザイク データセットにのみ適用されます。 |
|
許可するモザイク手法 |
イメージ サービスで使用できるモザイク手法。次のモザイク手法があります。
モザイク データセットにのみ適用されます。 |
カタログ関連のパラメータ
これらのパラメータは、カタログ機能をオンにしているときに適用されます。
|
パラメータ |
説明 |
|---|---|
|
リクエストごとに返される最大レコード数 |
トランザクションごとの転送レコード数の上限。ユーザのリクエストがこの値を超えた場合、返される画像では、許可されている最大ラスタが使用されます。 モザイク データセットにのみ適用されます。 |
|
ラスタ メタデータ レベル |
クライアントに転送するメタデータ
モザイク データセットにのみ適用されます。 |
|
許可されたフィールド |
クライアントに転送される属性テーブルのフィールドの一覧です。クライアントが表示したり、クエリで使用したりできないようにしたい場合は、このフィールドをオフにします。 モザイク データセットにのみ適用されます。 |
ダウンロード関連のパラメータ
イメージ サービスでダウンロードを許可している場合は、[イメージング] プロパティ ページで [ダウンロード] 機能をオンにします。また、以下のプロパティに加えて、[パラメータ] プロパティ ページで出力ディレクトリを構成します。
これらのパラメータは、サーバ側の負荷、およびソース画像へのユーザ アクセスに影響を与えます。
パラメータ | 説明 |
|---|---|
リクエストごとにダウンロード可能な最大アイテム数 | ユーザが一度にダウンロードできるラスタの最大数。 モザイク データセットにのみ適用されます。 |
ダウンロードされたディレクトリを管理する | 画像が置かれている物理ディレクトリを、画像の URL がマッピングされる仮想ディレクトリにマッピングすることができます。 ダウンロードを可能にする場合、そのモザイク データセットのソース ラスタを示すディレクトリをサービスで使用する必要があります。これによって、モザイク データセットのソース ディレクトリからサーバ出力ディレクトリへファイルをコピーする際にパフォーマンスが大幅に低下するのを防ぎます。 仮想ディレクトリは、URL アドレスに基づいて、ArcGIS Server によって作成されたファイルへ Web アプリケーションからアクセスできるようにする仕組みです。仮想ディレクトリは、出力ディレクトリと同じディスク上の位置を指している必要があります。Web サーバに仮想ディレクトリを作成し、ディスク上の物理ディレクトリにリンクする必要があります。仮想ディレクトリの作成方法については、Web サーバのドキュメントをご参照ください。 モザイク データセットにのみ適用されます。 |
リクエストごとの最大ダウンロード サイズ | 一度にダウンロードできる合計サイズ（MB）。 モザイク データセットにのみ適用されます。 |
イメージ サービス コンテンツを制御するパラメータ
編集関連のパラメータ
イメージ サービスがモザイク データセットから作成される場合は、クライアントがラスタ データをモザイク データセットに追加できるようにすることにより、イメージ サービスがクライアントのリポジトリとして機能するように構成できます。ラスタ データを追加した後、同じクライアントで追加したデータのプロパティを編集したり、そのデータを削除したりすることができます。
これらのパラメータは、編集機能をオンにしているときに適用されます。
参照モザイク データセットを提供している場合は、編集を使用できません。
|
パラメータ |
説明 |
|---|---|
|
ダイナミック イメージ ワークスペースを管理する |
ラスタ データがアップロードされ保存される、サーバおよびモザイク データセットからアクセス可能なディレクトリ ロケーション。このパラメータは設定が必要です。設定しない場合は、サービスで編集操作を使用できません。 モザイク データセットにのみ適用されます。 |
|
エディタ情報 |
編集を適用するときにユーザ名にレルムを追加して、編集を追跡できるようにします。セキュリティで保護されたイメージ サービスにアクセスすると、ArcGIS for Server にユーザの名前と編集内容が記録されます。ArcGIS for Server により、イメージ サービス上で設定されたレルムもすべて追加されます。 モザイク データセットにのみ適用できます（モザイク データセットでの編集情報の記録が有効）。 |
|
他のユーザによって追加されるアイテムで許される操作 |
モザイク データセットにのみ適用できます（モザイク データセットでの編集情報の記録が有効）。 |
|
許可される追加のタイプ |
ラスタ データをイメージ サービスに追加するときにクライアントが指定できるラスタ タイプを 1 つ以上選択します。 モザイク データセットにのみ適用されます。 |
|
カスタム タイプを管理する |
基本ラスタ タイプで定義されないデータをクライアントが追加する必要がある場合は、1 つ以上のラスタタイプ ファイル（*.art）を選択できます。 ラスタタイプ ファイルは、ラスタ タイプのプロパティを開き、ファイルを保存することによって、[モザイク データセットにラスタを追加（Add Rasters To Mosaic Dataset）] ツールで作成し、編集することができます。 モザイク データセットにのみ適用されます。 |
リアルタイム処理を制御するパラメータ
関数のパラメータ
関数を使用すると、イメージ サービスのデータをサーバで処理して、特定のプロダクトをクライアントに提供できます。Hillshade や Slope などの一部の関数は直接公開されていますが、ArcGIS for Desktop でラスタ データに適用可能なすべての関数は、ラスタ関数テンプレートを使用してクライアントに公開できます。以下のパラメータは、クライアントに公開される関数を使用してサーバ側の処理をリアルタイムで制御します。
|
パラメータ |
説明 |
|---|---|
|
クライアントで指定されたレンダリング ルールを許可する |
オンの場合、クライアントはサーバ側のレンダリングおよび処理にアクセスして制御できます。オフの場合、クライアントはサーバ側のレンダリングにアクセスしてリクエストすることはできません。 すべての入力に適用されます。 |
|
カラーマップを RGB に変換 |
ラスタ データセットにカラーマップがある場合は、それを RGB 画像として公開し、カラーマップを画像に適用することができます。これにより、ピクセル値は単一の値と関連するカラーマップから 3 バンドのピクセル値に変わります。カラーマップを保持し、ユーザがカラーマップに基づいてピクセルを検索できるようにするには、このオプションを選択しないでください。 これはカラーマップを持つラスタ データセットに適用されます。また、カラーマップ関数を使用するラスタ データセット レイヤまたはモザイク データセットを使用するときにも適用されます。 すべての入力に適用されます。 |
|
ラスタ関数テンプレートの管理 |
1 つ以上の関数チェーンを使用し、イメージ サービスのデータを処理することができます。これを適用すると、それらの関数はサーバに適用され、結果がユーザまたはアプリケーションに転送されます。 これらの関数チェーンはラスタ関数テンプレート エディタで作成され、*.rft.xml ファイルとして保存されます。*.rft.xml ファイルは ArcMap で作成し、イメージ サービスに適用することができます。 関数チェーンを使用することにより、Web アプリケーションは、イメージ サービスのデータに対するさまざまなリアルタイム処理を実行できます。 イメージ サービスを使用するときに常に適用される、デフォルトの関数チェーンを選択できます。これは、ストレッチを適用したときに表示が向上するデータを使用しているイメージ サービスで特に有効です。ArcMap はストレッチを適用しますが、通常、Web アプリケーションはストレッチを適用できません。したがって、関数チェーンを使用してストレッチを定義すると、常に期待どおりの表示が得られます。 すべての入力に適用されます。 |
画像測定を計測するパラメータ
計測のパラメータ
ArcGIS には、画像からポイント、距離、面積、高さを計測するツールなど、画像計測のためのツール群があります。イメージ サービスによる ArcGIS 画像計測の利用の有無を選択できます。
すべての入力に適用されます。
|
パラメータ |
説明 |
|---|---|
|
許可される計測方法 |
これらの許可される方法はソースの計測機能から取得され、データセットのプロパティの一部としてリストされます。これにより、イメージ サービスで使用できる計測ツールが決まります。
すべての入力に適用されます。 |
|
標高ソース |
計測時に優先的に使用すべき利用可能な標高ソースがあるときは、ここで指定できます。これにより、ユーザは 3D での計測が可能になります。 有効な標高ソースには、ラスタ データセット、イメージ サービスの SOAP URL、およびイメージ サービス レイヤがあります。標高イメージ サービスで認証が必要な場合は、イメージ サービス レイヤを使用してください。 すべての入力に適用されます。 |
ComputeTiePoints REST 操作
10.2 以降のバージョンで、イメージ サービスは新しい ComputeTiePoints REST 操作をサポートするようになりました。この操作は、モザイク データセットのラスタと事前構成された参照画像の間にタイ ポイントを生成します。モザイク データセットから公開されたイメージ サービス上でタイ ポイントの計算を有効にするには、次の手順に従います。
- ArcGIS Server Administrator Directory にログインします。URL の形式は通常、http://gisserver.domain.com:6080/arcgis/admin です。
- サービスを検索して、[Edit] をクリックします。
- 「maxImageHeight」の文字列を検索します。
- 参照画像を挿入してタイ ポイントを算出します。参照画像として次のいずれかを指定できます。
- イメージ サービスの SOAP URL
- タイル マップ サービス
- ローカル ラスタまたはモザイク データセット
- イメージ サービスをポイントするレイヤ ファイル
- [Save Edits] をクリックします。
10.2 以降のバージョンで、イメージ サービスは新しい GetSamples REST 操作をサポートするようになりました。この操作は、指定したジオメトリに対して、ソース データのサンプル ポイント位置、ピクセル値、および対応する空間解像度を生成します。サンプル位置の最大数はデフォルトで約 1,000 に設定されていますが、サービスの作成者は構成プロパティを「"maxSampleCount":1000,」のように指定して、この値をカスタマイズできます。
cacheControlMaxAge プロパティを使用してイメージ サービスの表示パフォーマンスを改善する
クライアントが ArcGIS Server にリクエストを送信してイメージ サービスを表示するときに、通常はサーバからの応答がブラウザによって一定期間キャッシュされ、再利用されます。この動作によって、ArcGIS Server はイメージ サービスを最高品質で表示することができます。ただし、アプリケーションでのイメージ サービスとその関連データの使用方法に応じて、ブラウザがキャッシュ内の応答を使用する期間を調整することを検討してください。これを行うには、cacheControlMaxAge というプロパティをサービスの JSON（JavaScript Object Notation）に追加します。
cacheControlMaxAge プロパティの使用方法
ArcGIS Server イメージ サービスの応答には、エンティティ タグ（ETag）ヘッダーとキャッシュ コントロール ヘッダーが含まれています。ETag ヘッダーの値は、応答の一意の識別子です。キャッシュ コントロール ヘッダーには、キャッシュから応答を再利用できる最大期間に関する情報をブラウザに提供する max-age 値が含まれています。この値は、cacheControlMaxAge プロパティによって制御されます。
リクエストが繰り返された場合、キャッシュの最大期間の期限が切れていなければ、ブラウザは、サーバにリクエストを送信しないで、キャッシュされている応答を使用します。キャッシュの最大期間の期限が切れている場合、ブラウザは、リクエストをサーバに送信し、キャッシュ内の応答に対応する ETag 値を使用して IF-NONE-MATCH ヘッダーを設定する必要があります。ArcGIS Server は、リクエストを評価し、ETag 値を使用して、応答が変更されているかどうかを判定します。サーバからの応答がブラウザ上のコピーと異なる場合、サーバはまったく新しい応答をブラウザに送信します。応答がブラウザ上のコピーと同一である場合、サーバは、キャッシュ内の応答を引き続き使用するようにブラウザに警告します。
cacheControlMaxAge プロパティの値の定義
ArcGIS Server 管理者は、cacheControlMaxAge プロパティを定義して、ブラウザがキャッシュされた応答を使用できる期間を指定できます。ArcGIS Server が完全な応答を送信する必要性を軽減することによって、ブラウザのキャッシュを効率化し、アプリケーションを最適化し、ネットワーク帯域幅を節約することができます。
イメージ サービスの場合、デフォルト値は 12 時間（43200 秒）です。これは、リクエストが 12 時間以内に繰り返された場合、ブラウザがキャッシュ内の応答を使用するということを意味します。このデフォルト値は、ほとんどのアプリケーションで有効に機能します。
データセットやシンボルが頻繁に変更されるイメージ サービスの場合、5 分（300 秒）などの値を指定することをお勧めします。アニメーションなどの時間に対応するデータを使用するアプリケーションでは、アニメーションをより滑らかに表示するために、この値を増やすことを検討してください。
cacheControlMaxAge プロパティをサービスに追加してデフォルト値を指定するには、以下の手順を実行します。
- Web ブラウザで ArcGIS Server Administrator Directory を開き、管理者権限を持つユーザでログインします。URL の形式は、http://gisserver.domain.com:6080/arcgis/admin です。
- [services] をクリックして、変更するイメージ サービスを [Services] リストから選択します。サービスがリストに表示されない場合は、[Root folder]の下のディレクトリに配置されている可能性があります。
- [Service - <サービス名> (<サービス タイプ>)] ページで下までスクロールし、[edit] をクリックします。
- [Service Properties] ダイアログ ボックスで、サービス JSON の "properties" セクションを見つけます。
- cacheControlMaxAge プロパティをそのセクションに追加して、そのプロパティの値（秒単位）を指定します。以下に例を示します。
"properties": { "cacheControlMaxAge": "300", - [Save Edits] をクリックします。
- [Service - <サービス名> (<サービス タイプ>)] ページの[Properties] セクションで、cacheControlMaxAge プロパティと、それに指定した値が表示されていることを確認します。