LAYER

LAYER

適用： CONFIG   REQUEST   RESPONSE
サーバ： Image   Query   Feature   Extract   Geocode   ArcMap
親要素： GET_EXTRACT   GET_FEATURES   GET_GEOCODE   GET_IMAGE   LAYERS   MAP

<LAYER

属性の概要

     親要素：GET_FEATURES（サービスの既存のレイヤに対して）, GET_GEOCODE
     id ="文字列"

     親要素：GET_FEATURES（イメージサービスのダイナミックレイヤに対して）
     id ="文字列"
     type="featureclass"

     親要素：GET_IMAGEリクエストまたはマップ設定ファイルのLAYERS
     id ="文字列"

     親要素：IMAGEレスポンスのLAYERS
     featurecount ="文字列"
     id ="文字列"
     name ="文字列"

     親要素：MAP, GET_IMAGE, GET_EXTRACT
     id ="文字列"
     type ="featureclass | acetate | image"
     maxscale ="文字列"
     minscale ="文字列"
     name ="文字列"
     visible ="true | false" [true]
>

     親要素：GET_FEATURES（サービスの既存レイヤに対して）, GET_GEOCODE
          子要素なし

親要素：GET_FEATURES（イメージサービスのダイナミックレイヤに対して）
     <DATASET... />

     親要素：LAYERのtype属性が"featureclass"または"image" (ArcMapサーバ)のGET_IMAGE
     <DATASET... />
     <QUERY... /> [SPATIALQUERYまたはQUERYのどちらか]
     <SPATIALQUERY... /> [SPATIALQUERYまたはQUERYのどちらか]

     親要素：LAYERS
          子要素なし

     親要素：LAYERのtype属性が"acetate" (Image, ArcMapサーバ)のMAP, GET_IMAGE
     (m) <OBJECT... />

     親要素：LAYERのtype属性が"image" (Imageサーバ)のMAP, GET_IMAGE
     <DATASET... />
     <COORDSYS... />
     <IMAGEPROPERTIES... />
     <RASTER_RENDERER... /> [MAPの場合のみ有効]

     親要素：LAYERのtype属性が"featureclass" (Image, Extractサーバ)のMAP, GET_IMAGE, GET_EXTRACT
     <DATASET... />
     <COORDSYS... />
     <DENSIFY... />
     <QUERY... /> [SPATIALQUERYまたはQUERYのどちらか]
     <SPATIALQUERY... /> [SPATIALQUERYまたはQUERYのどちらか]
     (m) <EXTENSION... /> [MAPの場合のみ有効]
     <GROUPRENDERER... /> [または]
     <SCALEDEPENDENTRENDERER... /> [または]
     <SIMPLELABELRENDERER... /> [または]
     <SIMPLERENDERER... /> [または]
     <VALUEMAPLABELRENDERER... /> [または]
     <VALUEMAPRENDERER... /> [または]

</LAYER >

太字：必須の属性もしくは子要素
(m) ：複数回使用できる子要素

概要

親要素がMAPの場合、LAYER要素はマップレイヤを定義するために用います。レイヤとして、シェープファイルまたはArcSDEに格納されたポイントデータ、ラインデータ、ポリゴンデータのいずれかを用いる場合、type属性に"featureclass"を指定します。また、イメージデータを表示する場合は"image"を指定します。マップ上にオブジェクトを追加する場合はtype属性に"acetate"を指定します。
GET_IMAGEまたはGET_EXTRACTリクエストでは、LAYER要素は二種類の使われ方をします。一つは、既存のイメージサービスへダイナミックレイヤを追加するために使用されます。もう一つは、修正されたフォーマットで既存のイメージサービスのレイヤを追加するために使用されます。後者の機能は選択されたフィーチャのような既存のレイヤのサブセットを表示するためによく使用されます。
GET_FEATURESリクエストでは、フィーチャ情報を取得するレイヤを識別するために用います。
LEGEND中のLAYERSではサービスもしくはリクエスト中でどのレイヤを凡例中に含ませたくないのかを指定するために使用されます。
IMAGEレスポンス中で返される、マップの名称, ID, フィーチャ数を含んだ、ベクトル, イメージ, アセテートレイヤの情報を与えるために使用されます。

