BUFFER

BUFFER

適用： REQUEST
サーバ： Image   Query   Feature   ArcMap
親要素： QUERY   SPATIALFILTER   SPATIALQUERY

<BUFFER	属性の概要
ArcMapまたはFeatureサーバの場合： *distance ="倍精度実数"* bufferunits ="decimal_degrees \| miles \| feet \| kilometers \| meters" [MAPUNITSはPROPERTIESに定義] Imageサーバの場合： *distance ="倍精度実数"* bufferunits ="decimal_degrees \| miles \| feet \| kilometers \| meters" [MAPUNITSはPROPERTIESに定義] project ="true \| false" [true] > 親要素：SPATIALFILTER 子要素なし親要素：SPATIALQUERY <SPATIALQUERY... /> <TARGETLAYER... /> </BUFFER >
太字：必須の属性もしくは子要素

概要

選択されたフィーチャのまわりにバッファ領域を構築します。

制限

BUFFERの中で使用されるSPATIALQUERYは、他のBUFFERを含むことはできません。
ArcMapイメージサービスで、バッファレイヤとターゲットレイヤを同じにすることはできません。

注意

バッファには3つの方法が使用できます。

	1つ以上の選択されたフィーチャの周りの領域をバッファするには、SPATIALQUERY内でBUFFERを使用して下さい。このサンプルではコロラド川がバッファされます。 <LAYER type="featureclass" name="theRiverBuffer" id="RivBuf"> <DATASET fromlayer="Rivers" /> <SPATIALQUERY where="NAME='Colorado'"> <BUFFER distance="80" bufferunits="MILES" /> </SPATIALQUERY> <SIMPLERENDERER> <SIMPLEPOLYGONSYMBOL fillcolor="255,255,0" filltransparency=".3" boundarycolor="255,255,0" boundarywidth="2" /> </SIMPLERENDERER> </LAYER>
	同一レイヤまたは別レイヤからバッファ領域内にあるフィーチャを選択するには、TARGETLAYERを子要素として使用して下さい。このサンプルでは、コロラド川から80マイル以内の都市が選択されています。（画像のバッファは参考のために示されたものです。このリクエストでは、選択された都市だけが表示されます。都市を強調してバッファを表示するには、前後のLAYERサンプルをリクエストで使用する必要があります。） <LAYER type="featureclass" name="theRiverBuffer" id="RivBuf"> <DATASET fromlayer="Rivers" /> <SPATIALQUERY where="NAME='Colorado'"> <BUFFER distance="80" bufferunits="MILES" > <TARGETLAYER id="Cities" /> </BUFFER> </SPATIALQUERY> <SIMPLERENDERER> <SIMPLEMARKERSYMBOL color="255,255,0" width="6" /> </SIMPLERENDERER> </LAYER>
	選択ツールとしてバッファを使用する場合。BUFFERはSPATIALFILTERで定義されたフィルタの周りで使用されます。このサンプルでは、BUFFERはエンベロープの周りでバッファするために使用されます。内側の黄色いボックスがオリジナルのエンベロープです。外側の黄色いボックスはバッファフィルタです。これらのボックスは通常は表示されず、フィルタ内の選択されたアイテムのみが表示されることに注意して下さい。 <LAYER type="featureclass" name="theEvelopeBuffer" id="EnvBuf" > <DATASET fromlayer="Cities" /> <SPATIALQUERY where="POPULATION > 1000000" > <SPATIALFILTER relation="area_intersection"> <ENVELOPE minx="-119" miny="32" maxx="-113" maxy="35" /> <BUFFER distance="100" bufferunits="MILES" /> </SPATIALFILTER> </SPATIALQUERY> <SIMPLERENDERER> <SIMPLEMARKERSYMBOL color="255,255,0" width="6" /> </SIMPLERENDERER> </LAYER>

GET_FEATURESリクエストでSPATIALQUERYがBUFFERの親要素でsubfieldsが含まれている場合、サブフィールドの一覧に#SHAPE#あるいは#ALL#フィールドが含まている必要があります。
ポリゴンフィーチャはバッファ距離に0を使用することができます。ラインまたはポイントフィーチャのバッファ距離に0が使用された場合、データは返却されません。
バッファの結果は投影されていないデータ上では精密ではないかも知れません。バッファを適用する前にデータを投影することを推奨します。
以下のような場合、FILTERCOORDSYSYSとFEATURECOORDSYSがTARGETLAYER内に含まれている必要があります。
- ターゲットレイヤで返却されたフィーチャのENVELOPEを投影する必要がある場合（GET_FEATURES envelope="true"）
- 返却されたフィーチャの全体のエンベロープを投影する必要がある場合（GET_FEATURES globalenvelope="true"）
- ターゲットレイヤのフィーチャのジオメトリを投影する必要がある場合（GET_FEATURES geometry="true"）
いずれの場合も、BUFFER内のSPATIALQUERYはサブフィールドの一覧に#SHAPE#あるいは#ALL#フィールドを含んでいる必要があります。subfieldsが含まれていない場合、#SHAPE#フィールドを含むすべてのフィールドが返却されます。

