Agricultural Understanding API Version v1: Error Catalog

Provide agricultural data such as landscape type, crop type, and harvest dates at field level.

Service: agriculturalunderstanding.googleapis.com

When facing errors, refer to this catalog alongside using our client libraries. If you're using your own libraries, keep this guide handy for debugging and error resolution. To know more about the error response structure, visit the error overview page.

Error codes

The following table lists HTTP status codes and associated errors that you might encounter when interacting with our API. Each status code corresponds to one or more reasons and descriptions to help you troubleshoot and handle errors effectively in your application. Within the descriptions, variables denoted by curly braces ({}) represent placeholders for values that are specific to your request.

Reason HTTP Status Code Description
LOCATION_SPECIFIER_MISSING 400 The location specifier is missing. Specify a location in the request.
LOCATION_SPECIFIER_INVALID 400 The location specifier is invalid. Specify either coordinates or an S2 cell ID.
S2_CELL_ID_UNPARSEABLE 400 The S2 cell ID {s2_cell_id} cannot be parsed. Ensure it is a valid 64-bit unsigned integer string.
S2_CELL_ID_INVALID 400 The S2 cell ID {s2_cell_id} is invalid. Verify the ID.
S2_CELL_ID_INVALID_LEVEL 400 The S2 cell ID {s2_cell_id} is at level {level}. Only level 13 S2 cells are supported.
CROP_DATA_NOT_FOUND 404 No crop data was found for the S2 cell {s2_cell_id}.
LANDSCAPE_DATA_NOT_FOUND 404 No landscape data was found for the S2 cell {s2_cell_id}.
CAPTURE_DATES_NOT_FOUND 404 No capture dates were found for the S2 cell {s2_cell_id}.
MONITORED_LANDSCAPE_DATA_NOT_FOUND 404 No monitored landscape data was found for the S2 cell {s2_cell_id}.