ENVELOPE サンプル

適用：  CONFIG  REQUEST   RESPONSE   MARKUP
サーバ：  Image   Query   Feature   Extract   Metadata   ArcMap  
親要素：  DATAFRAME   EXTRACT   FCLASS   FEATURE   FEATURES   GET_PROJECT   IMAGE   LAYERINFO   LAYOUT   LAYOUTINFO   METADATA_DATASET  PARTITION   PROJECT   PROPERTIES   PUT_METADATA   SEARCH_METADATA   SPATIALFILTER  

<ENVELOPE 属性の概要


     親要素：全て(PROPERTIESとSEARCH_METADATA以外)
     maxx ="倍精度実数"
     maxy ="倍精度実数"
     minx ="倍精度実数"
     miny ="倍精度実数"

     親要素：PROPERTIES
     maxx ="倍精度実数"
     maxy ="倍精度実数"
     minx ="倍精度実数"
     miny ="倍精度実数"
     name ="Initial_Extent | Extent_Limit"  [Initial_Extent]
     reaspect ="true | false"  [true]

     親要素：SEARCH_METADATA
     maxx ="倍精度実数"
     maxy ="倍精度実数"
     minx ="倍精度実数"
     miny ="倍精度実数"
     spatialoperator ="within | overlaps | overlaps2 | fuzzywithin | fuzzyequals"  [fuzzywithin]
>

     子要素なし
</ENVELOPE >
太字：必須の属性もしくは子要素


概要


制限


注意


属性の概要


親要素：全て(PROPERTIESとSEARCH_METADATA以外)
属性 使い方 トップに戻る
maxx 右上のX座標(マップ単位)の設定です。ただし、LAYOUTとLAYOUTINFOの場合はスクリーン単位です。
maxy 右上のY座標(マップ単位)の設定です。ただし、LAYOUTとLAYOUTINFOの場合はスクリーン単位です。
minx 左下のX座標(マップ単位)の設定です。ただし、LAYOUTとLAYOUTINFOの場合はスクリーン単位です。
miny 左下のY座標(マップ単位)の設定です。ただし、LAYOUTとLAYOUTINFOの場合はスクリーン単位です。

親要素：PROPERTIES
属性 使い方 トップに戻る
maxx 右上のX座標(マップ単位)の設定です。
maxy 右上のY座標(マップ単位)の設定です。
minx 左下のX座標(マップ単位)の設定です。
miny 左下のY座標(マップ単位)の設定です。
name マップ設定ファイルとビューア設定ファイルでの表示範囲の種類を設定します。"Initial_Extent"は、サービスに最初にアクセスした時の地図全体。"Extent_Limit"は、縮小した際の最大描画範囲です。範囲制限(Extent Limit)はクライアント側で処理されなければなりません。リクエストの処理で、空間サーバは、"Extent_Limit"を含むENVELOPEを無視します。

ビューア設定ファイル内で範囲制限が使用されている場合、それはたいていdefault.axlファイルですが、２つのENVELOPE要素が存在していても構いません。この２つのENVELOPEによる範囲の値は同じである必要はありません。
<PROPERTIES>
<ENVELOPE minx="-166" miny="3" maxx="-26" maxy="80" name="Extent_Limit"/>
<ENVELOPE minx="-128.1" miny="18.7" maxx="-53.7" maxy="51.3" name="Initial_Extent"/>
<PROPERTIES>

範囲制限がビューア設定ファイル（default.axlなど）内に含まれており、ArcIMS Javaビューアが使用されている場合、範囲制限の外側の部分は表示されません。

範囲制限がマップ設定ファイル内で使用されている場合、SERVICEINFOレスポンス中に"Extent_Limit"を持つENVELOPEが含まれます。空間サーバはリクエスト中のこの値を無視しますので、この範囲制限の情報は単にリストアップされているだけです。その代わり、クライアント側ではこの範囲制限を取り扱わなければなりません。例えば、ArcIMS HTMLビューアがこの範囲制限を使用して、空間サーバではなくビューアがこの値を処理します。ArcExplorer 9で表示されているサービスは範囲制限を持ちませんので、ユーザは自由に地図の縮小を行うことができます。

"Extent_Limit"についての詳しい情報は、設定ファイルを参照して下さい。
reaspect クライアント上の地図表示エリアに合うようにENVELOPEを調整するかどうかを指定するフラグです。デフォルトでは、ピクセルの縦横比は常に同じですが、reaspectの値をfalseにすることで、マップのピクセル幅と高さの比が変わります。イメージ サービスでのみ有効です。

親要素：SEARCH_METADATA
属性 使い方 トップに戻る
maxx 右上のX座標(マップ単位)の設定です。
maxy 右上のY座標(マップ単位)の設定です。
minx 左下のX座標(マップ単位)の設定です。
miny 左下のY座標(マップ単位)の設定です。
spatialoperator メタデータの検索範囲についての設定です。
  • within - 指定した検索範囲内にメタデータのenvelopeが完全に含まれているドキュメントを検索します。検索範囲の境界線も含みます。
  • overlaps - 指定した検索範囲内にメタデータのenvelopeの一部でも含まれているドキュメントを検索します。検索範囲の境界に接する場合も含みます。
  • overlaps2 - "overlaps"と同じですが、検索範囲内にメタデータのenvelopeが完全に含まれているものは検索されません。
  • fuzzywithin - 指定した検索範囲内にメタデータのenvelopeがおおよそ入っているものを検索します。指定した検索範囲は10％拡張され、その範囲内に入り、もとの検索範囲と交差するメタデータを検索します。境界に接する場合も含みます。
  • fuzzyequals - メタデータのenvelopeがおおよそ指定した検索範囲と同じものを検索します。指定した検索範囲は10％外側と内側へ拡張されます。外側へ拡張された検索範囲に完全に含まれ、かつ、内側の検索範囲を完全に含むメタデータを検索します。
 