属性の概要

属性	使い方	トップに戻る
bufferunits	バッファに適用する単位を指定します。
distance	バッファ単位でのバッファ距離です。
project	FEATURECOORDSYSがマップ設定ファイルまたはリクエストにある場合、生成されるバッファは投影されます。projectがfalseに設定されている場合、バッファは投影されません。既知の制限：投影しているバッファとTARGETLAYERが使用される場合、FEATURECOORDSYSとFILTERCOORDSYSがマップ設定ファイルに含まれていても、それらはTARGETLAYER内で明示的に定義される必要があります。そうでない場合、バッファは予想通りに投影されないでしょう。TARGETLAYERがない場合、リクエスト内に座標系要素を含める必要はありません。

サンプル

サンプル 1：GET_FEATURESリクエストの場合

トップに戻る

<?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="2" /> 
      <SPATIALQUERY subfields="#SHAPE# NAME">
        <BUFFER distance="1" >
          <TARGETLAYER id="4" /> 
          <SPATIALQUERY subfields="NAME" />
        </BUFFER>
        <SPATIALFILTER relation="area_intersection" >
          <ENVELOPE minx="-16154208.3772906" miny="-4165319.9729724" maxx="-4904885.23874079" maxy="4271672.38093997" />
        </SPATIALFILTER>
      </SPATIALQUERY>
    </GET_FEATURES>
  </REQUEST>
</ARCXML>

サンプル 2：GET_IMAGEリクエストの場合。このサンプルではDATASETのfromlayerが"CITIES"であることに注意して下さい。このサンプルではLAYERのnameではなく、マップ設定ファイルのLAYERのidを参照します。

トップに戻る

<?xml version="1.0" encoding="UTF-8"?>
<ARCXML version="1.1">
  <REQUEST>
    <GET_IMAGE>
      <PROPERTIES>
        <ENVELOPE minx="867805.08306143" miny="6771243.45626185" maxx="1576642.8482793" maxy="7302871.78017525"/>
      </PROPERTIES>
      <LAYER type="featureclass" name="theBufferTarget" visible="true" id="buffertarget">
        <DATASET fromlayer="CITIES"/>
        <SPATIALQUERY>
          <BUFFER distance="100" bufferunits="miles">
            <TARGETLAYER id="CITIES"/>
nbsp;         </BUFFER>
          <SPATIALFILTER relation="area_intersection">
            <ENVELOPE minx="867805.08306143" miny="6771243.45626185" maxx="1576642.8482793" maxy="7302871.78017525"/>
          </SPATIALFILTER>
        </SPATIALQUERY>
        <SIMPLERENDERER>
          <SIMPLEMARKERSYMBOL color="255,0,0" />
        </SIMPLERENDERER>
      </LAYER>
      <LAYER type="featureclass" name="theBuffer" visible="true" id="buffer">
        <DATASET fromlayer="CITIES"/>
        <SPATIALQUERY>
          <BUFFER distance="100" bufferunits="miles" />
          <SPATIALFILTER relation="area_intersection">
            <ENVELOPE minx="867805.08306143" miny="6771243.45626185" maxx="1576642.8482793" maxy="7302871.78017525"/>
          </SPATIALFILTER>
        </SPATIALQUERY>
        <SIMPLERENDERER>
          <SIMPLEPOLYGONSYMBOL fillcolor="100,100,100" filltype="solid" filltransparency="0.5" />
        </SIMPLERENDERER>
      </LAYER>
    </GET_IMAGE>
  </REQUEST>
</ARCXML>

サンプル 3：ターゲットレイヤでフィーチャを投影している場合、または投影されたエンベロープか全体のエンベロープが必要とされる場合

トップに戻る

<?xml version="1.0" encoding="UTF-8" ?>
<ARCXML version="1.1">
  <REQUEST>
    <GET_FEATURES outputmode="xml" geometry="true" envelope="true" checkesc="true" globalenvelope="true">
      <LAYER id="0" ftype="polygon" />
        <SPATIALQUERY where="STATE_NAME='Nevada'">
        <BUFFER distance="0" bufferunits="miles" project="true" >
        <TARGETLAYER id="1" />
          <SPATIALQUERY subfields="CITY_NAME #SHAPE#">
            <FEATURECOORDSYS id="102008" />
            <FILTERCOORDSYS id="102008" />
          </SPATIALQUERY>
        </BUFFER>
      </SPATIALQUERY>
    </GET_FEATURES>
  </REQUEST>
</ARCXML>