Application Data - Get

Reference

Service:: Azure Data Manager for Agriculture

API Version:: 2023-11-01-preview

Get a specified application data resource under a particular party.

GET {endpoint}/parties/{partyId}/application-data/{applicationDataId}?api-version=2023-11-01-preview

URI Parameters

Name	In	Required	Type	Description
applicationDataId	path	True	string	ID of the application data resource.
endpoint	path	True	string uri	The host name of the namespace, e.g. admaInstanceName.farmbeats.azure.net
partyId	path	True	string	ID of the associated party resource.
api-version	query	True	string	The requested API version

Request Header

Name	Required	Type	Description
Authorization	True	string	Please provide a valid bearer token for authorized API calls. Note that you might need to clear your browser cache if you tried un-authenticated calls before.

Responses

Name	Type	Description
200 OK	ApplicationData	Success
Other Status Codes	ErrorResponse	Error Headers x-ms-error-code: string

Name

Type

Description

200 OK

ApplicationData

Success

Other Status Codes

ErrorResponse

Error

Headers

x-ms-error-code: string

Security

Authorization

Please provide a valid bearer token for authorized API calls. Note that you might need to clear your browser cache if you tried un-authenticated calls before.

Type: apiKey
In: header

Examples

ApplicationData_Get

Sample request

HTTP

GET {endpoint}/parties/PARTY123/application-data/APPLICATION123?api-version=2023-11-01-preview

Sample response

Status code:: 200

{
  "partyId": "PARTY123",
  "id": "APPLICATION123",
  "source": "Manual",
  "name": "Application data for North Farm",
  "description": "some description",
  "status": "Active",
  "operationStartDateTime": "2021-02-25T16:57:04Z",
  "operationEndDateTime": "2021-02-27T10:13:06Z",
  "operationModifiedDateTime": "2021-02-28T11:12:12Z",
  "area": {
    "unit": "acre",
    "value": 60
  },
  "totalMaterial": {
    "unit": "kilos",
    "value": 9
  },
  "avgMaterial": {
    "unit": "kilosperacre",
    "value": 0.15
  },
  "applicationProductDetails": [
    {
      "productName": "POTASHVAR1",
      "isCarrier": false,
      "totalMaterial": {
        "unit": "kilos",
        "value": 4
      },
      "avgMaterial": {
        "unit": "kilosperacre",
        "value": 0.2
      }
    }
  ],
  "properties": {
    "Region": "Europe",
    "CountyCode": 123
  },
  "createdDateTime": "2020-12-31T11:10:21Z",
  "modifiedDateTime": "2020-12-31T11:10:21Z",
  "eTag": "cb00a3ac-0000-0100-0000-601d21ec0000"
}

Definitions

Name	Description
ApplicationData	Schema of application data resource.
ApplicationProductDetail	Schema of product used during application.
Error	An error from the Azure AgPlatform service.
ErrorResponse	An error response from the Azure AgPlatform service. See https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses for ErrorResponse reference document.
FarmHierarchyGeoResourceType	Resource Type.
GeoJsonObjectType	GeoJSON object type.
GeoResource	Schema for storing resource type and resource id.
InnerError	Inner error containing list of errors.See https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#innererror--object for InnerError reference document.
Measure	Schema for storing measurement reading and unit.
MultiPolygon	MultiPolygon geometry.
Point	Point geometry.
Polygon	Polygon geometry.

ApplicationData

Schema of application data resource.

