# 16. クエリ: YieldDatasetsを取得 ## 概要 選択した圃場のすべてのYieldDatasetを取得します。 YieldDatasetは汎用のGraphQLクエリを使用して取得できます： 1. `getFarms` 完全な階層 Farm > Field > YieldDataset とそのフィルタを使用して 2. `getFields` リンクされた圃場からおよび階層 Field > YieldDataset から 3. 幅広いフィルタとページネーションを備えた getYieldDatasets {% hint style="warning" %} "YieldDataset" は事前にアップロードされている必要があります。 {% endhint %} ## 収量データセットエンティティ YieldDatasetには多くの属性が含まれます。GraphQLでは必要なフィールドのみを取得できるため、リクエストとレスポンスのサイズを大幅に削減できます。各属性の詳細な説明は以下にインラインで記載しています。 {% hint style="info" %} 以下で「YieldDataset」の属性においてマークされているものは *メタ情報から来ている* は任意です。これらはデータセットのメタ情報から導出されるもので、すべてのYieldDatasetに本質的に存在するわけではありません。 {% endhint %} {% hint style="success" %} についての詳細は `geoMaps` YieldDatasetの属性に関する情報は利用可能です [こちら](/geopard-tutorials/jpn/apidokyumento/dtaakusesu-geo-endopointo/wms-dtareiynorasutwo/12.-yielddatasetsmap.md). {% endhint %} {% hint style="success" %} YieldDatasetに対してクリーンとキャリブレーションを起動する方法の詳細は利用可能です [こちら](/geopard-tutorials/jpn/apidokyumento/geopard-apirikuesuto/84-mytshon-yielddataset-woshitekurnappu.md). {% endhint %} ```graphql { uuid name #パターン " " 耕うん（Tillage） number #ジオフィーチャーの総数 geometryType #ポリゴンまたはポイント totalCoveredArea(unit: HECTARES) #すべてのジオメトリの合計面積（ポリゴンに関連） fieldCoverage #データセットがカバーする圃場の割合（パーセント） fieldCoveredArea(unit: HECTARES) #ジオメトリの和集合（重複を除く） attributes fullAttributes { #属性ごとの完全な詳細 name #統計へのリンク >> 属性 transliteratedName fullName #正しい人間が読める名前 unit#測定単位 } usedMachines { #使用された機械（メタ情報から取得） id（識別子） serial operatorId } createdDate #GeoPardでのエンティティ作成日時 updatedDate #最終更新日時 operationId operationType operationFileDate #ファイル作成日時はメタ情報から取得されます operationStartDate #作業開始日時はメタ情報から取得されます statistics { #各属性の統計分布 attribute 最小 最大 avg mdn var std sum } cropName #作物名はメタ情報から取得されます cropToken #作物トークン（大文字） はメタ情報から取得されます appliedCorrections #適用された補正の一覧（記載順） appliedCorrectionsVersion #使用された補正アルゴリズムのバージョン geoMaps { url shortName #接頭辞オプション：raw、thumbnail_raw、processed、thumbnail_processed hexColorCodes classes } } ``` ## 1. クエリ getFarms ### リクエスト {% code overflow="wrap" lineNumbers="true" %} ```graphql query GetYieldDatasetsViaGetFarms { getFarms (farmUuids: ["9eecef55-f74f-4099-991a-05cbd976d50a"]) { uuid 名前 fields (fieldUuids: ["a050fc6f-1df8-4997-ae5b-5d0afa03a1ba"]) { uuid yieldDatasets { uuid 名前 number geometryType totalCoveredArea(unit: HECTARES) fieldCoverage fieldCoveredArea(unit: HECTARES) } } } } ``` {% endcode %} ### レスポンス ```json { "data": { "getFarms": [ { "uuid": "9eecef55-f74f-4099-991a-05cbd976d50a", "name": "TEST VECTOR DATA", "fields": [ { "uuid": "a050fc6f-1df8-4997-ae5b-5d0afa03a1ba", "yieldDatasets": [ { "uuid": "08f0fee4-daf4-4a98-97e5-660b7b6cfbeb", "name": "CALIBRATE-CLEAN-YieldCORN2017", "number": 14657, "geometryType": "POINTS", "totalCoveredArea": -1.0, "fieldCoverage": 0.97578, "fieldCoveredArea": 21.024173 }, { "uuid": "2b4fbd15-c961-49c8-8cc2-3031397d0380", "name": "CALIBRATE-YieldCORN2017", "number": 16200, "geometryType": "POINTS", "totalCoveredArea": -1.0, "fieldCoverage": 0.98791, "fieldCoveredArea": 21.285677 }, { "uuid": "465769d3-14dd-419f-9740-fb230c0505fd", "name": "YieldSbean2018_reupload", "number": 9073, "geometryType": "POINTS", "totalCoveredArea": -1.0, "fieldCoverage": 0.92874, "fieldCoveredArea": 20.0107663 }, { "uuid": "73d247ad-c45b-47a5-b94d-a2eb502857fe", "name": "CLEAN-YieldCORN2017 before build", "number": 14709, "geometryType": "POINTS", "totalCoveredArea": -1.0, "fieldCoverage": 0.98305, "fieldCoveredArea": 21.1808419 }, { "uuid": "74f06214-1051-47a2-a560-696d9290245a", "name": "YieldSbean2018", "number": 10179, "geometryType": "POINTS", "totalCoveredArea": -1.0, "fieldCoverage": 0.92874, "fieldCoveredArea": 20.0107663 }, { "uuid": "7e2bc706-2da4-43ae-beaa-240300d20c53", "name": "YieldSbean2015", "number": 10293, "geometryType": "POINTS", "totalCoveredArea": -1.0, "fieldCoverage": 0.96217, "fieldCoveredArea": 20.730980600000002 }, { "uuid": "7fb9fb1f-c4df-4146-892c-ba672dab9cd7", "name": "CALIBRATE-CLEAN-YieldSbean2018", "number": 9026, "geometryType": "POINTS", "totalCoveredArea": -1.0, "fieldCoverage": 0.92426, "fieldCoveredArea": 19.914270300000002 }, { "uuid": "8a97fc98-d6a5-4fb0-bd8d-d50c50b1adb8", "name": "CLEAN-YieldCORN2017 after build", "number": 14709, "geometryType": "POINTS", "totalCoveredArea": -1.0, "fieldCoverage": 0.98305, "fieldCoveredArea": 21.1808419 }, { "uuid": "a7f9d7cc-e1e1-46ff-b13d-468518749ba9", "name": "CALIBRATE-YieldSbean2015", "number": 9310, "geometryType": "POINTS", "totalCoveredArea": -1.0, "fieldCoverage": 0.95482, "fieldCoveredArea": 20.5726658 }, { "uuid": "cbd0c66b-21e3-4997-96a7-f1179da18c36", "name": "CLEAN-CALIBRATE-YieldSbean2015", "number": 9183, "geometryType": "POINTS", "totalCoveredArea": -1.0, "fieldCoverage": 0.90674, "fieldCoveredArea": 19.5366444 }, { "uuid": "fdfd701f-6529-4f4e-8027-e831fb557fe2", "name": "YieldCORN2017", "number": 16334, "geometryType": "POINTS", "totalCoveredArea": -1.0, "fieldCoverage": 0.97947, "fieldCoveredArea": 21.103661199999998 } ] } ] } ] } } ``` ## 2. クエリ getFields ### リクエスト {% code overflow="wrap" lineNumbers="true" %} ```graphql query GetYieldDatasetsViaGetFields { getFields (filter: {fieldUuid: "a050fc6f-1df8-4997-ae5b-5d0afa03a1ba"}) { fields { uuid area(unit: HECTARES) yieldDatasets(yieldDatasetUuids: ["8a97fc98-d6a5-4fb0-bd8d-d50c50b1adb8"]) { uuid 名前 number geometryType totalCoveredArea(unit: HECTARES) fieldCoverage fieldCoveredArea(unit: HECTARES) } } } } ``` {% endcode %} ### レスポンス ```json { "data": { "getFields": { "fields": [ { "uuid": "a050fc6f-1df8-4997-ae5b-5d0afa03a1ba", "area": 21.541909393943847, "yieldDatasets": [ { "uuid": "8a97fc98-d6a5-4fb0-bd8d-d50c50b1adb8", "name": "CLEAN-YieldCORN2017 after build", "number": 14709, "geometryType": "POINTS", "totalCoveredArea": -1.0, "fieldCoverage": 0.98305, "fieldCoveredArea": 21.1808419 } ] } ] } } } ``` ## 3. クエリ getYieldDatasets ### 最初のページをリクエスト ```graphql query GetPaginatedYieldDatasets { getYieldDatasets( filter:{ fieldUuid: "a050fc6f-1df8-4997-ae5b-5d0afa03a1ba" pageSize: 2 } ) { yieldDatasets { uuid 名前 fieldCoverage fieldCoveredArea(unit: HECTARES) number } lastEvaluatedKey { PartitionKey SortKey TagString } } } ``` ### 最初のページのレスポンス ```json { "data": { "getYieldDatasets": { "yieldDatasets": [ { "uuid": "08f0fee4-daf4-4a98-97e5-660b7b6cfbeb", "name": "CALIBRATE-CLEAN-YieldCORN2017", "fieldCoverage": 0.97578, "fieldCoveredArea": 21.024173, "number": 14657 }, { "uuid": "2b4fbd15-c961-49c8-8cc2-3031397d0380", "name": "CALIBRATE-YieldCORN2017", "fieldCoverage": 0.98791, "fieldCoveredArea": 21.285677, "number": 16200 } ], "lastEvaluatedKey": { "PartitionKey": "FIELD-a050fc6f-1df8-4997-ae5b-5d0afa03a1ba", "SortKey": "YVDATA-2b4fbd15-c961-49c8-8cc2-3031397d0380", "TagString": null } } } } ``` ### 次のページをリクエスト ページネーションのパラメータは経由で渡されます `lastEvaluatedKey（最後に評価されたキー）`、上記の最初のページのレスポンスで返された値を使用します。 ```graphql query GetPaginatedYieldDatasets { getYieldDatasets( filter:{ fieldUuid: "a050fc6f-1df8-4997-ae5b-5d0afa03a1ba" pageSize: 2 lastEvaluatedKey: { PartitionKey: "FIELD-a050fc6f-1df8-4997-ae5b-5d0afa03a1ba", SortKey: "YVDATA-2b4fbd15-c961-49c8-8cc2-3031397d0380", TagString: null } } ) { yieldDatasets { uuid 名前 fieldCoverage fieldCoveredArea(unit: HECTARES) number } lastEvaluatedKey { PartitionKey SortKey TagString } } } ``` ### 次のページのレスポンス ```json { "data": { "getYieldDatasets": { "yieldDatasets": [ { "uuid": "465769d3-14dd-419f-9740-fb230c0505fd", "name": "YieldSbean2018_reupload", "fieldCoverage": 0.92874, "fieldCoveredArea": 20.0107663, "number": 9073 }, { "uuid": "73d247ad-c45b-47a5-b94d-a2eb502857fe", "name": "CLEAN-YieldCORN2017 before build", "fieldCoverage": 0.98305, "fieldCoveredArea": 21.1808419, "number": 14709 } ], "lastEvaluatedKey": { "PartitionKey": "FIELD-a050fc6f-1df8-4997-ae5b-5d0afa03a1ba", "SortKey": "YVDATA-73d247ad-c45b-47a5-b94d-a2eb502857fe", "TagString": null } } } } ``` --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.geopard.tech/geopard-tutorials/jpn/apidokyumento/geopard-apirikuesuto/16-kueri-yielddatasetswo.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.