Megosztás a következőn keresztül:


Harvest Data - List

A betakarítási adaterőforrások lapszámozott listáját adja vissza az összes fél számára.

GET /harvest-data?api-version=2023-06-01-preview
GET /harvest-data?minTotalYield={minTotalYield}&maxTotalYield={maxTotalYield}&minAvgYield={minAvgYield}&maxAvgYield={maxAvgYield}&minTotalWetMass={minTotalWetMass}&maxTotalWetMass={maxTotalWetMass}&minAvgWetMass={minAvgWetMass}&maxAvgWetMass={maxAvgWetMass}&minAvgMoisture={minAvgMoisture}&maxAvgMoisture={maxAvgMoisture}&minAvgSpeed={minAvgSpeed}&maxAvgSpeed={maxAvgSpeed}&sources={sources}&associatedBoundaryIds={associatedBoundaryIds}&minOperationStartDateTime={minOperationStartDateTime}&maxOperationStartDateTime={maxOperationStartDateTime}&minOperationEndDateTime={minOperationEndDateTime}&maxOperationEndDateTime={maxOperationEndDateTime}&minOperationModifiedDateTime={minOperationModifiedDateTime}&maxOperationModifiedDateTime={maxOperationModifiedDateTime}&minArea={minArea}&maxArea={maxArea}&ids={ids}&names={names}&propertyFilters={propertyFilters}&statuses={statuses}&minCreatedDateTime={minCreatedDateTime}&maxCreatedDateTime={maxCreatedDateTime}&minLastModifiedDateTime={minLastModifiedDateTime}&maxLastModifiedDateTime={maxLastModifiedDateTime}&maxPageSize={maxPageSize}&skipToken={skipToken}&api-version=2023-06-01-preview

URI-paraméterek

Name In Kötelező Típus Description
api-version
query True

string

A kért API-verzió

associatedBoundaryIds
query

string[]

A műveleti adatokhoz társított határazonosítók.

ids
query

string[]

Az erőforrás azonosítói.

maxArea
query

number

double

Maximális terület, amelyre a műveletet alkalmazták (beleértve).

maxAvgMoisture
query

number

double

Maximális AvgMoisture érték (beleértve).

maxAvgSpeed
query

number

double

Maximális AvgSpeed érték (beleértve).

maxAvgWetMass
query

number

double

Maximális AvgWetMass érték (beleértve).

maxAvgYield
query

number

double

Maximális AvgYield érték (beleértve).

maxCreatedDateTime
query

string

date-time

Az erőforrás létrehozásának maximális dátuma (beleértve a következőt is):

maxLastModifiedDateTime
query

string

date-time

Az erőforrás utolsó módosításának maximális dátuma (beleértve a következőt: ).

maxOperationEndDateTime
query

string

date-time

A műveleti adatok maximális befejezési dátuma, mintaformátum: yyyy-MM-ddTHH:mm:ssZ (beleértve).

maxOperationModifiedDateTime
query

string

date-time

A műveleti adatok maximális módosított dátum-ideje, mintaformátum: yyyy-MM-ddTHH:mm:ssZ (beleértve).

maxOperationStartDateTime
query

string

date-time

A műveleti adatok maximális kezdési dátumának időpontja, mintaformátum: éé-MM-ddTHH:mm:ssZ (beleértve).

maxPageSize
query

integer

int32

A szükséges elemek maximális száma (beleértve a elemet). Minimum = 10, Maximum = 1000, Alapértelmezett érték = 50.

maxTotalWetMass
query

number

double

Maximális teljes wetMass érték (beleértve).

maxTotalYield
query

number

double

Maximális hozamérték (beleértve a értéket).

minArea
query

number

double

Minimális terület, amelyre a műveletet alkalmazták (beleértve).

minAvgMoisture
query

number

double

Minimális AvgMoisture érték (beleértve).

minAvgSpeed
query

number

double

Minimális AvgSpeed érték (beleértve).

minAvgWetMass
query

number

double

Minimális AvgWetMass érték (beleértve).

minAvgYield
query

number

double

Minimális AvgYield érték (beleértve).

minCreatedDateTime
query

string

date-time

Az erőforrás minimális létrehozási dátuma (beleértve az erőforrást is).

minLastModifiedDateTime
query

string

date-time

Az erőforrás utolsó módosításának minimális dátuma (beleértve az erőforrást is).

minOperationEndDateTime
query

string

date-time

A műveleti adatok minimális záródátum-ideje, mintaformátum: éé-MM-ddTHH:mm:ssZ (beleértve).

minOperationModifiedDateTime
query

string

date-time

A műveleti adatok minimális módosított dátum-ideje, mintaformátum: yyyy-MM-ddTHH:mm:ssZ (beleértve).

minOperationStartDateTime
query

string

date-time

A műveleti adatok minimális kezdési dátuma, mintaformátum: yyyy-MM-ddTHH:mm:ssZ (beleértve).

minTotalWetMass
query

number

double

Minimális összes wetMass érték (beleértve).

minTotalYield
query

number

double

