2.1 GET Request Examples

     - GetCDLValue
        By Year and X, Y Coordinate:
            https://nassgeodata.gmu.edu/axis2/services/CDLService/GetCDLValue?year=2018&x=1551565.363&y=1909363.537

     - GetCDLFile
        By Year and FIPS (or ASD):
            1) One FIPS or ASD Code:
                https://nassgeodata.gmu.edu/axis2/services/CDLService/GetCDLFile?year=2018&fips=19015
            2) Two or More FIPS or ASD Codes (separated by ","):
                https://nassgeodata.gmu.edu/axis2/services/CDLService/GetCDLFile?year=2018&fips=19003,19029
        By Year and Bounding Box:
            https://nassgeodata.gmu.edu/axis2/services/CDLService/GetCDLFile?year=2018&bbox=130783,2203171,153923,2217961
        By Year and Multiple Points:
            https://nassgeodata.gmu.edu/axis2/services/CDLService/GetCDLFile?year=2018&points=175207,2219600,175207,2235525,213693,2235525,213693,2219600
        By Year and Uploaded Vector File, URL of a GML file or a compressed ESRI Shapefile (the .shp, .shx, .dbf, and .prj files must be compressed without directory in a .zip file):
            https://nassgeodata.gmu.edu/axis2/services/CDLService/GetCDLFile?year=2018&aoiURL=https://crop.csiss.gmu.edu/data/York_SF_watershed.zip

     - GetCDLImage
        General Instruction:
This service takes valid input geotiff files of CDL to convert their format into PNG or KML formats. Multiple files (URLs) can be provided and processed in batch. The files (URLs) can be obtained from the the above "GetCDLFile" services. For example, the request https://nassgeodata.gmu.edu/axis2/services/CDLService/GetCDLFile?year=2018&fips=19015 would return the following.

         <ns1:GetCDLFileResponse xmlns:ns1="http://cropscape.csiss.gmu.edu/CDLService/"> <returnURL> https://nassgeodata.gmu.edu/webservice/nass_data_cache/byfips/CDL_2018_19015.tif </returnURL> </ns1:GetCDLFileResponse>

