field

Retrieve a field.

Arguments

sentera_id (ID!)

The Sentera ID of the Field being retrieved

Return fields

acres (Float!)
Deprecation notice

Support added for retrieving area in metric units. Please use area instead.

The acres of the boundary of the field.

action (UpsertActionType!)

Determines if it was a create or update.

active (Boolean!)

Indicator of whether or not this field is currently active.

address (String)

Field address.

alerts (AlertsQueryResult!)

A list of alerts associated with this field.

Argument Type Description
apply_user_preferences_filter Boolean

Filter the alerts according to a user's notification delivery preferences.
pagination Pagination

Paginate the results.
status AlertStatusType

Filter the alerts by status.
area (Area!)

The area of the boundary of the field in the specified unit system.

Argument Type Description
unit AreaUnitType

The unit in which a client would like the area.
unit_system UnitSystem

The unit system in which a client would like the area. Defaults to IMPERIAL if not provided.
bbox ([Float!]!)

A simple (w, s, e, n) box that represents the extreme coordinates of the field's boundary.

boundary (GeoJSON!)

A GeoJson FeatureCollection that includes a MultiPolygon representing the field boundary.

city (String)

Field city.

content_hash (String!)

The current content hash for this item.

country_code (String)

Field country code (ISO 3166-1).

county (String)

Field county.

created_at (ISO8601DateTime!)

The timestamp of when the item was created in the system.

created_by (User!)

The user who created this item.

crop_season_years ([Int!]!)

The years that crop seasons were planted on this field.

crop_seasons ([CropSeason!]!)

A list of crop seasons associated with this field.

Argument Type Description
active Boolean

Limit crop seasons based on if they are active or not.
crop_type CropType

Limit crop seasons by crop type.
distance_from_origin (Float)

The distance in miles from an origin geo-position of this field. Only available when using the haversine radius query input; null otherwise.

external_connection (ExternalCredential)
Deprecation notice

Please use the external_id and external_partner fields.

The external connection that this field is linked to.

external_id (String)

The id of the field in the external partner's system.

external_partner (ExternalPartner)

The external partner the field was imported from.

farm (String)

Field farm name

feature_sets (FeatureSetsQueryResult!)

A list of feature sets for this field.

Argument Type Description
order_by FeatureSetSortingAttributes

Order the results by a specific attribute.
order_by_direction SortDirection

Direction (ascending or descending) of the ordered results.
pagination Pagination

Paginate the results.
type FeatureSetType

Filter the results by feature set type.
field_boundary ([GeoPosition]!)
Deprecation notice

Please use the boundary GeoJSON field.

A closed collection of geo-positions representing the field boundary.

files (FilesQueryResult!)

A list of files associated with this field.

Argument Type Description
date_range DateRange

Filter the results by a date range.
order_by FileSortingAttributes

Order the results by a specific attribute.
order_by_direction SortDirection

Direction (ascending or descending) of the ordered results.
pagination Pagination

Paginate the results.
grower (String)

Field grower name.

latitude (Float!)

The latitude value for the center of the field.

longitude (Float!)

The longitude value for the center of the field.

name (String!)

Field name.

organization (Organization!)

The organization associated with this field.

owner_type (FeatureSetOwnerType!)

Type of the feature set owner

sentera_id (ID!)

ID of the feature set owner

shapes (ShapesQueryResult!)

A list of shapes associated with this field.

Argument Type Description
date_range DateRange

Filter the results by date range
order_by ShapeSortingAttributes

Order the results by a specific attribute.
order_by_direction SortDirection

Direction (ascending or descending) of the ordered results.
pagination Pagination

Paginate the results.
shared (Boolean!)

Indicates if this field has been shared from another account.

state (String)

Field state/province/region code (ISO 3166-2).

surveys (SurveysQueryResult!)

A list of surveys associated with this field..

Argument Type Description
date_range DateRange

Filter the results by date range.
order_by SurveySortingAttributes

Order the results by a specific attribute.
order_by_direction SortDirection

Direction (ascending or descending) of the ordered results.
organization_sentera_id ID

List surveys for this organization.
pagination Pagination

Paginate the results.
tasks (TasksQueryResult!)

A list of tasks associated with this field.

Argument Type Description
assigned_to ID

Filter tasks by the "assigned to" user. Specify null to retrieve unassigned tasks.
created_by ID

Filter tasks by the user that created them. Can be used to list tasks you created.
pagination Pagination!

