テーブルへのフィーチャーの挿入

説明

1 つ以上のレコードをテーブルに挿入します。リクエスト本体にはフィーチャー コレクションの JSON 表現が含まれますが、一部の要素は指定する必要がありません。それぞれのフィーチャーには、0 個以上の列の値が含まれます。列を 1 つも指定しない場合、null 値が挿入されます。データベースで処理されない値を持つプライマリ キーの一部である場合には、(自動インクリメントの制約またはシーケンスによって) 列の値を指定する必要があります。プライマリ キーを判断するには、describeTable レスポンスのキー定義を調べます。レスポンスには、正しく挿入されたフィーチャーのプライマリ キーが含まれます。

本体の JSON 表現は GeoJSON 形式です。GeoJSON の詳細については、geojson.org/geojson-spec.html を参照してください。

HTTP POST URL 形式

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

HTTP POST:  /tables/tablename/features.rep?
POST Data: action=insert&[commitInterval=c]
POST BODY: Content-Type:application/json {table insert}
			

table insert は、挿入する 1 つ以上のフィーチャを含むテーブル挿入の POST json 本体 (Content-Type: application/json) です。

パラメータ

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

.../FeatureService/tables/Samples/​NamedTables
/WorldTable/features.json;... 

戻り値

テーブルに追加された各フィーチャーのプライマリ キーを返します。ネイティブおよび NativeX TAB ファイルでは、正常に挿入された行の数を示す SuccessfulInserts 応答が代わりに返されます。

例

2 つの新しいフィーチャーを MyTable に追加します。フィーチャーはそれぞれ、ジオメトリ列にポイント、Column1 に 456 と 123 の値、Column2 に "four five six" と "one two three" の値を含みます。

http://www.pbbi.com/rest/Spatial/FeatureService/tables/MyTable/features.json
?action=insert&commitInterval=1
{
    "type": "FeatureCollection",
    "features": [
    {
        "type": "Feature",
        "geometry": {
            "type": "Point",
            "coordinates": [-73, 41]
        },
        "properties": {
            "Column1": 456,
			"Column2": "four five six"
        }
    },
    {
        "type": "Feature",
        "geometry": {
            "type": "Point",
            "coordinates": [-72, 42]
        },
        "properties": {
            "Column1": 123,
			"Column2": "one two three"
        }
    }]
}