ID によるフィーチャの検索
説明
ID によって定義されている、リポジトリ内の名前付きテーブルのフィーチャを返します。デフォルトでは、すべての情報がレスポンスに含まれます。フィーチャのサブセットを取得するには、属性を指定します。
この操作は、Mapping Service におけるマップのレンダリングや凡例のレンダリングのリクエストに引き渡すことのできる、フィーチャ コレクション JSON を返します。
HTTP GET URL 形式
HTTP GET リクエストには次の形式を使用します。
HTTP GET /tables/tablename/features.rep;[attributes=attname]/key?destinationSrs
パラメータ
以下のパラメータのタイプについては、リクエスト URL のデータ タイプを参照してください。
| パラメータ | タイプ | 必須 | 説明 |
|---|---|---|---|
| tablename | String | はい | フィーチャを取得するテーブルの名前。テーブルは、リポジトリ内の名前付きテーブルの場所に基づいて、レンダリングする名前付きテーブルの Regex で指定します。名前付きテーブルの名前は、URL の /tables 部と URL の /features.rep 部の間で定義します。例えば、リポジトリ内の /Samples/NamedTables/WorldTable にある名前付きテーブルのフィーチャを返すには、次のような URL を使用します。 .../FeatureService/tables/Samples/NamedTables /WorldTable/features.json;... |
| rep | String | はい | 戻り値の表現。サポートされている表現は json です。 |
| attributes=attname | String | いいえ | レスポンスで返されるフィーチャの属性名。デフォルトでは、すべての属性が返されます。複数の属性は、カンマで区切られたリストで指定します。この方法を使うと、レスポンス内の情報量を、リクエストする情報のみに簡単に限定できます。その結果、フィーチャ コレクション内の各フィーチャには、指定した属性のみが含まれます。例えば、テーブルに 4 つの属性が含まれていてもレスポンスに必要な属性は 2 つのみである場合、ここでその 2 つの属性の名前を (カンマで区切って) 指定すると、それ以外の 2 つの属性の値は返されません。 |
| destinationSrs | String | いいえ | 結果のジオメトリを返す座標系。デフォルトは、使用するデータの座標系 (例えば、epsg:4326) です。 |
| key | String | はい | 返されるフィーチャの ID。これには、テーブル内のフィーチャの ID (.tab ファイルの場合) またはプライマリ キー (dbms の場合) を指定します。 |
戻り値
リポジトリ内の名前付きテーブルの指定されたフィーチャを返します。
{
"type":"FeatureCollection","Metadata":[{"type":"String","name":"Country"},
{"type":"String","name":"Capital"},{"type":"String","name":"Continent"}],
"features":[{"type":"Feature","id":"43","properties":{"Country":"China","Capital":"Beijing","Continent":"Asia"}}]
}
例
リポジトリ内の /Samples/NamedTables ディレクトリにあるテーブル WorldTable から、レコード ID=43 (中国) のすべてのフィーチャを返します。
http://www.pbbi.com/rest/Spatial/FeatureService/tables/Samples/NamedTables/WorldTable/features.json/43?destinationSrs=epsg:3857
リポジトリ内の /Samples/NamedTables ディレクトリにあるテーブル WorldTable から、レコード ID=43 (中国) のフィーチャのサブセット (Country、Capital、および Continent) を、英語 (米国) ロケールで返します。
http://www.pbbi.com/rest/Spatial/FeatureService/tables/Samples/NamedTables/WorldTable/features.json;attributes=Country,Capital,Continent/43