Taranis API
[ Base URL: api.taranis.ag/v1 ]
https://api.taranis.ag/v1/docs/?format=openapi
Api for accessing Taranis data
Example usage
Go to the dashboard and generate an API TOKEN
Get A list of organizations available to the user:
$ curl -X GET "https://api.taranis.ag/v1/org/" -H "accept: application/json" -H "Authorization: Bearer <API TOKEN>"
Select an Organization and list its Clients:
curl -X GET "https://api.taranis.ag/v1/clients/?organization=<Organization ID>" -H "accept: application/json" -H "Authorization: Bearer <API TOKEN>"
Select a Client and List All Farms that belong to it:
curl -X GET "https://api.taranis.ag/v1/farms/?clients=<client ID>" -H "accept: application/json" -H "Authorization: Bearer <API TOKEN>"
Select a Farm and List All Fields that belong to it:
curl -X GET "https://api.taranis.ag/v1/fields/?farms=<Farm ID>" -H "accept: application/json" -H "Authorization: Bearer <API TOKEN>"
Select a field and list all ndvi maps between 12-06-2019 and 12-07-2019:
curl -X GET "https://api.taranis.ag/v1/maplayers/<Field ID>/?type=ndvi&start_date=12-06-2019&end_date=12-07-2019" -H "accept: application/json" -H "Authorization: Bearer <API TOKEN>"
The result will contain Map meta-data as well as a url to download the map
Go to the dashboard and generate an API TOKEN
Get A list of organizations available to the user:
$ curl -X GET "https://api.taranis.ag/v1/org/" -H "accept: application/json" -H "Authorization: Bearer <API TOKEN>"Select an Organization and list its Clients:
curl -X GET "https://api.taranis.ag/v1/clients/?organization=<Organization ID>" -H "accept: application/json" -H "Authorization: Bearer <API TOKEN>"Select a Client and List All Farms that belong to it:
curl -X GET "https://api.taranis.ag/v1/farms/?clients=<client ID>" -H "accept: application/json" -H "Authorization: Bearer <API TOKEN>"Select a Farm and List All Fields that belong to it:
curl -X GET "https://api.taranis.ag/v1/fields/?farms=<Farm ID>" -H "accept: application/json" -H "Authorization: Bearer <API TOKEN>"Select a field and list all ndvi maps between 12-06-2019 and 12-07-2019:
curl -X GET "https://api.taranis.ag/v1/maplayers/<Field ID>/?type=ndvi&start_date=12-06-2019&end_date=12-07-2019" -H "accept: application/json" -H "Authorization: Bearer <API TOKEN>"The result will contain Map meta-data as well as a url to download the map
More Examples
To create a field in The selected farm: Farm ID
curl -X POST "https://api.taranis.ag/v1/fields/" -H "accept: application/json" -H "Authorization: asd asd" -H "Content-Type: application/json" -d "{ \"name\": \"My New Field\", \"farm\": <Farm ID>, \"boundary\": \"{\\\"type\\\":\\\"Polygon\\\",\\\"coordinates\\\":[[[0,0],[1,0],[1,1],[0,1],[0,0]]]}\"}"
To create a field in The selected farm: Farm ID
curl -X POST "https://api.taranis.ag/v1/fields/" -H "accept: application/json" -H "Authorization: asd asd" -H "Content-Type: application/json" -d "{ \"name\": \"My New Field\", \"farm\": <Farm ID>, \"boundary\": \"{\\\"type\\\":\\\"Polygon\\\",\\\"coordinates\\\":[[[0,0],[1,0],[1,1],[0,1],[0,0]]]}\"}"
Available types for maplayers
CWSIEmergence HeatmapRelative Crop PerformanceVisible (RGB)Vegetation CoverageUHR NDVI StandardUHR ThermalWeeds Broad Leaf HeatmapWeeds Grass Leaf HeatmapWeeds HeatmapZones
CWSIEmergence HeatmapRelative Crop PerformanceVisible (RGB)Vegetation CoverageUHR NDVI StandardUHR ThermalWeeds Broad Leaf HeatmapWeeds Grass Leaf HeatmapWeeds HeatmapZones
NOTES
- Field Boundaries are represented in GeoJson format
- Field Boundaries are represented in GeoJson format
To learn more: visit https://api.taranis.ag/v1/docs/
Related Articles
API Overview
Taranis SmartScout® is a software designed to facilitate the engagement between advisors and growers. It provides ground truth with leaf-level precision and unmatched clarity. Our submillimeter image resolution is so clear that growers and ...Get API Credentials
To connect to the Taranis API environment from an external system you need to obtain a Token. You can get a Token by login in to Taranis WebApp. In Taranis WebApp, Go to your profile, under 'Your Information', click on 'Get API Token'. Copy the ...John Deere Integration Instructions
Taranis is integrated by API with John Deere for the following services: Import field boundaries To integrate data into the Taranis Web App from John Deere you will need to do the following: Go to field data and click on import files on the left ...Integrations Overview & Roadmap
Integrations Overview Taranis SmartScout securely integrates with external systems, such as agronomy precision systems, retailer Enterprise Resource Planning (ERP) systems, Farm Management Software (MFS) systems, equipment and other systems via ...Climate FieldView Integration Instructions
1. Open Taranis SmartScout web-application 2.In the upper right-hand corner of the screen click the user icon. This will open the user setting and profile page. 3. Navigate to the Settings tab and click Connect next to Climate FieldView 4. A ...