Harvest Data - List By Farmer Id

Referensi

Layanan:: Azure Data Manager for Agriculture

Versi API:: 2021-07-31-preview

Mengembalikan daftar sumber daya data panen yang dipaginasi di bawah farm tertentu.

GET /farmers/{farmerId}/harvest-data?api-version=2021-07-31-preview

Dengan parameter opsional:

GET /farmers/{farmerId}/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=2021-07-31-preview

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
farmerId	path	True	string	ID petani terkait.
api-version	query	True	string	Versi API yang diminta
$maxPageSize	query		integer (int32) minimum: 10 maximum: 1000	Jumlah maksimum item yang diperlukan (inklusif). Minimum = 10, Maksimum = 1000, Nilai default = 50.
$skipToken	query		string	Lewati token untuk mendapatkan serangkaian hasil berikutnya.
associatedBoundaryIds	query		string[]	ID batas yang terkait dengan data operasi.
ids	query		string[]	Id sumber daya.
maxArea	query		number (double)	Area maksimum yang operasinya diterapkan (inklusif).
maxAvgMoisture	query		number (double)	Nilai AvgMoisture maksimum (inklusif).
maxAvgSpeed	query		number (double)	Nilai AvgSpeed maksimum (inklusif).
maxAvgWetMass	query		number (double)	Nilai AvgWetMass maksimum (inklusif).
maxAvgYield	query		number (double)	Nilai AvgYield maksimum (inklusif).
maxCreatedDateTime	query		string (date-time)	Tanggal pembuatan sumber daya maksimum (inklusif).
maxLastModifiedDateTime	query		string (date-time)	Tanggal maksimum sumber daya terakhir diubah (inklusif).
maxOperationEndDateTime	query		string (date-time)	Tanggal akhir maksimum data operasi, format sampel: yyyy-MM-ddTHH:mm:ssZ (inklusif).
maxOperationModifiedDateTime	query		string (date-time)	Tanggal-waktu maksimum yang dimodifikasi dari data operasi, format sampel: yyyy-MM-ddTHH:mm:ssZ (inklusif).
maxOperationStartDateTime	query		string (date-time)	Tanggal mulai maksimum data operasi, format sampel: yyyy-MM-ddTHH:mm:ssZ (inklusif).
maxTotalWetMass	query		number (double)	Nilai Total WetMass maksimum (inklusif).
maxTotalYield	query		number (double)	Nilai hasil maksimum (inklusif).
minArea	query		number (double)	Area minimum tempat operasi diterapkan (inklusif).
minAvgMoisture	query		number (double)	Nilai AvgMoisture minimum (inklusif).
minAvgSpeed	query		number (double)	Nilai AvgSpeed minimum(inklusif).
minAvgWetMass	query		number (double)	Nilai AvgWetMass minimum(inklusif).
minAvgYield	query		number (double)	Nilai AvgYield minimum (inklusif).
minCreatedDateTime	query		string (date-time)	Tanggal pembuatan sumber daya minimum (inklusif).
minLastModifiedDateTime	query		string (date-time)	Tanggal minimum sumber daya terakhir diubah (inklusif).
minOperationEndDateTime	query		string (date-time)	Tanggal akhir minimum data operasi, format sampel: yyyy-MM-ddTHH:mm:ssZ (inklusif).
minOperationModifiedDateTime	query		string (date-time)	Tanggal-waktu minimum yang dimodifikasi dari data operasi, format sampel: yyyy-MM-ddTHH:mm:ssZ (inklusif).
minOperationStartDateTime	query		string (date-time)	Tanggal mulai minimum data operasi, format sampel: yyyy-MM-ddTHH:mm:ssZ (inklusif).
minTotalWetMass	query		number (double)	Nilai Total WetMas minimum (inklusif).
minTotalYield	query		number (double)	Nilai hasil minimum(inklusif).
names	query		string[]	Nama sumber daya.
propertyFilters	query		string[]	Filter pada pasangan kunci-nilai dalam objek Properti. misalnya. "{testKey} eq {testValue}".
sources	query		string[]	Sumber data operasi.
statuses	query		string[]	Status sumber daya.

Header Permintaan

Nama	Diperlukan	Jenis	Deskripsi
Authorization	True	string	Harap berikan token pembawa yang valid untuk panggilan API resmi. Perhatikan bahwa Anda mungkin perlu menghapus cache browser jika Anda mencoba panggilan yang tidak diautentikasi sebelumnya.