Minimális hozamérték (beleértve a értéket).

names
query

string[]

Az erőforrás nevei.

propertyFilters
query

string[]

A Tulajdonságok objektumon belüli kulcs-érték párok szűrői. például: "{testKey} eq {testValue}".

skipToken
query

string

A következő eredményhalmaz lekéréséhez hagyja ki a tokent.

sources
query

string[]

A műveleti adatok forrásai.

statuses
query

string[]

Az erőforrás állapotai.

Kérelem fejléce

Name Kötelező Típus Description
Authorization True

string

Adjon meg érvényes tulajdonosi jogkivonatot az engedélyezett API-hívásokhoz. Vegye figyelembe, hogy előfordulhat, hogy törölnie kell a böngésző gyorsítótárát, ha korábban nem hitelesített hívásokat próbált meg.

Válaszok

Name Típus Description
200 OK

HarvestDataListResponse

Success

Other Status Codes

ErrorResponse

Hiba

Fejlécek

x-ms-error-code: string

Biztonság

Authorization

Adjon meg érvényes tulajdonosi jogkivonatot az engedélyezett API-hívásokhoz. Vegye figyelembe, hogy előfordulhat, hogy törölnie kell a böngésző gyorsítótárát, ha korábban nem hitelesített hívásokat próbált meg.

Típus: apiKey
In: header

Példák

HarvestData_List

Mintakérelem

GET /harvest-data?api-version=2023-06-01-preview

Mintaválasz

{
  "value": [
    {
      "partyId": "PARTY123",
      "id": "HARVESTOP123",
      "source": "Manual",
      "name": "Harvest data for North Farm",
      "description": "some description",
      "status": "Active",
      "operationStartDateTime": "2021-04-21T06:49:30Z",
      "operationEndDateTime": "2021-04-21T06:49:30Z",
      "operationModifiedDateTime": "2021-04-21T06:49:30Z",
      "associatedBoundaryId": "NORTHFARM2021CORNBOUNDARY",
      "area": {
        "unit": "acre",
        "value": 50
      },
      "totalYield": {
        "unit": "kilos",
        "value": 1400
      },
      "avgYield": {
        "unit": "kilosperacre",
        "value": 28
      },
      "totalWetMass": {
        "unit": "kilos",
        "value": 500
      },
      "avgWetMass": {
        "unit": "kilosperacre",
        "value": 10
      },
      "avgMoisture": {
        "unit": "percent",
        "value": 14.61
      },
      "avgSpeed": {
        "unit": "kmsperhour",
        "value": 7.2
      },
      "harvestProductDetails": [
        {
          "productName": "VAR1",
          "area": {
            "unit": "acre",
            "value": 30
          },
          "totalYield": {
            "unit": "kilos",
            "value": 900
          },
          "avgYield": {
            "unit": "kilosperacre",
            "value": 30
          },
          "totalWetMass": {
            "unit": "kilos",
            "value": 300
          },
          "avgWetMass": {
            "unit": "kilosperacre",
            "value": 10
          },
          "avgMoisture": {
            "unit": "percent",
            "value": 16.4
          }
        }
      ],
      "properties": {
        "Region": "Europe",
        "CountyCode": 123
      },
      "attachmentsLink": "https://<resource-name>.farmbeats.azure.net/party/{{partyId}}/attachments?api-version={{apiVersion}}&resourceIds={{harvestDataId}}&resourceTypes=HarvestData",
      "createdDateTime": "2021-04-21T06:49:30Z",
      "modifiedDateTime": "2021-04-21T06:49:30Z",
      "eTag": "cb00a3ac-0000-0100-0000-601d21ec0000"
    }
  ],
  "skipToken": "string",
  "nextLink": "https:/{{resourceName}}.farmbeats.azure.net/parties/{{partyId}}/harvestData?api-version={{apiVersion}}&skipToken=%5b%7b%22token%22%3a%22%2bRID%3a%7ehK8eAKzdo1MNnwcAAAAAAA%3d%3d%23RT%3a1%23TRC%3a10%23ISV%3a2%23IEO%3a65551%23FPC%3aAQ2fBwAAAAAAD58HAAAAAAA%3d%22%2c%22range%22%3a%7b%22min%22%3a%22%22%2c%22max%22%3a%22FF%22%7d%7d%5d"
}

Definíciók

Name Description
Error

Az Azure AgPlatform szolgáltatás hibája.

ErrorResponse

Hibaválasz az Azure AgPlatform szolgáltatástól. Lásd https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses : ErrorResponse referenciadokumentum.

HarvestData

A betakarítási adaterőforrás sémája.

HarvestDataListResponse

A lapozott válasz tartalmazza a kért objektumok listáját és egy URL-hivatkozást a következő eredményhalmaz lekéréséhez.

HarvestProductDetail

A betakarítás során használt termék sémája.

InnerError

Belső hiba, amely a hibák listáját tartalmazza. Lásd https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#innererror--object : InnerError referenciadokumentum.

Measure

A mérési olvasás és egység tárolásának sémája.

