Batch

Bulk-create plots.

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

post

/plots/batch

Authorizations

Body

commoditiesstring · enum[]required

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

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

filenamestring

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

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://api.tradeaware.live-eo.com/plots/batch' \
  --header 'Authorization: Bearer JWT' \
  --header 'Content-Type: application/json' \
  --data '{
    "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
              ]
            ]
          ]
        ]
      }
    }
  }'

201

401

403

201

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