複数の名前付きレイヤの記述

説明

この操作は、レイヤのリストを入力としてリクエストから受け取り、それらのレイヤの記述を返します。この情報には、テーブル、ラベルソース (名前付きまたはインライン)、属性、主題図、表示条件などが含まれます。この記述からのレスポンスに含まれるレイヤ部は、マップ定義に組み込むことができます。この定義は、REST Render Map や Render Map Legend のリクエストで利用できます。

HTTP POST URL 形式

HTTP POST リクエストには次の形式を使用します。


POST:	http://<server>:<port>/rest/Spatial/MappingService/layers.json
POST DATA:	{
                      "namedLayersList": [
			"layerPath1",
			"layerPath2"]
                 }
POST BODY: Content-Type:application/json {list of layers}

パラメータ

以下のパラメータのタイプについては、リクエスト URL のデータタイプを参照してください。


パラメータ	タイプ	必須	説明
layers=`<layers>`	文字列のリスト	はい	情報を返す必要があるレイヤのパスを含む、カンマ区切りリスト。(例: layers=/Samples/NamedLayers/USALayer,/Samples/NamedLayers/WorldcapFeatureLayer)。

戻り値

レイヤのメタデータを返します。ラベルレイヤをインラインラベルソースで記述すると、ラベルソースの完全な記述が返されます。ラベルレイヤを名前付きラベルソースで記述すると、名前付きラベルソースへの参照が返されます。

例

入力としてレイヤのリストを含む次のリクエストは、GET 形式または POST 形式のどちらでも作成できます。レスポンスには、リクエストに含まれるレイヤの情報が含まれます。この例では、情報は USALayer (説明、レンダリング可能、テーブルタイプ) に関してのみ返されます。その他のレイヤは存在しなかったので、エラーメッセージが返されます。

POST リクエストの使用:


http://<server>:<port>/rest/Spatial/MappingService/layers.json

{
"namedLayersList":[  
"/Samples/NamedLayers/USALayer",
"/Samples/NamedLayers/NonExistentLayer",
"/Samples/NamedLayers/WorldLabelLayers"]
}

レスポンス:

注: この例のサンプル名前付きラベルソースは、Spectrum™ Technology Platformのバージョン 12.0 の一部として/Samples フォルダに提供されます。11.1 バージョンについては、WebDAV を使ってサンプルを 11.1 パッチの zip ファイルまたは tar ファイルからリポジトリにコピーします。


{
  "layerDescriptions": [
    {
      "name": "/Samples/NamedLayers/USALayer",
      "layer": {
        "type": "FeatureLayer",
        "description": "USA",
        "renderable": true,
        "table": {
          "type": "NamedTable",
          "name": "/Samples/NamedTables/USA"
        },
        "namedLabelSourceRef": "/Samples/NamedLabelSources/StateNameLabelSource"
      }
    },
    {
      "name": "/Samples/NamedLayers/NonExistentLayer",
      "errorMessage": "RepositoryEx_ResourceNotFound: Resource was not found - /Samples/NamedLayers/NonExistentLayer"
    },
    {
      "name": "/Samples/NamedLayers/WorldLabelLayers",
      "layer": {
        "type": "LabelLayer",
        "description": "World Labels Layer",
        "renderable": true,
        "labelSource": [
          {
            "type": "NamedLabelSource",
            "renderable": true,
            "name": "/Samples/NamedLabelSources/WorldCountriesLabelSource"
          }
        ]
      }
    }
  ]
}