Web アプリケーション

ArcGIS API for JavaScript を使って開発する際、タイル (キャッシュ) マップ サービスへ接続していることを示す特定のクラスを使用します。たとえば、ArcGISTiledMapServiceLayer を使用してキャッシュ サービスに接続します。キャッシュ サービスを使用すると、タイルは REST コールによってキャッシュ ディレクトリからマップ サービスへ取得されます。タイル リクエストの形式は、https://<map service URL>/tile/<level>/<row>/<column> のようになります。

Web アプリケーションでキャッシュ サービスを 1 つ表示しており、タイルが存在しない場所に画面移動した場合、アプリケーションは動的なイメージを表示しないため、何も表示されません。キャッシュされていないエリアに画面移動したときにマップが表示されるようにする方法の 1 つは、オンデマンド キャッシュを有効にすることです。

• 次のような URL が表示された場合、アプリケーションは REST リクエストからタイルを取得しています。

  https://gisserver.domain.com:6443/arcgis/rest/services/myService/MapServer/tile/10/1723/3495.jpg

• マップ イメージに別の URL が表示された場合、アプリケーションが効率の悪い方法でタイルを取得しているか、キャッシュが使用されていません。

ArcMap と ArcGIS Pro

[データの追加] ボタンを使用し、他のマップ サービスを追加する同じ方法でキャッシュ マップ サービスを ArcMap および ArcGIS Pro に追加します。キャッシュを表示する方法として次の 2 種類があります。

• マップ サービスを使用したキャッシュへのアクセス - この方法でキャッシュを表示するには、キャッシュの作成に使用された GIS サーバーとマップ サービスを参照します。この方法では、最初に GIS サーバーに接続することで、サービスにキャッシュがあるかどうかが確認されます。次に、ArcMap は、サーバーのファイル システムにあるキャッシュ ディレクトリからタイルを取得します。
• ラスター データセットとしてキャッシュにアクセス - この方法でキャッシュを表示するには、キャッシュ タイルを含むディレクトリを参照して、データセットを追加します。キャッシュには、[データの追加] ボタンを使ってその他すべてのラスターを追加する際に使用するアイコンと同じものが表示されます。ラスターとしてアクセスされるキャッシュは表示専用で、検索することはできません。このタイプのキャッシュを使用する利点は、これがマップ サービスと結び付けられておらず、キャッシュ ディレクトリにアクセス可能であれば、サーバーから切断しているときに表示できる点です。

キャッシュの縮尺レベルと完全に一致する縮尺でタイルがリクエストされた場合、マップ サービスは直接タイルを返します。ほとんどの場合、リクエストがキャッシュ内の縮尺レベルと正確に一致することはありません。この場合は、ArcMap は次に近い縮尺レベルのタイルがリクエストされ、リクエストされた縮尺に合わせてそれをリサンプリングします。このリサンプリングは、タイルを動的に生成するよりもはるかに高速ですが、元のタイルと表示が異なるイメージが作成されてしまいます。ここのリサンプリングにより、キャッシュされているマップ ラベルを特定の縮尺で読み取ることが難しくなる場合があります。最もよい結果を得るために、キャッシュが作成された縮尺か、それに近い縮尺でマップを表示してください。

cacheControlMaxAge プロパティの使用方法

ArcGIS Server マップ サービスの応答には、エンティティ タグ (ETag) ヘッダーとキャッシュ コントロール ヘッダーが含まれています。ETag ヘッダーの値は、応答の一意の識別子です。キャッシュ コントロール ヘッダーには、キャッシュから応答を再利用できる最大期間に関する情報をブラウザーに提供する max-age 値が含まれています。この値は、cacheControlMaxAge プロパティによって制御されます。

リクエストが繰り返された場合、キャッシュの最大期間の期限が切れていなければ、ブラウザーは、サーバーにリクエストを送信しないで、キャッシュされている応答を使用します。キャッシュの最大期間の期限が切れている場合、ブラウザーは、リクエストをサーバーに送信し、キャッシュ内の応答に対応する ETag 値を使用して IF-NONE-MATCH ヘッダーを設定する必要があります。ArcGIS Server は、リクエストを評価し、ETag 値を使用して、応答が変更されているかどうかを判定します。サーバーからの応答がブラウザー上のコピーと異なる場合、サーバーはまったく新しい応答をブラウザーに送信します。応答がブラウザー上のコピーと同一である場合、サーバーは、キャッシュ内の応答を引き続き使用するようにブラウザーに警告します。

cacheControlMaxAge プロパティの値の定義

ブラウザーで、キャッシュされた応答を使用できる期間を指定するには、cacheControlMaxAge プロパティを定義します。このプロパティは、個別のサービス キャッシュに対して設定できます。ArcGIS Server が完全な応答を送信する必要性を軽減することによって、ブラウザーのキャッシュを効率化し、アプリケーションを最適化し、ネットワーク帯域幅を節約することができます。

クライアントがタイルをローカルにキャッシュすることを許可しないキャッシュされたマップ サービスの場合、デフォルトは 0 です。これは、ブラウザーが必ずリクエストを再送し、ArcGIS Server がそのリクエストを処理して、コンテンツが変更されている場合に完全な応答をブラウザーに送信するということを意味します。このデフォルト値は、ほとんどのアプリケーションで有効に機能します。

クライアントがタイルをローカルにキャッシュすることを許可するキャッシュ マップ サービスの場合、デフォルト値は 86,400 秒 (1 日) です。これは、リクエストが 1 日以内に繰り返された場合、ブラウザーがキャッシュ内の応答を使用するということを意味します。

マップやデータが頻繁に変更されないキャッシュ マップ サービスの場合は、ネットワーク トラフィックを最小限に抑えるために、デフォルト値を 30 日 (259.2000 秒) まで大きくすることをお勧めします。

cacheControlMaxAge プロパティをサービスに追加してデフォルト値を指定するには、以下の手順を実行します。

1. Web ブラウザーで ArcGIS Server Administrator Directory を開き、管理者権限を持つユーザーでログインします。URL の形式は https://gisserver.domain.com:6443/arcgis/admin です。
2. [services] をクリックして、変更するマップ サービスを [Services] リストから選択します。サービスがリストに表示されない場合は、[Root folder]の下のディレクトリに配置されている可能性があります。
3. [Service - <サービス名> (<サービス タイプ>)] ページで下までスクロールし、[edit] をクリックします。
4. [Service Properties] ダイアログ ボックスで、サービス JSON のプロパティ セクションを見つけます。
5. cacheControlMaxAge プロパティをそのセクションに追加して、そのプロパティの値 (秒単位) を指定します。以下に例を示します。

   "properties": {
     "cacheControlMaxAge": "2592000",

6. [編集の保存] をクリックします。
7. [Service - <サービス名> (<サービス タイプ>)] ページの [Properties] セクションで、cacheControlMaxAge プロパティと、それに指定した値が表示されていることを確認します。