Name	Type	Description
applicationProductDetails	ApplicationProductDetail[]	Application product details.
area	Measure	Schema for storing measurement reading and unit.
associatedResource	GeoResource	Schema for storing resource type and resource id.
avgMaterial	Measure	Schema for storing measurement reading and unit.
createdBy	string	Created by user/tenant id.
createdDateTime	string	Date-time when resource was created, sample format: yyyy-MM-ddTHH:mm:ssZ.
description	string	Textual description of the resource.
eTag	string	The ETag value to implement optimistic concurrency.
geometry	GeoJsonObject: MultiPolygon Point Polygon	GeoJSON (For more details: https://geojson.org/). Note: Coordinates are expected in [Longitude, Latitude] format.
id	string	Unique resource ID.
modifiedBy	string	Modified by user/tenant id.
modifiedDateTime	string	Date-time when resource was last modified, sample format: yyyy-MM-ddTHH:mm:ssZ.
name	string	Name to identify resource.
operationEndDateTime	string	End date-time of the operation data, sample format: yyyy-MM-ddTHH:mm:ssZ.
operationModifiedDateTime	string	Modified date-time of the operation data, sample format: yyyy-MM-ddTHH:mm:ssZ. Note: this will be specified by the source provider itself.
operationStartDateTime	string	Start date-time of the operation data, sample format: yyyy-MM-ddTHH:mm:ssZ.
partyId	string	Party ID which belongs to the operation data.
properties		A collection of key value pairs that belongs to the resource. Each pair must not have a key greater than 50 characters and must not have a value greater than 150 characters. Note: A maximum of 25 key value pairs can be provided for a resource and only string, numeral and datetime (yyyy-MM-ddTHH:mm:ssZ) values are supported.
source	string	Source of the resource.
status	string	Status of the resource.
totalMaterial	Measure	Schema for storing measurement reading and unit.

ApplicationProductDetail

Schema of product used during application.

Name	Type	Default value	Description
avgMaterial	Measure		Schema for storing measurement reading and unit.
isCarrier	boolean	False	A flag indicating whether product is a carrier for a tank mix.
productName	string		Name of the product applied.
totalMaterial	Measure		Schema for storing measurement reading and unit.

Error

An error from the Azure AgPlatform service.

Name	Type	Description
code	string	Server-defined set of error codes.
details	Error[]	Array of details about specific errors that led to this reported error.
innererror	InnerError	Inner error containing list of errors.See https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#innererror--object for InnerError reference document.
message	string	Human-readable representation of the error.
target	string	Target of the error.

ErrorResponse

An error response from the Azure AgPlatform service. See https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses for ErrorResponse reference document.

Name	Type	Description
error	Error	An error from the Azure AgPlatform service.
traceId	string	Unique trace Id.

FarmHierarchyGeoResourceType

Resource Type.

Name	Type	Description
ApplicationData	string
Field	string
HarvestData	string
PlantTissueAnalysis	string
PlantingData	string
Prescription	string
SeasonalField	string
TillageData	string
Zone	string

GeoJsonObjectType

GeoJSON object type.

Name	Type	Description
MultiPolygon	string
Point	string
Polygon	string

GeoResource

Schema for storing resource type and resource id.

Name	Type	Description
id	string	Resource Id.
type	FarmHierarchyGeoResourceType	Resource Type.

InnerError

Inner error containing list of errors.See https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#innererror--object for InnerError reference document.

Name	Type	Description
code	string	Specific error code than was provided by the containing error.
innererror	InnerError	Inner error containing list of errors.See https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#innererror--object for InnerError reference document.

Measure

Schema for storing measurement reading and unit.

Name	Type	Description
unit	string	Data unit.
value	number	Data value.

MultiPolygon

MultiPolygon geometry.

Name	Type	Description
coordinates	number[]	Gets or sets Coordinates of GeoJSON Object. It must be an array of polygons, each polygon contains list of linear rings. For Polygons with more than one of these rings, the first MUST be the exterior ring, and any others MUST be interior rings.
type	string: MultiPolygon	GeoJSON object type.

Point

Point geometry.

Name	Type	Description
coordinates	number[]	Gets or sets the coordinate of this point. It must be an array of 2 or 3 elements for a 2D or 3D system.
type	string: Point	GeoJSON object type.

Polygon

Polygon geometry.

Name	Type	Description
coordinates	number[]	Gets or sets type of the GeoJSON Object. It must be an array of linear ring coordinate arrays. For Polygons with more than one of these rings, the first MUST be the exterior ring, and any others MUST be interior rings.
type	string: Polygon	GeoJSON object type.

Share via

Application Data - Get

URI Parameters

Request Header

Responses

Security

Authorization

Examples

ApplicationData_Get

Sample request

Sample response

Definitions

ApplicationData

ApplicationProductDetail

Error

ErrorResponse

FarmHierarchyGeoResourceType

GeoJsonObjectType

GeoResource

InnerError

Measure

MultiPolygon

Point

Polygon

Additional resources