The URL https://nassgeodata.gmu.edu/webservice/nass_data_cache/byfips/CDL_2018_19015.tif can be used as a file in the requests to be described. Similarly, the request https://nassgeodata.gmu.edu/axis2/services/CDLService/GetCDLFile?year=2018&fips=19015 would return a URL https://nassgeodata.gmu.edu/webservice/nass_data_cache/byfips/CDL_2018_19015.tif . These two URLs will be used in the examples in the section. The assumptions are that these two service requests have been invoked before the examples to be discussed successfully run. Other forms of request, including user-uploaded polygon, would be applicable as long as the returned URL is a valid geotiff file.
        In PNG Format:
            1) One CDL File Link:
                https://nassgeodata.gmu.edu/axis2/services/CDLService/GetCDLImage?files=https://nassgeodata.gmu.edu/webservice/nass_data_cache/byfips/CDL_2018_19015.tif&format=png
            2) Two or More CDL File Links (separated by ","):
                https://nassgeodata.gmu.edu/axis2/services/CDLService/GetCDLImage?files=https://nassgeodata.gmu.edu/webservice/nass_data_cache/byfips/CDL_2018_19015.tif,https://nassgeodata.gmu.edu/webservice/nass_data_cache/byfips/CDL_2017_19015.tif&format=png
        In KML Format:
            1) One CDL File Link:
                https://nassgeodata.gmu.edu/axis2/services/CDLService/GetCDLImage?files=https://nassgeodata.gmu.edu/webservice/nass_data_cache/byfips/CDL_2018_19015.tif&format=kml
            2) Two or More CDL File Links:
                https://nassgeodata.gmu.edu/axis2/services/CDLService/GetCDLImage?files=https://nassgeodata.gmu.edu/webservice/nass_data_cache/byfips/CDL_2018_19015.tif,https://nassgeodata.gmu.edu/webservice/nass_data_cache/byfips/CDL_2017_19015.tif&format=kml

     - GetCDLStat
        BY Year, FIPS (or ASD), and TXT(or CSV, JSON):
            1) One FIPS or ASD Code:
                https://nassgeodata.gmu.edu/axis2/services/CDLService/GetCDLStat?year=2018&fips=19015&format=txt
            2) Two or More FIPS or ASD Codes (separated by ","):
                https://nassgeodata.gmu.edu/axis2/services/CDLService/GetCDLStat?year=2018&fips=19003,19029&format=csv
        By Year, Bounding box and JSON:
            https://nassgeodata.gmu.edu/axis2/services/CDLService/GetCDLStat?year=2018&bbox=130783,2203171,153923,2217961&format=json
        By Year, Points and CSV:
            https://nassgeodata.gmu.edu/axis2/services/CDLService/GetCDLStat?year=2018&points=175207,2219600,175207,2235525,213693,2235525,213693,2219600&format=csv
        By Year, Uploaded Vector File, URL of a GML file or a compressed ESRI Shapefile (the .shp, .shx, .dbf, and .prj files must be compressed without directory in a .zip file), and TXT:
            https://nassgeodata.gmu.edu/axis2/services/CDLService/GetCDLStat?year=2018&aoiURL=https://crop.csiss.gmu.edu/data/York_SF_watershed.zip&format=txt

     - GetCDLComp
         By Year, FIPS (or ASD) and CSV (or JSON):
            1) One FIPS or ASD Code:
                https://nassgeodata.gmu.edu/axis2/services/CDLService/GetCDLComp?year1=2018&year2=2017&fips=19003,19015&format=csv
            2) Two or More FIPS or ASD Codes (separated by ","):
                https://nassgeodata.gmu.edu/axis2/services/CDLService/GetCDLComp?year1=2018&year2=2017&fips=19003,19029&format=json
        By Year, Bounding box and JSON:
            https://nassgeodata.gmu.edu/axis2/services/CDLService/GetCDLComp?year1=2018&year2=2017&bbox=130783,2203171,153923,2217961&format=json
        By Year, Points and CSV:
            https://nassgeodata.gmu.edu/axis2/services/CDLService/GetCDLComp?year1=2018&year2=2017&points=175207,2219600,175207,2235525,213693,2235525,213693,2219600&format=csv
        By Year, Uploaded Vector File, URL of a GML file or a compressed ESRI Shapefile (the .shp, .shx, .dbf, and .prj files must be compressed without directory in a .zip file), and CSV:
            https://nassgeodata.gmu.edu/axis2/services/CDLService/GetCDLComp?year1=2018&year2=2017&aoiURL=https://crop.csiss.gmu.edu/data/York_SF_watershed.zip&format=csv

     - ExtractCDLByValues
        CDL File Link and Crop Value(s):
            1) One Crop Category:
                https://nassgeodata.gmu.edu/axis2/services/CDLService/ExtractCDLByValues?file=https://nassgeodata.gmu.edu/webservice/nass_data_cache/byfips/CDL_2018_19015.tif&values=1
            2) Two or More Crop Categories (separated by ","):
                https://nassgeodata.gmu.edu/axis2/services/CDLService/ExtractCDLByValues?file=https://nassgeodata.gmu.edu/webservice/nass_data_cache/byfips/CDL_2018_19015.tif&values=1,5

     - CreatePDF
         By Year, FIPS (or ASD), Paper Size and Title(use %20 for space):
            1) One FIPS or ASD Code:
                https://nassgeodata.gmu.edu/axis2/services/CDLService/GetCDLPDF?year=2018&fips=19015&papersize=Letter&title=2018%20CDL
              For State, Specify the flag of displaying County Boundaries:
                https://nassgeodata.gmu.edu/axis2/services/CDLService/GetCDLPDF?year=2018&fips=19015&papersize=Letter&title=2018%20Iowa%20CDL&boundaryflag=true
            2) Two or More FIPS or ASD Codes (separated by ","):
                https://nassgeodata.gmu.edu/axis2/services/CDLService/GetCDLPDF?year=2018&fips=19003,19029&papersize=A4&title=2018%20CDL
        By Year, Bounding Box, Paper Size and Title(use %20 for space):
            https://nassgeodata.gmu.edu/axis2/services/CDLService/GetCDLPDF?year=2018&bbox=130783,2203171,153923,2217961&papersize=Letter&title=2018%20CDL
        By Year, Points, Paper Size and Title(use %20 for space):
            https://nassgeodata.gmu.edu/axis2/services/CDLService/GetCDLPDF?year=2018&points=175207,2219600,175207,2235525,213693,2235525,213693,2219600&papersize=Letter&title=2018%20CDL
        By Year, Uploaded Vector File, URL of a GML file or a compressed ESRI Shapefile (the .shp, .shx, .dbf, and .prj files must be compressed without directory in a .zip file), Paper Size and Title(use %20 for space):
            https://nassgeodata.gmu.edu/axis2/services/CDLService/GetCDLPDF?year=2018&aoiURL=https://crop.csiss.gmu.edu/data/York_SF_watershed.zip&papersize=Letter&title=2018%20CDL%20Within%20AOI

    Note: All coordinates must be in the projection of USA Contiguous Albers Equal Area Conic (USGS version).