Error

Az Azure AgPlatform szolgáltatás hibája.

Name Típus Description
code

string

Kiszolgáló által definiált hibakódok.

details

Error[]

A jelentett hibához vezető konkrét hibák részleteinek tömbje.

innererror

InnerError

Belső hiba, amely a hibák listáját tartalmazza. Lásd https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#innererror--object : InnerError referenciadokumentum.

message

string

A hiba emberi olvasásra alkalmas ábrázolása.

target

string

A hiba célja.

ErrorResponse

Hibaválasz az Azure AgPlatform szolgáltatástól. Lásd https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses : ErrorResponse referenciadokumentum.

Name Típus Description
error

Error

Az Azure AgPlatform szolgáltatás hibája.

traceId

string

Egyedi nyomkövetési azonosító.

HarvestData

A betakarítási adaterőforrás sémája.

Name Típus Description
area

Measure

A mérési olvasás és egység tárolásának sémája.

associatedBoundaryId

string

Annak a mezőnek a határazonosítója, amelyre a műveletet alkalmazták.

attachmentsLink

string

Mellékletek hivatkozása.

avgMoisture

Measure

A mérési olvasás és egység tárolásának sémája.

avgSpeed

Measure

A mérési olvasás és egység tárolásának sémája.

avgWetMass

Measure

A mérési olvasás és egység tárolásának sémája.

avgYield

Measure

A mérési olvasás és egység tárolásának sémája.

createdBy

string

A felhasználó/bérlő azonosítója hozza létre.

createdDateTime

string

Az erőforrás létrehozásának dátum-időpontja, mintaformátum: yyyy-MM-ddTHH:mm:ssZ.

description

string

Az erőforrás szöveges leírása.

eTag

string

Az ETag értéke az optimista egyidejűség megvalósításához.

harvestProductDetails

HarvestProductDetail[]

A betakarított termék részletei.

id

string

Egyedi erőforrás-azonosító.

modifiedBy

string

Módosítva a felhasználó/bérlő azonosítója alapján.

modifiedDateTime

string

Az erőforrás utolsó módosításának dátuma, mintaformátum: yyyy-MM-ddTHH:mm:ssZ.

name

string

Név az erőforrás azonosításához.

operationEndDateTime

string

A műveleti adatok befejezési dátuma, mintaformátum: éé-MM-ddTHH:mm:ssZ.

operationModifiedDateTime

string

A műveleti adatok módosított dátum-ideje, mintaformátum: yyyy-MM-ddTHH:mm:ssZ. Megjegyzés: ezt maga a forrásszolgáltató fogja megadni.

operationStartDateTime

string

A műveleti adatok kezdő dátum-időpontja, mintaformátum: yyyy-MM-ddTHH:mm:ssZ.

partyId

string

A műveleti adatokhoz tartozó félazonosító.

properties

Az erőforráshoz tartozó kulcsértékpárok gyűjteménye. Minden párnak nem lehet 50 karakternél nagyobb kulcsa, és nem lehet 150 karakternél nagyobb érték. Megjegyzés: Egy erőforráshoz legfeljebb 25 kulcsértékpár adható meg, és csak sztring-, szám- és datetime (ééééé-MM-ddTHH:mm:ssZ) értékek támogatottak.

source

string

Az erőforrás forrása.

status

string

Az erőforrás állapota.

totalWetMass

Measure

A mérési olvasás és egység tárolásának sémája.

totalYield

Measure

A mérési olvasás és egység tárolásának sémája.

HarvestDataListResponse

A lapozott válasz tartalmazza a kért objektumok listáját és egy URL-hivatkozást a következő eredményhalmaz lekéréséhez.

Name Típus Description
nextLink

string

Folytatási hivatkozás (abszolút URI) a lista következő eredményoldalára.

skipToken

string

A következő oldal lekéréséhez használt jogkivonat. Null érték esetén nincsenek további lapok.

value

HarvestData[]

A kért objektumok listája.

HarvestProductDetail

A betakarítás során használt termék sémája.

Name Típus Description
area

Measure

A mérési olvasás és egység tárolásának sémája.

avgMoisture

Measure

A mérési olvasás és egység tárolásának sémája.

avgWetMass

Measure

A mérési olvasás és egység tárolásának sémája.

avgYield

Measure

A mérési olvasás és egység tárolásának sémája.

productName

string

A termék neve.

totalWetMass

Measure

A mérési olvasás és egység tárolásának sémája.

totalYield

Measure

A mérési olvasás és egység tárolásának sémája.

InnerError

Belső hiba, amely a hibák listáját tartalmazza. Lásd https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#innererror--object : InnerError referenciadokumentum.

Name Típus Description
code

string

Konkrét hibakód, mint amelyet a hiba tartalmazott.

innererror

InnerError

Belső hiba, amely a hibák listáját tartalmazza. Lásd https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#innererror--object : InnerError referenciadokumentum.

Measure

A mérési olvasás és egység tárolásának sémája.

Name Típus Description
unit

string

Adategység.

value

number

Adatérték.