制限

各レイヤのIDは、サービス内で重複することはできません。また、リクエストにより動的に追加されたレイヤについても同様です。
ArcMapイメージサービスのリクエストにおいては、LAYER要素でダイナミックレイヤにデータを追加することはできません。
同時に複数のレンダラを指定することはできません。
ダイナミックレイヤ上では個別属性表示、条件検索は使用できません。
アセテートレイヤはGET_IMAGEリクエストでのみ有効です。GET_EXTRACTリクエストでは使用できません。
EXTENSIONおよびRASTER_RENDERERは、親要素がMAPの場合にのみ有効です。リクエストでは使用できません。

注意

GET_IMAGEリクエストにおいて動的レイヤを追加するためには、マップ設定ファイル内のMAP要素において、dynamic属性に"true"を設定しなければなりません。これはImageサーバの場合のみ有効です。
GET_IMAGEまたはGET_EXTRACTリクエストでは、新規レイヤを作成するためにLAYERを用います。既存レイヤのレンダリングや、レイヤの有効/無効を変更するためにはLAYERDEFを使用します。リクエストにおけるLAYERの使用法の詳細(使用例を含む)については、イメージサービスでのGET_IMAGEとIMAGE、ArcMapイメージサービスでのGET_IMAGEとIMAGE、GET_EXTRACTとEXTRACTを参照して下さい。
ArcSDEレイヤを使用する場合は、レンダラの前にDATASET属性を定義する必要があります。
一つのアセテートレイヤにおいて、複数のOBJECTを定義することができます。
ArcXMLにおいて縮尺を指定する場合、"比で表した縮尺"または"ピクセル当りのマップ単位(1ピクセルあたりのマップ単位の計算値)"のどちらかを用います。比で表した縮尺では、縮尺の比率を「1:24000」のような形式で表します。この例では、地図上の1メートルが現地の24000メートルに相当します。比で表した縮尺により指定する場合には、二つの値をコロン記号(:)で区切ります。

ピクセル当りのマップ単位は、マップ中の1ピクセルあたりのメートル, フィート, 十進経緯度を意味します。"比で表した縮尺"を"ピクセル当りのマップ単位"に変換するためには、まず最初にピクセルのサイズを算出する必要があります。ピクセルサイズをメートルに換算するための式は"0.0254 / dpi"であり、その根拠は次の通りです。
- 1インチは0.0254メートルに相当します。
- "dpi"はArcIMSサービスまたはリクエストで設定されているdpi属性の値です。もしdpi属性が設定されていない場合は、dpiの値は"96"と見なされます。
ピクセルサイズの計算例として、もしdpiが96なら、"0.0254 / 96"で、0.000265mとなります。

ピクセルのサイズが明らかになれば、比で表した縮尺は下記の要領でピクセル当りのマップ単位へ変換できます。
1. メートル：ピクセルあたりのメートルを計算するには、比で表した縮尺値とピクセルサイズ(0.000265)の掛け算を行います。例えば、比で表した縮尺値が"1:24000"の場合、ピクセルあたりのメートルは"24000 * 0.000265"で、6.36mになります。
2. フィート：ピクセルあたりのメートルの計算(#1)を行います。その結果に3.28を掛けます(1ftは3.28mです)。例えば、ピクセルあたりのメートルが6.36だった場合、ピクセルあたりのフィートは"6.36 * 3.28"で、20.86ftになります。
3. 十進経緯度：この計算は、地球が円周40030.174 kmの円であると仮定したものです。1度は111.195km (40030.174/360度)で、つまり111195mです。ピクセルあたりの度数を計算するためには、最初にピクセルあたりのメートルの計算(#1)を行います。次に、この結果を111195で割り算します。例えば、ピクセルあたりのメートルが6.36だった場合、ピクセルあたりの度数は"6.36 / 111195"で、つまり0.0000571968度になります。

属性の概要

親要素：GET_FEATURES（サービスの既存レイヤ), GET_GEOCODE

属性	使い方	トップに戻る
id	IDはマップ設定ファイル内で指定します。リクエストを有効にするためには、リクエスト内で指定するIDは、マップ設定ファイルでの指定と一致しなければなりません。

親要素：GET_FEATURES（イメージサービスのダイナミックレイヤ)

