Batch

Bulk-create plots.

post

Create multiple plots that share the same commodities. The plots will be owned by your business.

Authorizations

Body

commoditiesstring · enum[]Required

What crops (among the relevant commodities) are grown on these fields (currently).

Example: ["oil palm","rubber"]

filenamestringOptional

Filename used to upload Plots in batch.

geometriesobjectRequired

The geometries of the Plots as key-value pairs. Each value should be a geometry. Each key is used to identify the geometry/plot in the response and stored as name of the plot

Example: {"plot1":{"type":"Polygon","coordinates":[[[30,10],[40,40],[20,40],[10,20],[30,10]]]},"plot2":{"type":"MultiPolygon","coordinates":[[[[30,20],[45,40],[10,40],[30,20]]],[[[15,5],[40,10],[10,20],[5,10],[15,5]]]]}}

Responses

application/json

objectOptional

post

HTTPcURLJavaScriptPython

POST /plots/batch HTTP/1.1
Host: api.tradeaware.live-eo.com
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 280

{
  "commodities": [
    "oil palm",
    "rubber"
  ],
  "filename": "text",
  "geometries": {
    "plot1": {
      "type": "Polygon",
      "coordinates": [
        [
          [
            30,
            10
          ],
          [
            40,
            40
          ],
          [
            20,
            40
          ],
          [
            10,
            20
          ],
          [
            30,
            10
          ]
        ]
      ]
    },
    "plot2": {
      "type": "MultiPolygon",
      "coordinates": [
        [
          [
            [
              30,
              20
            ],
            [
              45,
              40
            ],
            [
              10,
              40
            ],
            [
              30,
              20
            ]
          ]
        ],
        [
          [
            [
              15,
              5
            ],
            [
              40,
              10
            ],
            [
              10,
              20
            ],
            [
              5,
              10
            ],
            [
              15,
              5
            ]
          ]
        ]
      ]
    }
  }
}

{
  "status": "PARTIAL_FAILURE",
  "errors": {
    "some_index_0": "some detailed error"
  },
  "processed": {
    "some_index_0": "/plots/123"
  }
}