{"activeVersionTag":"latest","latestAvailableVersionTag":"latest","collection":{"info":{"_postman_id":"19553b7d-3433-fc59-8a9d-0ee3de4ea693","name":"airscout-external-partners-api","description":"# API Description:\r\rThis API is provided to allow Airscout partners to retrieve aerial imagery with the intention of being used in our partners own applications.\r\r\r# How to Use:\r\rIn order to use this API a consuming partner needs to request an “App User Key” which is unique to the consumer of the information and can be throttled or revoked if abuse is detected. This “App User Key” is an unsigned UUID and should be protected and not shared. The API is intended to be easy to use, not complicated, but abuse can be detected and will not be tolerated. This “App User Key” must be included in the header of every request as “appUserKey”.\r\rThe second piece of information needed to use the API is an “External Partner ID.” This ID represents a system external to Airscout who will have their own ID set for fields and imagery. The “External Partner ID” is unique to a system. This is the key that will allow mapping from an external parter’s system to Airscout’s. If you are just consuming imagery and not trying to map IDs from an external partner’s system and will use Airscout Field IDs for all requests you can use “1″ as the External Partner ID when creating requests.\r\r# Some General Concepts:\r\r## *Field Mappings* \r\rThis API does not require maintaining Airscout Field IDs in an external partners database but does require mapping field IDs from an external parter’s ID set to Airscout previous to retrieving field image meta data or field image resources. Fields are mapped from an Airscout field ID to a given external partner’s field ID by the provided “External Partner ID” which represents the external partner’s ID set. The mapping can either happen manually by updating the external parter row mapping table in the Hierarchy Management web app or via the provided API defined below. To use the API a user can request an Airscout field ID using the fields center and then post a response back to the API using that Airscout field ID and the equivalent External Partner’s field ID. \r\r\r## *Field Image* \r\rA single “Field Image” is considered and sometimes referred to as a single “Asset” and represents a single image taken by a pilot. That image can be requested in many forms and thus a “Field Image” is not a single file but rather meta data about a single image at a point in time that was taken and potentially further analyzed or processed. \r\r## *Requested Resource* \r\rA “Requested Resource” is a single file which could be a scaled version of the original field image taken by a Pilot, a geo-referenced image in KML format or one of several other formats. \r\r## *Asset Version* \r\rA single field image can actually have different versions depending on how the image was processed. For instance during image processing an ADVI or Thermal image can be rendered so that the image displays in Max Contrast which is best for identifying field variability or Normalized which an image will be optimized for comparing images in a series over the season.\r\rHere are the “Asset Versions” that can be requested and their correspond “Asset Version IDs” that should be used in the follow API.\r\r0 – Root – The base asset version used for visual images or other asset types where having various asset versions might not make sense\r\r1 – Normalized – The processed version of an asset that is optimized for comparing images in series over a season\r\r2 – Max Contrast – The processed version of an asset that is optimized for bringing out variability in image data\r\r\r## *Resource Variation*\r\rA given “Asset Version” can be requested in various formats or “resource variations.” For instance an image could be requested as a plain flat image, as a raster data set, a georeferenced KML etc\r\r0 – Root – The base asset version used for visual images or other asset types where having various image types might not make sense\r\r2 – Image – a JPEG image\r\r3 – Raster – a raster data set representation of a thermal or advi field image\r\r6 – KML – a geo-referenced KML file of a field image\r\r7 – KMZ – a geo-referenced KMZ file of a field image\r\r8 – GeoTIFF – a geo-referenced Geo Tiff file which is a ZIP folder with a TIFF Image and a World File\r\r9 – GeoJPEG – a geo-referenced Geo JPEG file which is a ZIP folder with a JPEG Image and a World File\r\r\r## *Coordinate System* \r\rAll coordinates referenced in this API assume the WGS84 coordinate system. \r\r\r## *Dates* \r\rAll dates are assumed to be in ISO 8601 date only format, ie yyyy-MM-dd.","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","isPublicCollection":false,"owner":"1765269","team":38042,"collectionId":"19553b7d-3433-fc59-8a9d-0ee3de4ea693","publishedId":"7LhjRVE","public":true,"publicUrl":"https://apidocs.airscout.com","privateUrl":"https://go.postman.co/documentation/1765269-19553b7d-3433-fc59-8a9d-0ee3de4ea693","customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"EF5B25"},"documentationLayout":"classic-double-column","version":"8.11.4","publishDate":"2017-12-15T16:44:02.000Z","activeVersionTag":"latest","documentationTheme":"light","metaTags":{},"logos":{}},"statusCode":200},"environments":[],"user":{"authenticated":false,"permissions":{"publish":false}},"run":{"button":{"js":"https://run.pstmn.io/button.js","css":"https://run.pstmn.io/button.css"}},"web":"https://www.getpostman.com/","team":{"logo":"https://res.cloudinary.com/postman/image/upload/t_team_logo_pubdoc/v1/team/dd364d4de0a8aa002dd90aee2692e79279bd1afb36433ade294ab50d18e71a60","favicon":"https://airscout.com/favicon.ico"},"isEnvFetchError":false,"languages":"[{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"HttpClient\"},{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"RestSharp\"},{\"key\":\"curl\",\"label\":\"cURL\",\"variant\":\"cURL\"},{\"key\":\"dart\",\"label\":\"Dart\",\"variant\":\"http\"},{\"key\":\"go\",\"label\":\"Go\",\"variant\":\"Native\"},{\"key\":\"http\",\"label\":\"HTTP\",\"variant\":\"HTTP\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"OkHttp\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"Unirest\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"Fetch\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"jQuery\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"XHR\"},{\"key\":\"c\",\"label\":\"C\",\"variant\":\"libcurl\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Axios\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Native\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Request\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Unirest\"},{\"key\":\"objective-c\",\"label\":\"Objective-C\",\"variant\":\"NSURLSession\"},{\"key\":\"ocaml\",\"label\":\"OCaml\",\"variant\":\"Cohttp\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"cURL\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"Guzzle\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"HTTP_Request2\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"pecl_http\"},{\"key\":\"powershell\",\"label\":\"PowerShell\",\"variant\":\"RestMethod\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"http.client\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"Requests\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"httr\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"RCurl\"},{\"key\":\"ruby\",\"label\":\"Ruby\",\"variant\":\"Net::HTTP\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"Httpie\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"wget\"},{\"key\":\"swift\",\"label\":\"Swift\",\"variant\":\"URLSession\"}]","languageSettings":[{"key":"csharp","label":"C#","variant":"HttpClient"},{"key":"csharp","label":"C#","variant":"RestSharp"},{"key":"curl","label":"cURL","variant":"cURL"},{"key":"dart","label":"Dart","variant":"http"},{"key":"go","label":"Go","variant":"Native"},{"key":"http","label":"HTTP","variant":"HTTP"},{"key":"java","label":"Java","variant":"OkHttp"},{"key":"java","label":"Java","variant":"Unirest"},{"key":"javascript","label":"JavaScript","variant":"Fetch"},{"key":"javascript","label":"JavaScript","variant":"jQuery"},{"key":"javascript","label":"JavaScript","variant":"XHR"},{"key":"c","label":"C","variant":"libcurl"},{"key":"nodejs","label":"NodeJs","variant":"Axios"},{"key":"nodejs","label":"NodeJs","variant":"Native"},{"key":"nodejs","label":"NodeJs","variant":"Request"},{"key":"nodejs","label":"NodeJs","variant":"Unirest"},{"key":"objective-c","label":"Objective-C","variant":"NSURLSession"},{"key":"ocaml","label":"OCaml","variant":"Cohttp"},{"key":"php","label":"PHP","variant":"cURL"},{"key":"php","label":"PHP","variant":"Guzzle"},{"key":"php","label":"PHP","variant":"HTTP_Request2"},{"key":"php","label":"PHP","variant":"pecl_http"},{"key":"powershell","label":"PowerShell","variant":"RestMethod"},{"key":"python","label":"Python","variant":"http.client"},{"key":"python","label":"Python","variant":"Requests"},{"key":"r","label":"R","variant":"httr"},{"key":"r","label":"R","variant":"RCurl"},{"key":"ruby","label":"Ruby","variant":"Net::HTTP"},{"key":"shell","label":"Shell","variant":"Httpie"},{"key":"shell","label":"Shell","variant":"wget"},{"key":"swift","label":"Swift","variant":"URLSession"}],"languageOptions":[{"label":"C# - HttpClient","value":"csharp - HttpClient - C#"},{"label":"C# - RestSharp","value":"csharp - RestSharp - C#"},{"label":"cURL - cURL","value":"curl - cURL - cURL"},{"label":"Dart - http","value":"dart - http - Dart"},{"label":"Go - Native","value":"go - Native - Go"},{"label":"HTTP - HTTP","value":"http - HTTP - HTTP"},{"label":"Java - OkHttp","value":"java - OkHttp - Java"},{"label":"Java - Unirest","value":"java - Unirest - Java"},{"label":"JavaScript - Fetch","value":"javascript - Fetch - JavaScript"},{"label":"JavaScript - jQuery","value":"javascript - jQuery - JavaScript"},{"label":"JavaScript - XHR","value":"javascript - XHR - JavaScript"},{"label":"C - libcurl","value":"c - libcurl - C"},{"label":"NodeJs - Axios","value":"nodejs - Axios - NodeJs"},{"label":"NodeJs - Native","value":"nodejs - Native - NodeJs"},{"label":"NodeJs - Request","value":"nodejs - Request - NodeJs"},{"label":"NodeJs - Unirest","value":"nodejs - Unirest - NodeJs"},{"label":"Objective-C - NSURLSession","value":"objective-c - NSURLSession - Objective-C"},{"label":"OCaml - Cohttp","value":"ocaml - Cohttp - OCaml"},{"label":"PHP - cURL","value":"php - cURL - PHP"},{"label":"PHP - Guzzle","value":"php - Guzzle - PHP"},{"label":"PHP - HTTP_Request2","value":"php - HTTP_Request2 - PHP"},{"label":"PHP - pecl_http","value":"php - pecl_http - PHP"},{"label":"PowerShell - RestMethod","value":"powershell - RestMethod - PowerShell"},{"label":"Python - http.client","value":"python - http.client - Python"},{"label":"Python - Requests","value":"python - Requests - Python"},{"label":"R - httr","value":"r - httr - R"},{"label":"R - RCurl","value":"r - RCurl - R"},{"label":"Ruby - Net::HTTP","value":"ruby - Net::HTTP - Ruby"},{"label":"Shell - Httpie","value":"shell - Httpie - Shell"},{"label":"Shell - wget","value":"shell - wget - Shell"},{"label":"Swift - URLSession","value":"swift - URLSession - Swift"}],"layoutOptions":[{"value":"classic-single-column","label":"Single Column"},{"value":"classic-double-column","label":"Double Column"}],"versionOptions":[],"environmentOptions":[{"value":"0","label":"No Environment"}],"canonicalUrl":"https://apidocs.airscout.com/view/metadata/7LhjRVE"}