Respons

Nama	Jenis	Deskripsi
200 OK	HarvestDataListResponse	Keberhasilan
Other Status Codes	ErrorResponse	Kesalahan Header x-ms-error-code: string

Nama

Jenis

Deskripsi

200 OK

HarvestDataListResponse

Keberhasilan

Other Status Codes

ErrorResponse

Kesalahan

Header

x-ms-error-code: string

Keamanan

Authorization

Harap berikan token pembawa yang valid untuk panggilan API resmi. Perhatikan bahwa Anda mungkin perlu menghapus cache browser jika Anda mencoba panggilan yang tidak diautentikasi sebelumnya.

Jenis: apiKey
Dalam: header

Contoh

HarvestData_ListByFarmerId

Permintaan sampel

HTTP

GET /farmers/FARMER123/harvest-data?api-version=2021-07-31-preview

Respon sampel

Kode status:: 200

{
  "value": [
    {
      "farmerId": "FARMER123",
      "id": "HARVESTOP123",
      "source": "Manual",
      "name": "Harvest data for North Farm",
      "description": "some description",
      "status": "Active",
      "operationStartDateTime": "2021-02-25T16:57:04Z",
      "operationEndDateTime": "2021-02-27T10:13:06Z",
      "operationModifiedDateTime": "2021-02-28T10:12:12Z",
      "operationBoundaryId": "HARVESTOPBOUNDARY1",
      "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/farmer/{{farmerId}}/attachments?api-version={{apiVersion}}&resourceIds={{harvestDataId}}&resourceTypes=HarvestData",
      "createdDateTime": "2021-02-28T04:57:04Z",
      "modifiedDateTime": "2021-03-08T18:22:07Z",
      "eTag": "cb00a3ac-0000-0100-0000-601d21ec0000"
    }
  ],
  "$skipToken": "string",
  "nextLink": "https:/{{resourceName}}.farmbeats.azure.net/farmers/{{farmerId}}/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"
}

Definisi

Nama	Deskripsi
Error	Kesalahan dari layanan Azure AgPlatform.
ErrorResponse	Respons kesalahan dari layanan Azure AgPlatform. Dokumen referensi ErrorResponse..
HarvestData	Skema sumber daya data panen.
HarvestDataListResponse	Respons halaman berisi daftar objek yang diminta dan tautan URL untuk mendapatkan kumpulan hasil berikutnya.
HarvestProductDetail	Skema produk yang digunakan selama panen.
InnerError	Kesalahan dalam yang berisi daftar kesalahan. Dokumen referensi InnerError.
Measure	Skema untuk menyimpan pembacaan dan unit pengukuran.

Error

Objek

Kesalahan dari layanan Azure AgPlatform.

Nama	Jenis	Deskripsi
code	string	Sekumpulan kode kesalahan yang ditentukan server.
details	Error[]	Array detail tentang kesalahan tertentu yang menyebabkan kesalahan yang dilaporkan ini.
innererror	InnerError	Kesalahan dalam yang berisi daftar kesalahan. Dokumen referensi InnerError.
message	string	Representasi kesalahan yang dapat dibaca manusia.
target	string	Target kesalahan.

ErrorResponse

Objek

Respons kesalahan dari layanan Azure AgPlatform. Dokumen referensi ErrorResponse..

Nama	Jenis	Deskripsi
error	Error	Kesalahan dari layanan Azure AgPlatform.
traceId	string	Id pelacakan unik.

HarvestData

Objek

Skema sumber daya data panen.