サンプル

サンプル 1：初期表示範囲を設定するCONFIGの場合 トップに戻る
<?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>
      <PROPERTIES>
       <ENVELOPE minx="-178.2" miny="18.9" maxx="-66.9" maxy="71.4" name="Initial_Extent" />
       <MAPUNITS units="decimal_degrees" />
      <FILTERCOORDSYS id="4326" />
      <FEATURECOORDSYS id="4326"/>
      </PROPERTIES>
      <WORKSPACES>
       <SHAPEWORKSPACE name="shp_ws-0" directory="<path to USA ESRIDATA>" />
      </WORKSPACES>
      <LAYER type="featureclass" name="STATES" visible="true" id="0">
       <DATASET name="STATES" type="polygon" workspace="shp_ws-0" />
       <SIMPLERENDERER>
         <SIMPLEPOLYGONSYMBOL fillcolor="255,255,153" filltype="solid" />
       </SIMPLERENDERER>
      </LAYER>
    </MAP>
  </CONFIG>
</ARCXML>

サンプル 2：マップの範囲設定(1番目のENVELOPE)と、空間検索のための範囲設定(2番目のENVELOPE)を行うGET_IMAGEリクエストの場合 トップに戻る
<?xml version="1.0" encoding="UTF-8"?>
<ARCXML version="1.1">
  <REQUEST>
  <GET_IMAGE>
    <PROPERTIES>
      <ENVELOPE minx="-180" miny="-90" maxx="180" maxy="90" />
      <LAYERLIST>
        <LAYERDEF id="Cities">
          <SIMPLERENDERER>
            <SIMPLEMARKERSYMBOL width="16" color="0,0,0" />
          </SIMPLERENDERER>
         <SPATIALQUERY>
            <SPATIALFILTER relation="area_intersection">      
            <ENVELOPE maxy="60" maxx="60" miny="0" minx="0" />
         </SPATIALFILTER>
         </SPATIALQUERY>
      </LAYERDEF>
      </LAYERLIST>
   </PROPERTIES>
  </GET_IMAGE>
  </REQUEST>
</ARCXML>

サンプル 3：初期表示範囲とレイヤの範囲を取得するSERVICEINFOレスポンスの場合 トップに戻る
<?xml version="1.0" encoding="UTF-8"?>
<ARCXML version="1.1">
  <RESPONSE>
    <SERVICEINFO>
      <ENVIRONMENT>
        <LOCALE language="en" country="US" />
        <UIFONT name="Arial" color="0,0,0" size="12" style="regular" />
        <SEPARATORS cs=" " ts=";"/>
        <CAPABILITIES forbidden="" disabledtypes=""/>
        <SCREEN dpi="96"/>
        <IMAGELIMIT pixelcount="1048576" />
      </ENVIRONMENT>
      <PROPERTIES>
        <ENVELOPE minx="-180" miny="-90" maxx="180" maxy="90" ame="Initial_Extent" />
        <MAPUNITS units="decimal_degrees" />
      <FILTERCOORDSYS id="4326" />
      <FEATURECOORDSYS id="4326"/>
      </PROPERTIES>
      <LAYERINFO type="featureclass" visible="true" name="Cities" id="0">
        <FCLASS type="point">
          <ENVELOPE minx="-165.270004272461" miny="-53.1500015258789" maxx="177.130187988281" maxy="78.1999969482422" />
        </FCLASS>
      </LAYERINFO>
    </SERVICEINFO>
  </RESPONSE>
</ARCXML>

サンプル 4：GET_LAYOUTの場合(注意：PROPERTIES要素中のENVELOPEはスクリーン単位) トップに戻る
<?xml version="1.0" encoding="UTF-8"?>
<ARCXML version="1.1">
  <REQUEST>
    <GET_LAYOUT>
      <PROPERTIES>
        <ENVELOPE minx="0" miny="0" maxx="8.5" maxy="11" />
        <FILTERCOORDSYS id="54030" />
        <FEATURECOORDSYS id="54030" />
        <IMAGESIZE width="800" height="600" />
        <OUTPUT type="jpg" />
      </PROPERTIES>
      <DATAFRAME id="Layers" >
        <FILTERCOORDSYS id="4326" />
        <FEATURECOORDSYS id="4326" />
        <ENVELOPE minx="-121" miny="36" maxx="-112" maxy="44" />
      </DATAFRAME>
    </GET_LAYOUT>
  </REQUEST>
</ARCXML>

サンプル 5：メタデータの検索範囲をENVELOPEで定義した範囲内に限定する場合 トップに戻る
<?xml version="1.0" encoding="UTF-8" ?>
<ARCXML version="1.1">
  <REQUEST>
    <GET_METADATA>
      <SEARCH_METADATA operator="and">
        <ENVELOPE minx="-176.98" miny="18.93" maxx="-66.97" maxy="71.35" spatialoperator="within" />
        <TAGVALUE tag="metadata/dataqual/lineage/srcinfo/srccite/citeinfo/pubdate" greaterthan="1990" />
        <FULLTEXT word="cities"/>
        <SEARCH_METADATA operator="or">
          <TAGTEXT tag="metadata/idinfo/citation/citeinfo/geoform" word="data"/>
          <TAGTEXT tag="metadata/idinfo/citation/citeinfo/geoform" word="digital"/>
        </SEARCH_METADATA>
      </SEARCH_METADATA>
    </GET_METADATA>
  </REQUEST>
</ARCXML>