Paginate the results.
status TaskStatus

Filter tasks by status.
statuses [TaskStatus!]

Filter tasks by one or more statuses.
task_type TaskType

Filter tasks by their type.
time_zone (String!)

The time zone of the field. Zone names are from the "TZ database name" column from https://en.wikipedia.org/wiki/List_of_tz_database_time_zones#List.

updated_at (ISO8601DateTime!)

The timestamp of when the item was last updated in the system.

updated_by (User)

The user who last updated this item.

years_planted ([Int!]!)

The years that this field was planted.

zip_code (String)

Field zip code.

Examples

Field

Retrieve a field

Try this example in GraphiQL 
query FieldBySenteraID{
  field(sentera_id: "zx0tsts_AS_SHORT1_CV_test_1ba88e5_170907_220547") {
  sentera_id
  name
  latitude
  longitude
  }
}

{
  "data": {
  "field": {
    "sentera_id": "zx0tsts_AS_SHORT1_CV_test_1ba88e5_170907_220547",
    "name": "Field 5524",
    "latitude": 45.0,
    "longitude": -93.4
  }
  }
}

Field with Surveys and Files

Retrieve a field and its surveys and files

Try this example in GraphiQL 
query FieldBySenteraIDWithSurveysAndFiles{
  field(sentera_id: "zx0tsts_AS_SHORT1_CV_test_1ba88e5_170907_220547") {
  sentera_id
  name
  latitude
  longitude
  files(pagination: {page_size: 10, page: 1}, order_by: FILENAME, order_by_direction: ASCENDING) {
    total_count
    page
    page_size
    results {
      sentera_id
    }
  }
  surveys(pagination: {page_size: 10, page: 1}, order_by: START_TIME, order_by_direction: DESCENDING) {
    total_count
    page
    page_size
    results {
      sentera_id
      start_time
      end_time
    }
  }
  }
}

{
  "data": {
  "field": {
    "sentera_id": "zx0tsts_AS_SHORT1_CV_test_1ba88e5_170907_220547",
    "name": "Field 5524",
    "latitude": 45.0,
    "longitude": -93.4,
    "files": {
      "total_count": 467,
      "page": 1,
      "page_size": 10,
      "results": [
        {
          "sentera_id": "itqkn28_FI_SHORT1_CV_test_dc0d87d_170907_235328"
        }
      ]
    },
    "surveys": {
      "total_count": 4,
      "page": 1,
      "page_size": 10,
      "results": [
        {
          "sentera_id": "itqkn28_CO_SHORT1_CV_test_dc0d87d_170907_235328",
          "start_time": "2017-09-03T16:25:32Z",
          "end_time": "2017-09-03T16:45:32Z"
        }
      ]
    }
  }
  }
}

Field with Surveys Constrained by Date Range

Retrieve a field and its surveys, containing the surveys by a date range

Try this example in GraphiQL 
query FieldBySenteraIDWithSurveysConstrainedByDateRange{
  field(sentera_id: "zx0tsts_AS_SHORT1_CV_test_1ba88e5_170907_220547") {
  sentera_id
  name
  latitude
  longitude
  surveys(
    date_range: {
      date_attribute_name: "start_time"
      start_timestamp: "2016-08-20T04:53:28Z"
      end_timestamp: "2016-08-30T04:53:28Z"}
  ){
    total_count
    results {
      sentera_id
      start_time
      end_time
    }
  }
  }
}

{
  "data": {
  "field": {
    "sentera_id": "zx0tsts_AS_SHORT1_CV_test_1ba88e5_170907_220547",
    "name": "Field 5524",
    "latitude": 45.0,
    "longitude": -93.4,
    "surveys": {
      "total_count": 6,
      "results": [
        {
          "sentera_id": "vbiul43_CO_SHORT1_CV_test_dc0d87d_170824_235328",
          "start_time": "2017-08-24T16:25:32Z",
          "end_time": "2017-08-24T17:11:24Z"
        }
      ]
    }
  }
  }
}

Field with Alerts

Retrieve a field and its alerts

Try this example in GraphiQL 
query FieldBySenteraIDWithAlerts{
  field(sentera_id: "zx0tsts_AS_SHORT1_CV_test_1ba88e5_170907_220547") {
  sentera_id
  name
  latitude
  longitude
  alerts(pagination: {page_size: 10, page: 1}) {
    total_count
    page
    page_size
    results {
      sentera_id
      name
      message
      status
      key
    }
  }
  }
}