Nama	Jenis	Deskripsi
area	Measure	Skema untuk menyimpan pembacaan dan unit pengukuran.
associatedBoundaryId	string	ID batas opsional bidang tempat operasi diterapkan.
attachmentsLink	string	Tautan untuk lampiran.
avgMoisture	Measure	Skema untuk menyimpan pembacaan dan unit pengukuran.
avgSpeed	Measure	Skema untuk menyimpan pembacaan dan unit pengukuran.
avgWetMass	Measure	Skema untuk menyimpan pembacaan dan unit pengukuran.
avgYield	Measure	Skema untuk menyimpan pembacaan dan unit pengukuran.
createdDateTime	string (date-time)	Tanggal-waktu saat sumber daya dibuat, format sampel: yyyy-MM-ddTHH:mm:ssZ.
description	string minLength: 0 maxLength: 500	Deskripsi tekstual sumber daya.
eTag	string	Nilai ETag untuk menerapkan konkurensi optimis.
farmerId	string	ID Petani yang termasuk dalam data operasi.
harvestProductDetails	HarvestProductDetail[]	Panen detail produk.
id	string	ID sumber daya unik.
modifiedDateTime	string (date-time)	Tanggal-waktu ketika sumber daya terakhir diubah, format sampel: yyyy-MM-ddTHH:mm:ssZ.
name	string minLength: 0 maxLength: 100	Nama untuk mengidentifikasi sumber daya.
operationEndDateTime	string (date-time)	Tanggal akhir data operasi, format sampel: yyyy-MM-ddTHH:mm:ssZ.
operationModifiedDateTime	string (date-time)	Tanggal-waktu yang dimodifikasi dari data operasi, format sampel: yyyy-MM-ddTHH:mm:ssZ. Catatan: ini akan ditentukan oleh penyedia sumber itu sendiri.
operationStartDateTime	string (date-time)	Tanggal mulai data operasi, format sampel: yyyy-MM-ddTHH:mm:ssZ.
properties		Kumpulan pasangan nilai kunci milik sumber daya. Setiap pasangan tidak boleh memiliki kunci yang lebih besar dari 50 karakter dan tidak boleh memiliki nilai yang lebih besar dari 150 karakter. Catatan: Maksimal 25 pasangan nilai kunci dapat disediakan untuk sumber daya dan hanya nilai string, angka, dan tanggalwaktu (yyyy-MM-ddTHH:mm:ssZ) yang didukung.
source	string minLength: 2 maxLength: 100	Sumber sumber daya.
status	string minLength: 0 maxLength: 100	Status sumber daya.
totalWetMass	Measure	Skema untuk menyimpan pembacaan dan unit pengukuran.
totalYield	Measure	Skema untuk menyimpan pembacaan dan unit pengukuran.

HarvestDataListResponse

Objek

Respons halaman berisi daftar objek yang diminta dan tautan URL untuk mendapatkan kumpulan hasil berikutnya.

Nama	Jenis	Deskripsi
$skipToken	string	Token yang digunakan dalam mengambil halaman berikutnya. Jika null, tidak ada halaman tambahan.
nextLink	string	Tautan kelanjutan (URI absolut) ke halaman hasil berikutnya dalam daftar.
value	HarvestData[]	Daftar objek yang diminta.

HarvestProductDetail

Objek

Skema produk yang digunakan selama panen.

Nama	Jenis	Deskripsi
area	Measure	Skema untuk menyimpan pembacaan dan unit pengukuran.
avgMoisture	Measure	Skema untuk menyimpan pembacaan dan unit pengukuran.
avgWetMass	Measure	Skema untuk menyimpan pembacaan dan unit pengukuran.
avgYield	Measure	Skema untuk menyimpan pembacaan dan unit pengukuran.
productName	string minLength: 1 maxLength: 100	Nama produk.
totalWetMass	Measure	Skema untuk menyimpan pembacaan dan unit pengukuran.
totalYield	Measure	Skema untuk menyimpan pembacaan dan unit pengukuran.

InnerError

Objek

Kesalahan dalam yang berisi daftar kesalahan. Dokumen referensi InnerError.

Nama	Jenis	Deskripsi
code	string	Kode kesalahan tertentu daripada yang disediakan oleh kesalahan yang berisi.
innererror	InnerError	Kesalahan dalam yang berisi daftar kesalahan. Dokumen referensi InnerError.

Measure

Objek

Skema untuk menyimpan pembacaan dan unit pengukuran.

Nama	Jenis	Deskripsi
unit	string minLength: 1 maxLength: 50	Unit data.
value	number (double)	Nilai data.

Bagikan melalui

Harvest Data - List By Farmer Id

Parameter URI

Header Permintaan

Respons

Keamanan

Authorization

Contoh

HarvestData_ListByFarmerId

Permintaan sampel

Respon sampel

Definisi

Error

ErrorResponse

HarvestData

HarvestDataListResponse

HarvestProductDetail

InnerError

Measure