属性	使い方	トップに戻る
id	IDはマップ設定ファイル内で指定します。リクエストを有効にするためには、リクエスト内で指定するIDは、マップ設定ファイルでの指定と一致しなければなりません。
type	レイヤのタイプの指定。有効な値は"featureclass"のみです。

親要素：GET_IMAGEリクエストまたはマップ設定ファイルのLAYERS

属性	使い方	トップに戻る
id	IDはマップ設定ファイルまたはリクエスト内で指定します。凡例リストを有効にするためには、指定するIDがマップ設定ファイルまたはリクエストでの指定と一致しなければなりません。

親要素：IMAGEレスポンスのLAYERS

属性	使い方	トップに戻る
featurecount	シェープファイルまたはArcSDEの場合はマップ上のフィーチャの数をカウントします。イメージレイヤの場合は、マップ上のイメージの数をカウントします。アセテートレイヤの場合は、レイヤ上でOBJECTが使用された回数をカウントします。
id	IDはマップ設定ファイルまたはリクエスト内で指定します。
name	Nameはマップ設定ファイルまたはリクエスト内で指定します。

親要素：MAP, GET_IMAGE, GET_EXTRACT

属性	使い方	トップに戻る
id	各レイヤには重複しないIDを指定します。IDにはアルファベットと数字の任意の組み合わせを使用することができます。データ抽出機能がレイヤに対して適用されている場合、レイヤに対するEXTENSION要素でファイル名称が指定されていないときは、IDの文字列はファイル名称として有効な半角英数字でなければいけません。
maxscale	マップの最大表示縮尺を、"1:24000"のような比で表した縮尺で指定します。縮尺値は、ピクセル当りのマップ単位でも計算できます。
minscale	マップの最小表示縮尺を、"1:24000"のような比で表した縮尺で指定します。縮尺値は、ピクセル当りのマップ単位でも指定できます。
name	レイヤ名を指定します。エイリアスも指定可能です。
type	レイヤの種別を指定します。シェープファイルまたはArcSDEのベクトルレイヤの場合は"featureclass"を指定します。ラスタ画像, GRID, ArcSDEラスタの場合は"image"を指定します。マップの最前面に図形を追加する場合は"acetate"を指定します。
visible	レイヤの表示/非表示を指定します。

サンプル

サンプル 1：CONFIGの場合

トップに戻る

サンプル 2：凡例リストからIDが"0"と"1"のレイヤを削除するマップ設定ファイルの場合

トップに戻る