{
  "data": {
  "field": {
    "sentera_id": "zx0tsts_AS_SHORT1_CV_test_1ba88e5_170907_220547",
    "name": "Field 5524",
    "latitude": 45.0,
    "longitude": -93.4,
    "alerts": {
      "total_count": 5,
      "page": 1,
      "page_size": 10,
      "results": [
        {
          "sentera_id": "itqkn28_AL_SHORT1_CV_test_dc0d87d_170907_235328",
          "name": "Southern Corn Rust Alert",
          "message": "Current weather conditions indicate that this field is susceptible to southern corn rust.",
          "status": "OPEN",
          "key": "disease"
        }
      ]
    }
  }
  }
}

Field with Alerts filtered by a user's notification preferences

Retrieve a field and its alerts filtered by persisted notification delivery preferences. In this example the caller has chosen not to see disease alerts.

Try this example in GraphiQL 
query FieldBySenteraIDWithAlerts{
  field(sentera_id: "zx0tsts_AS_SHORT1_CV_test_1ba88e5_170907_220547") {
  sentera_id
  name
  latitude
  longitude
  alerts(pagination: {page_size: 10, page: 1}, apply_user_preferences_filter: true) {
    total_count
    page
    page_size
    results {
      sentera_id
      name
      message
      status
      key
    }
  }
  }
}

{
  "data": {
  "field": {
    "sentera_id": "zx0tsts_AS_SHORT1_CV_test_1ba88e5_170907_220547",
    "name": "Field 5524",
    "latitude": 45.0,
    "longitude": -93.4,
    "alerts": {
      "total_count": 5,
      "page": 1,
      "page_size": 10,
      "results": [
        {
          "sentera_id": "itqkn28_AL_SHORT1_CV_test_dc0d87d_170907_235328",
          "name": "Southern Corn Rust Alert",
          "message": "Current weather conditions indicate that this field is susceptible to southern corn rust.",
          "status": "OPEN",
          "key": "disease"
        }
      ]
    }
  }
  }
}

Field with Shapes

Retrieve a field and its shapes

Try this example in GraphiQL 
query FieldBySenteraIDWithAlerts{
  field(sentera_id: "zx0tsts_AS_SHORT1_CV_test_1ba88e5_170907_220547") {
  sentera_id
  name
  latitude
  longitude
  shapes {
    results {
      name
      color
      reference_date
      geometry
    }
  }
  }
}

{
  "data": {
  "field": {
    "sentera_id": "zx0tsts_AS_SHORT1_CV_test_1ba88e5_170907_220547",
    "name": "Field 5524",
    "latitude": 45.0,
    "longitude": -93.4,
    "shapes": {
      "total_count": 1,
      "page": 1,
      "page_size": 10,
      "results": [
        {
          "name": "Test Shape",
          "color": "#ff40ff",
          "reference_date": "2019-07-14",
          "geometry": {
            "type": "FeatureCollection",
            "features": [
              {
                "type": "Feature",
                "geometry": {
                  "type": "GeometryCollection",
                  "geometries": [
                    {
                      "type": "Polygon",
                      "coordinates": [
                        [
                          [
                            -93,
                            45
                          ],
                          [
                            -93.1,
                            45.1
                          ],
                          [
                            -93.2,
                            45.2
                          ],
                          [
                            -93,
                            45
                          ]
                        ]
                      ]
                    }
                  ]
                },
                "properties": {}
              }
            ]
          }
        }
      ]
    }
  }
  }
}

Field with Crop Seasons and Field Activities

Retrieve a field, its seasons and activities.

Try this example in GraphiQL 
query FieldBySenteraIDWithFieldActivities{
  field(sentera_id: "zx0tsts_AS_SHORT1_CV_test_1ba88e5_170907_220547") {
  sentera_id
  name
  latitude
  longitude
  crop_seasons {
    sentera_id
    name
    crop_type
    started_at
    ended_at
    field_activities {
      sentera_id
      __typename
      product_name
      ... on IrrigateActivity {
        application_rate {
          value
          unit
        }
      }
      application_area {
        value
        unit
      }
      applied_at
    }
  }
  }
}

