ImgCutout Web Service

ImgCutout

Click here for a complete list of operations.

GetJpegQuery

Returns the bytes of the Jpeg image for a given pointing.
Input 1: RA in degrees (double)
Input 2: Dec in degrees (double)
Input 3: Scale, in arcsec/pixel (double)
Input 4: Width in pixels (int)
Input 5: Height in pixels (int)
Input 6: Drawing options (string)
Input 7: Marking selection (string)
The marking selection string can be:

List of objects. RA and DEC columns must be included. Example:

ObjId RA DEC RMag
582378008234755083 195.578582 2.548192 23.565
582378008234754800 195.572594 2.554787 21.446
SELECT SQL query. RA and DEC columns must be included. Example:

'SELECT top 10 p.objID, p.ra, p.dec, p.r
FROM fGetObjFromRect(195.5,195.65,2.5,2.6) n, PhotoPrimary p
WHERE n.objID=p.objID'
String following the pattern: ObjType Band (low_mag, high_mag)
- ObjType: S | G | P
  S for Stars
  G for Galaxies
  P for both Stars and Galaxies
- Band: U | G | R | I | Z | A
  to select objects with Band BETWEEN low_mag AND high_mag
  
  Band 'A' will look for all the objects with values betwen low_mag and high_mag for any band (compositions of ORs).
  Only Stars, Galaxies, or PhotoPrimary objects will be marked when magnitude ranges are not specified. Examples:
  
  S
  S R (0.0, 23.5)
  G A (10, 25)

Output: Image (byte[])

Test

To test the operation using the HTTP POST protocol, click the 'Invoke' button.

Parameter	Value
ra_:
dec_:
scale_:
width_:
height_:
opt_:
query_:

SOAP 1.1

The following is a sample SOAP 1.1 request and response. The placeholders shown need to be replaced with actual values.

POST /DR7/ImgCutout/imgcutout.asmx HTTP/1.1
Host: skyservice.pha.jhu.edu
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: "http://skyserver.sdss.org/GetJpegQuery"

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <GetJpegQuery xmlns="http://skyserver.sdss.org/">
      <ra_>double</ra_>
      <dec_>double</dec_>
      <scale_>double</scale_>
      <width_>int</width_>
      <height_>int</height_>
      <opt_>string</opt_>
      <query_>string</query_>
    </GetJpegQuery>
  </soap:Body>
</soap:Envelope>

HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <GetJpegQueryResponse xmlns="http://skyserver.sdss.org/">
      <GetJpegQueryResult>base64Binary</GetJpegQueryResult>
    </GetJpegQueryResponse>
  </soap:Body>
</soap:Envelope>

SOAP 1.2

The following is a sample SOAP 1.2 request and response. The placeholders shown need to be replaced with actual values.

POST /DR7/ImgCutout/imgcutout.asmx HTTP/1.1
Host: skyservice.pha.jhu.edu
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
  <soap12:Body>
    <GetJpegQuery xmlns="http://skyserver.sdss.org/">
      <ra_>double</ra_>
      <dec_>double</dec_>
      <scale_>double</scale_>
      <width_>int</width_>
      <height_>int</height_>
      <opt_>string</opt_>
      <query_>string</query_>
    </GetJpegQuery>
  </soap12:Body>
</soap12:Envelope>

HTTP/1.1 200 OK
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
  <soap12:Body>
    <GetJpegQueryResponse xmlns="http://skyserver.sdss.org/">
      <GetJpegQueryResult>base64Binary</GetJpegQueryResult>
    </GetJpegQueryResponse>
  </soap12:Body>
</soap12:Envelope>

HTTP GET

The following is a sample HTTP GET request and response. The placeholders shown need to be replaced with actual values.

GET /DR7/ImgCutout/imgcutout.asmx/GetJpegQuery?ra_=string&dec_=string&scale_=string&width_=string&height_=string&opt_=string&query_=string HTTP/1.1
Host: skyservice.pha.jhu.edu

HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<base64Binary xmlns="http://skyserver.sdss.org/">base64Binary</base64Binary>

HTTP POST

The following is a sample HTTP POST request and response. The placeholders shown need to be replaced with actual values.

POST /DR7/ImgCutout/imgcutout.asmx/GetJpegQuery HTTP/1.1
Host: skyservice.pha.jhu.edu
Content-Type: application/x-www-form-urlencoded
Content-Length: length

ra_=string&dec_=string&scale_=string&width_=string&height_=string&opt_=string&query_=string

HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<base64Binary xmlns="http://skyserver.sdss.org/">base64Binary</base64Binary>

ObjId	RA	DEC	RMag
582378008234755083	195.578582	2.548192	23.565
582378008234754800	195.572594	2.554787	21.446