<?xml version="1.0" encoding="UTF-8"?>
<ARCXML version="1.1">
   <CONFIG>
     <ENVIRONMENT>
       <LOCALE country="US" language="en" variant="" />
       <UIFONT color="0,0,0" name="Arial" size="12" style="regular" />
       <SCREEN dpi="96" />
     </ENVIRONMENT>
     <MAP dynamic="true" >
       <PROPERTIES>
       <ENVELOPE minx="-180.0" miny="-90.0" maxx="180.0" maxy="90.0" name="Initial_Extent" />
       <MAPUNITS units="decimal_degrees" />
       <FILTERCOORDSYS id="4326" />
      <FEATURECOORDSYS id="4326"/>
      <LEGEND title="Legend" font="Arial" autoextend="true" columns="1" width="170" height="300" backgroundcolor="255,255,0" >
         <LAYERS>
           <LAYER id="0"/>
           <LAYER id="1"/>
         </LAYERS>
       </LEGEND>
       </PROPERTIES>
       <WORKSPACES>
         <SHAPEWORKSPACE name="shp_ws-0" directory="<path to WORLD ESRIDATA>" />
         <SHAPEWORKSPACE name="shp_ws-2" directory="<path to USA ESRIDATA>" />
         <SHAPEWORKSPACE name="shp_ws-3" directory="<path to CANADA ESRIDATA>" />
       </WORKSPACES>
       <LAYER type="featureclass" name="WORLD30" visible="true" id="0">
         <DATASET name="WORLD30" type="polygon" workspace="shp_ws-0" />
         <SIMPLERENDERER>
           <SIMPLEPOLYGONSYMBOL filltype="solid" fillcolor="0,153,255" />
         </SIMPLERENDERER>
       </LAYER>
       <LAYER type="featureclass" name="CNTRY94" visible="true" id="1">
         <DATASET name="CNTRY94" type="polygon" workspace="shp_ws-0" />
         <SIMPLERENDERER>
           <SIMPLEPOLYGONSYMBOL filltype="solid" fillcolor="255,255,153" />
         </SIMPLERENDERER>
       </LAYER>
       <LAYER type="featureclass" name="United States" visible="true" id="2">
         <DATASET name="STATES" type="polygon" workspace="shp_ws-2" />
         <SIMPLERENDERER>
           <SIMPLEPOLYGONSYMBOL filltype="solid" fillcolor="255,0,0" />
         </SIMPLERENDERER>
       </LAYER>
       <LAYER type="featureclass" name="Canada" visible="true" id="3">
         <DATASET name="province" type="polygon" workspace="shp_ws-3" />
         <SIMPLERENDERER>
           <SIMPLEPOLYGONSYMBOL filltype="solid" fillcolor="0,153,0" />
         </SIMPLERENDERER>
       </LAYER>
       <LAYER type="featureclass" name="World Cities" visible="true" id="4">
         <DATASET name="CITIES" type="point" workspace="shp_ws-0" />
         <SIMPLERENDERER>
           <SIMPLEMARKERSYMBOL color="102,0,102" width="8.0" />
         </SIMPLERENDERER>
       </LAYER>
     </MAP>
   </CONFIG>
</ARCXML>

サンプル 3：凡例リストからIDが"0"と"1"のレイヤを削除するLAYERSの場合

トップに戻る

<?xml version="1.0" encoding="UTF-8"?>
<ARCXML version="1.1">
   <REQUEST>
     <GET_IMAGE>
       <PROPERTIES>
         <LEGEND title="Legend" font="Arial" autoextend="true" columns="1" width="170" height="300" backgroundcolor="255,255,0" >
           <LAYERS>
             <LAYER id="0"/>
             <LAYER id="1"/>
           </LAYERS>
         </LEGEND>
         <DRAW map="false"/>
       </PROPERTIES>
     </GET_IMAGE>
   </REQUEST>
</ARCXML>

サンプル 4：GET_FEATURESリクエスト中でIDによるレイヤの指定	トップに戻る
<?xml version="1.0" encoding="UTF-8"?> <ARCXML version="1.1"> <REQUEST> <GET_FEATURES featurelimit="25" beginrecord="0" outputmode="xml" geometry="false" envelope="true" compact="true"> <LAYER id="4" /> <SPATIALQUERY subfields="#ALL#" where="NAME = 'Los Angeles'" > </SPATIALQUERY> </GET_FEATURES> </REQUEST> </ARCXML>

サンプル 5：リクエストされたArcIMSサービス中のレイヤの詳細情報を示すIMAGEレスポンス

トップに戻る

<?xml version="1.0" encoding="UTF8"?>
<ARCXML version="1.1">
   <RESPONSE>
     <IMAGE>
       <ENVELOPE minx="-180" miny="-135" maxx="180" maxy="135"/>
       <LAYERS>
         <LAYER name="CNTRY94" id="0" featurecount="165" />
         <LAYER name="STATES" id="1" featurecount="51" />
         <LAYER name="province" id="2" featurecount="12" />
       </LAYERS>
      <OUTPUT file="c:\arcims\output\world_MYCOMPUTER3633699.jpg" url="http://mycomputer.domain.com/output/world_MYCOMPUTER3633699.jpg" />
     </IMAGE>
   </RESPONSE>
</ARCXML>