{
  "data": {
  "field": {
    "sentera_id": "zx0tsts_AS_SHORT1_CV_test_1ba88e5_170907_220547",
    "name": "Field 5524",
    "latitude": 45.0,
    "longitude": -93.4,
    "crop_seasons": [
      {
        "sentera_id": "mhf5wfk_CS_SHORT2_CV_test_69b92f355_200203_165314",
        "name": "2019",
        "crop_type": "CORN",
        "started_at": "2019-05-03T16:55:34Z",
        "ended_at": null,
        "field_activities": [
          {
            "sentera_id": "aa4txk2_FA_SHORT2_CV_test_69b92f355_200203_165314",
            "__typename": "PlantActivity",
            "product_name": null,
            "application_area": {
              "value": 20.0,
              "unit": "ACRE"
            },
            "applied_at": "2019-05-03T16:55:34Z"
          },
          {
            "sentera_id": "az4txr4_FA_SHORT2_CV_test_69b92f355_200204_165314",
            "__typename": "IrrigateActivity",
            "product_name": null,
            "application_rate": {
              "value": 50.0,
              "unit": "GALLONS_PER_ACRE"
            },
            "application_area": {
              "value": 20.0,
              "unit": "ACRE"
            },
            "applied_at": "2019-05-04T16:55:34Z"
          }
        ]
      }
    ]
  }
  }
}

Field with Crop Seasons Years

Retrieve a field and its crop season years

Try this example in GraphiQL 
query FieldBySenteraIDWithFieldActivities{
  field(sentera_id: "zx0tsts_AS_SHORT1_CV_test_1ba88e5_170907_220547") {
  sentera_id
  name
  latitude
  longitude
  crop_season_years
  }
}

{
  "data": {
  "field": {
    "sentera_id": "zx0tsts_AS_SHORT1_CV_test_1ba88e5_170907_220547",
    "name": "Field 5524",
    "latitude": 45.0,
    "longitude": -93.4,
    "crop_season_years": [
      2019
    ]
  }
  }
}

Field with filtered Crop Seasons and Field Activities

Retrieve a field, its seasons and activities with the ability to filter seasons by crop type and activities by activity type.

Try this example in GraphiQL 
query FieldBySenteraIDWithFieldActivities{
  field(sentera_id: "zx0tsts_AS_SHORT1_CV_test_1ba88e5_170907_220547") {
  sentera_id
  name
  latitude
  longitude
  crop_seasons(crop_type: CORN) {
    sentera_id
    name
    crop_type
    started_at
    ended_at
    field_activities(activity_type: KERNEL_COUNT) {
      sentera_id
      __typename
      application_area(unit_system: METRIC) {
        value
        unit
      }
      ... on KernelCountActivity {
        kernel_counts {
          longitude
          latitude
        }
      }
    }
  }
  }
}

{
  "data": {
  "field": {
    "sentera_id": "zx0tsts_AS_SHORT1_CV_test_1ba88e5_170907_220547",
    "name": "Field 5524",
    "latitude": 45.0,
    "longitude": -93.4,
    "crop_seasons": [
      {
        "sentera_id": "mhf5wfk_CS_SHORT2_CV_test_69b92f355_200203_165314",
        "name": "2019",
        "crop_type": "CORN",
        "started_at": "2019-05-03T16:55:34Z",
        "ended_at": null,
        "field_activities": [
          {
            "sentera_id": "aa4txk2_FA_SHORT2_CV_test_69b92f355_200203_165315",
            "__typename": "KernelCountActivity",
            "application_area": {
              "value": 2.02343,
              "unit": "HECTARE"
            },
            "kernel_counts": [
              {
                "longitude": 18.02,
                "latitude": 45.002,
                "ears": [
                  {
                    "rows": 5,
                    "kernels_per_row": 20
                  }
                ]
              }
            ]
          }
        ]
      }
    ]
  }
  }
}

Feature Sets for a field

Retrieve feature sets for a field. These will usually be flight plans.

Try this example in GraphiQL 
query FieldWithFeatureSets {
  field(sentera_id: "xo0ajeg_AS_SHORT1_CV_test_946a0e3e4_201102_102847") {
  feature_sets {
    total_count
    results {
      sentera_id
      type
    }
  }
  }
}

{
  "data": {
  "field": {
    "feature_sets": {
      "total_count": 1,
      "results": [
        {
          "sentera_id": "bcdnct8_FS_SHORT1_CV_test_946a0e3e4_201102_102644",
          "type": "UNKNOWN"
        }
      ]
    }
  }
  }
}