openapi: 3.0.3 info: title: AgroDataCube API v1 (legacy) Altitude Retrieve API version: '1.0' description: 'Faithful OpenAPI 3.0 conversion of the public AgroDataCube Postman collection. AgroDataCube provides open and derived data for agri-food applications over the Netherlands, returning GeoJSON for vector resources and GeoTIFF for raster (_image) resources. Access requires a free token supplied via the ''token'' HTTP header. Source: Wageningen Environmental Research (WUR).' license: name: CC BY-NC-SA 4.0 url: https://creativecommons.org/licenses/by-nc-sa/4.0/ contact: name: AgroDataCube url: https://agrodatacube.wur.nl/ servers: - url: https://agrodatacube.wur.nl/api/v1/rest security: - tokenHeader: [] tags: - name: Retrieve paths: /ahn: get: summary: Retrieve zonal statistics for altitude using the supplied geometry. If no epsg is provided epsg = 28992 (RD) is assumed. description: Retrieve zonal statistics for altitude using the supplied geometry. If no epsg is provided epsg = 28992 (RD) is assumed. Currently only EPSGs 28992 (Dutch RD) and 4326 (WGS 84) are supported. operationId: get_ahn responses: '200': description: Successful response. AgroDataCube returns a GeoJSON FeatureCollection (vector resources) or a binary GeoTIFF image (raster *_image resources). content: application/json: schema: $ref: '#/components/schemas/FeatureCollection' '401': description: Missing or invalid access token. '404': description: Resource not found. security: - tokenHeader: [] tags: - Retrieve parameters: - name: geometry in: query required: false schema: type: string - name: epsg in: query required: false schema: type: integer example: '4326' /codes/cropcodes: get: summary: Retrieve a list of all possible cropcodes. description: Retrieve a list of all possible cropcodes. operationId: get_codes_cropcodes responses: '200': description: Successful response. AgroDataCube returns a GeoJSON FeatureCollection (vector resources) or a binary GeoTIFF image (raster *_image resources). content: application/json: schema: $ref: '#/components/schemas/FeatureCollection' '401': description: Missing or invalid access token. '404': description: Resource not found. security: - tokenHeader: [] tags: - Retrieve parameters: - name: page_size in: query required: false schema: type: integer example: '25' - name: page_offset in: query required: false schema: type: integer example: '0' /codes/cropcodes/{cropcode}: get: summary: Retrieve details for a specific cropcode. description: Retrieve details for a specific cropcode. operationId: get_codes_cropcodes_cropcode responses: '200': description: Successful response. AgroDataCube returns a GeoJSON FeatureCollection (vector resources) or a binary GeoTIFF image (raster *_image resources). content: application/json: schema: $ref: '#/components/schemas/FeatureCollection' '401': description: Missing or invalid access token. '404': description: Resource not found. security: - tokenHeader: [] tags: - Retrieve parameters: - name: cropcode in: path required: true schema: type: string description: Path parameter cropcode. - name: page_size in: query required: false schema: type: integer example: '25' - name: page_offset in: query required: false schema: type: integer example: '0' /codes/soilcodes: get: summary: Retrieve a list of all possible soilcodes. description: Retrieve a list of all possible soilcodes. operationId: get_codes_soilcodes responses: '200': description: Successful response. AgroDataCube returns a GeoJSON FeatureCollection (vector resources) or a binary GeoTIFF image (raster *_image resources). content: application/json: schema: $ref: '#/components/schemas/FeatureCollection' '401': description: Missing or invalid access token. '404': description: Resource not found. security: - tokenHeader: [] tags: - Retrieve parameters: - name: page_size in: query required: false schema: type: integer example: '25' - name: page_offset in: query required: false schema: type: integer example: '0' /codes/soilcodes/{soilcode}: get: summary: Retrieve details for a specific soilcode. description: Retrieve details for a specific soilcode. operationId: get_codes_soilcodes_soilcode responses: '200': description: Successful response. AgroDataCube returns a GeoJSON FeatureCollection (vector resources) or a binary GeoTIFF image (raster *_image resources). content: application/json: schema: $ref: '#/components/schemas/FeatureCollection' '401': description: Missing or invalid access token. '404': description: Resource not found. security: - tokenHeader: [] tags: - Retrieve parameters: - name: soilcode in: path required: true schema: type: string description: Path parameter soilcode. - name: page_size in: query required: false schema: type: integer example: '25' - name: page_offset in: query required: false schema: type: integer example: '0' /fields: get: summary: Retrieve the geometry and soil information of the intersections of the supplied geometry and the fields. If no epsg is p description: Retrieve the geometry and soil information of the intersections of the supplied geometry and the fields. If no epsg is provided EPSG:28992 (Dutch RD) is assumed. Currently only EPSGs 28992 and 4326 (WGS 84) are supported. operationId: get_fields responses: '200': description: Successful response. AgroDataCube returns a GeoJSON FeatureCollection (vector resources) or a binary GeoTIFF image (raster *_image resources). content: application/json: schema: $ref: '#/components/schemas/FeatureCollection' '401': description: Missing or invalid access token. '404': description: Resource not found. security: - tokenHeader: [] tags: - Retrieve parameters: - name: output_epsg in: query required: false schema: type: integer example: '4326' - name: page_size in: query required: false schema: type: integer example: '25' - name: page_offset in: query required: false schema: type: integer example: '0' - name: year in: query required: false schema: type: string - name: cropcode in: query required: false schema: type: integer - name: cropname in: query required: false schema: type: string - name: geometry in: query required: false schema: type: string - name: epsg in: query required: false schema: type: integer example: '4326' /fields/{fieldid}: get: summary: Retrieve the geometry and crop information for a specific crop field. description: Retrieve the geometry and crop information for a specific crop field. operationId: get_fields_fieldid responses: '200': description: Successful response. AgroDataCube returns a GeoJSON FeatureCollection (vector resources) or a binary GeoTIFF image (raster *_image resources). content: application/json: schema: $ref: '#/components/schemas/FeatureCollection' '401': description: Missing or invalid access token. '404': description: Resource not found. security: - tokenHeader: [] tags: - Retrieve parameters: - name: fieldid in: path required: true schema: type: string description: Path parameter fieldid. - name: output_epsg in: query required: false schema: type: integer example: '4326' - name: page_size in: query required: false schema: type: integer example: '25' - name: page_offset in: query required: false schema: type: integer example: '0' /fields/{fieldid}/ahn: get: summary: Retrieve altitude zonal statistics (in cm) based on AHN for a specific field. description: Retrieve altitude zonal statistics (in cm) based on AHN for a specific field. operationId: get_fields_fieldid_ahn responses: '200': description: Successful response. AgroDataCube returns a GeoJSON FeatureCollection (vector resources) or a binary GeoTIFF image (raster *_image resources). content: application/json: schema: $ref: '#/components/schemas/FeatureCollection' '401': description: Missing or invalid access token. '404': description: Resource not found. security: - tokenHeader: [] tags: - Retrieve parameters: - name: fieldid in: path required: true schema: type: string description: Path parameter fieldid. - name: page_size in: query required: false schema: type: integer example: '25' - name: page_offset in: query required: false schema: type: integer example: '0' /fields/{fieldid}/meteostations: get: summary: Retrieve a list of the nearest meteostations to a specific field, ranked by distance. description: Retrieve a list of the nearest meteostations to a specific field, ranked by distance. operationId: get_fields_fieldid_meteostations responses: '200': description: Successful response. AgroDataCube returns a GeoJSON FeatureCollection (vector resources) or a binary GeoTIFF image (raster *_image resources). content: application/json: schema: $ref: '#/components/schemas/FeatureCollection' '401': description: Missing or invalid access token. '404': description: Resource not found. security: - tokenHeader: [] tags: - Retrieve parameters: - name: fieldid in: path required: true schema: type: string description: Path parameter fieldid. - name: output_epsg in: query required: false schema: type: integer example: '4326' - name: page_size in: query required: false schema: type: integer example: '25' - name: page_offset in: query required: false schema: type: integer example: '0' /fields/{fieldid}/ndvi: get: summary: Retrieve the available NDVI (Normalized Difference Vegetation Index) values for a specific field and time period. description: Retrieve the available NDVI (Normalized Difference Vegetation Index) values for a specific field and time period. operationId: get_fields_fieldid_ndvi responses: '200': description: Successful response. AgroDataCube returns a GeoJSON FeatureCollection (vector resources) or a binary GeoTIFF image (raster *_image resources). content: application/json: schema: $ref: '#/components/schemas/FeatureCollection' '401': description: Missing or invalid access token. '404': description: Resource not found. security: - tokenHeader: [] tags: - Retrieve parameters: - name: fieldid in: path required: true schema: type: string description: Path parameter fieldid. - name: output_epsg in: query required: false schema: type: integer example: '4326' - name: page_size in: query required: false schema: type: integer example: '25' - name: page_offset in: query required: false schema: type: integer example: '0' /fields/{fieldid}/soilparams: get: summary: Retrieve the spatial intersections of a field with the soil physical parameters geometries (for more detailed informatio description: 'Retrieve the spatial intersections of a field with the soil physical parameters geometries (for more detailed information see http://content.alterra.wur.nl/Webdocs/PDFFiles/Alterrarapporten/AlterraRapport2387.pdf). The soilparamid returned can be used to ' operationId: get_fields_fieldid_soilparams responses: '200': description: Successful response. AgroDataCube returns a GeoJSON FeatureCollection (vector resources) or a binary GeoTIFF image (raster *_image resources). content: application/json: schema: $ref: '#/components/schemas/FeatureCollection' '401': description: Missing or invalid access token. '404': description: Resource not found. security: - tokenHeader: [] tags: - Retrieve parameters: - name: fieldid in: path required: true schema: type: string description: Path parameter fieldid. - name: output_epsg in: query required: false schema: type: integer example: '4326' - name: page_size in: query required: false schema: type: integer example: '25' - name: page_offset in: query required: false schema: type: integer example: '0' /fields/{fieldid}/soiltypes: get: summary: 'Retrieve the spatial intersections of the field with the geometries of the soilmap 1 : 50.000. The soilid returned is th' description: 'Retrieve the spatial intersections of the field with the geometries of the soilmap 1 : 50.000. The soilid returned is the objectid in the shapefile as provided by PDOK.' operationId: get_fields_fieldid_soiltypes responses: '200': description: Successful response. AgroDataCube returns a GeoJSON FeatureCollection (vector resources) or a binary GeoTIFF image (raster *_image resources). content: application/json: schema: $ref: '#/components/schemas/FeatureCollection' '401': description: Missing or invalid access token. '404': description: Resource not found. security: - tokenHeader: [] tags: - Retrieve parameters: - name: fieldid in: path required: true schema: type: string description: Path parameter fieldid. - name: output_epsg in: query required: false schema: type: integer example: '4326' - name: page_size in: query required: false schema: type: integer example: '25' - name: page_offset in: query required: false schema: type: integer example: '0' /meteodata: get: summary: Retrieve weather data from one of the meteostations for a specified time period. Dates can be entered as yyyymmdd, yyyy description: Retrieve weather data from one of the meteostations for a specified time period. Dates can be entered as yyyymmdd, yyyymm, or yyyy. operationId: get_meteodata responses: '200': description: Successful response. AgroDataCube returns a GeoJSON FeatureCollection (vector resources) or a binary GeoTIFF image (raster *_image resources). content: application/json: schema: $ref: '#/components/schemas/FeatureCollection' '401': description: Missing or invalid access token. '404': description: Resource not found. security: - tokenHeader: [] tags: - Retrieve parameters: - name: output_epsg in: query required: false schema: type: integer example: '4326' - name: meteostation in: query required: false schema: type: string - name: fromdate in: query required: false schema: type: string - name: todate in: query required: false schema: type: string - name: page_size in: query required: false schema: type: integer example: '25' - name: page_offset in: query required: false schema: type: integer example: '0' /meteodata/{stationid}/{date}: get: summary: Retrieve weather data from one of the meteostations and for a specific date. The date can be entered as yyyymmdd, yyyym description: Retrieve weather data from one of the meteostations and for a specific date. The date can be entered as yyyymmdd, yyyymm, or yyyy. operationId: get_meteodata_stationid_date responses: '200': description: Successful response. AgroDataCube returns a GeoJSON FeatureCollection (vector resources) or a binary GeoTIFF image (raster *_image resources). content: application/json: schema: $ref: '#/components/schemas/FeatureCollection' '401': description: Missing or invalid access token. '404': description: Resource not found. security: - tokenHeader: [] tags: - Retrieve parameters: - name: stationid in: path required: true schema: type: string description: Path parameter stationid. - name: date in: path required: true schema: type: string description: Path parameter date. - name: page_size in: query required: false schema: type: integer example: '25' - name: page_offset in: query required: false schema: type: integer example: '0' /codes/category: get: summary: Retrieve detailed crop category information description: Retrieve detailed crop category information operationId: get_codes_category responses: '200': description: Successful response. AgroDataCube returns a GeoJSON FeatureCollection (vector resources) or a binary GeoTIFF image (raster *_image resources). content: application/json: schema: $ref: '#/components/schemas/FeatureCollection' '401': description: Missing or invalid access token. '404': description: Resource not found. security: - tokenHeader: [] tags: - Retrieve parameters: - name: name in: query required: false schema: type: string example: The requested category - name: page_size in: query required: false schema: type: integer example: '25' - name: page_offset in: query required: false schema: type: integer example: '0' /fields/{fieldid}/bouwland_markers: get: summary: Retrieve arable land markers for a specific crop field description: Retrieve arable land markers for a specific crop field operationId: get_fields_fieldid_bouwland_markers responses: '200': description: Successful response. AgroDataCube returns a GeoJSON FeatureCollection (vector resources) or a binary GeoTIFF image (raster *_image resources). content: application/json: schema: $ref: '#/components/schemas/FeatureCollection' '401': description: Missing or invalid access token. '404': description: Resource not found. security: - tokenHeader: [] tags: - Retrieve parameters: - name: fieldid in: path required: true schema: type: string description: Path parameter fieldid. - name: page_size in: query required: false schema: type: integer example: '25' - name: page_offset in: query required: false schema: type: integer example: '0' /fields/{fieldid}/crophistory: get: summary: Retrieve the crop history for a parcel, based on its geometry description: Retrieve the crop history for a parcel, based on its geometry operationId: get_fields_fieldid_crophistory responses: '200': description: Successful response. AgroDataCube returns a GeoJSON FeatureCollection (vector resources) or a binary GeoTIFF image (raster *_image resources). content: application/json: schema: $ref: '#/components/schemas/FeatureCollection' '401': description: Missing or invalid access token. '404': description: Resource not found. security: - tokenHeader: [] tags: - Retrieve parameters: - name: fieldid in: path required: true schema: type: string description: Path parameter fieldid. - name: page_size in: query required: false schema: type: integer example: '25' - name: page_offset in: query required: false schema: type: integer example: '0' /fields/{fieldid}/croprotationindex: get: summary: Retrieve the crop rotation index for a field description: Retrieve the crop rotation index for a field operationId: get_fields_fieldid_croprotationindex responses: '200': description: Successful response. AgroDataCube returns a GeoJSON FeatureCollection (vector resources) or a binary GeoTIFF image (raster *_image resources). content: application/json: schema: $ref: '#/components/schemas/FeatureCollection' '401': description: Missing or invalid access token. '404': description: Resource not found. security: - tokenHeader: [] tags: - Retrieve parameters: - name: fieldid in: path required: true schema: type: string description: Path parameter fieldid. - name: page_size in: query required: false schema: type: integer example: '25' - name: page_offset in: query required: false schema: type: integer example: '0' /fields/{fieldid}/grasland_markers: get: summary: Retrieve graslandmarkers for a specific crop field description: Retrieve graslandmarkers for a specific crop field operationId: get_fields_fieldid_grasland_markers responses: '200': description: Successful response. AgroDataCube returns a GeoJSON FeatureCollection (vector resources) or a binary GeoTIFF image (raster *_image resources). content: application/json: schema: $ref: '#/components/schemas/FeatureCollection' '401': description: Missing or invalid access token. '404': description: Resource not found. security: - tokenHeader: [] tags: - Retrieve parameters: - name: fieldid in: path required: true schema: type: string description: Path parameter fieldid. - name: page_size in: query required: false schema: type: integer example: '25' - name: page_offset in: query required: false schema: type: integer components: schemas: FeatureCollection: type: object description: GeoJSON FeatureCollection returned by vector resources. required: - type - features properties: type: type: string enum: - FeatureCollection features: type: array items: $ref: '#/components/schemas/Feature' Feature: type: object description: GeoJSON Feature with a geometry and a free-form properties map whose keys depend on the queried resource. required: - type - geometry - properties properties: type: type: string enum: - Feature geometry: $ref: '#/components/schemas/Geometry' properties: type: object additionalProperties: true Geometry: type: object description: GeoJSON geometry (Point, Polygon, MultiPolygon, etc.). required: - type - coordinates properties: type: type: string enum: - Point - LineString - Polygon - MultiPoint - MultiLineString - MultiPolygon coordinates: type: array items: {} securitySchemes: tokenHeader: type: apiKey in: header name: token description: Access token obtained via https://agrodatacube.wur.nl/api/register.jsp