FootprintServices Web Service

FootprintServices

Click here for a complete list of operations.

FindByPositions

Returns all footprints containing all the specified positions.
Input 1: The user ID (type of string)
Input 2: The RA of the position (type of double)
Input 3: The Dec of the position (type of double)
Output: The footprint headers (type of Footprint[])

Test

The test form is only available for requests from the local machine.

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 /footprint/ws_v1_1/FootprintServices.asmx HTTP/1.1
Host: voservices.net
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: "ivo://voservices.net/footprint/FindByPositions"

<?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>
    <FindByPositions xmlns="ivo://voservices.net/footprint">
      <userGuid>string</userGuid>
      <pos>
        <RaDecPair>
          <Ra>double</Ra>
          <Dec>double</Dec>
        </RaDecPair>
        <RaDecPair>
          <Ra>double</Ra>
          <Dec>double</Dec>
        </RaDecPair>
      </pos>
    </FindByPositions>
  </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>
    <FindByPositionsResponse xmlns="ivo://voservices.net/footprint">
      <FindByPositionsResult>
        <Footprint>
          <STCRegion>
            <AstroCoordSystem xsi:nil="true" xmlns="http://www.ivoa.net/xml/STC/stc-v1.30.xsd" />
          </STCRegion>
        </Footprint>
        <Footprint>
          <STCRegion>
            <AstroCoordSystem xsi:nil="true" xmlns="http://www.ivoa.net/xml/STC/stc-v1.30.xsd" />
          </STCRegion>
        </Footprint>
      </FindByPositionsResult>
    </FindByPositionsResponse>
  </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 /footprint/ws_v1_1/FootprintServices.asmx HTTP/1.1
Host: voservices.net
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>
    <FindByPositions xmlns="ivo://voservices.net/footprint">
      <userGuid>string</userGuid>
      <pos>
        <RaDecPair>
          <Ra>double</Ra>
          <Dec>double</Dec>
        </RaDecPair>
        <RaDecPair>
          <Ra>double</Ra>
          <Dec>double</Dec>
        </RaDecPair>
      </pos>
    </FindByPositions>
  </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>
    <FindByPositionsResponse xmlns="ivo://voservices.net/footprint">
      <FindByPositionsResult>
        <Footprint>
          <STCRegion>
            <AstroCoordSystem xsi:nil="true" xmlns="http://www.ivoa.net/xml/STC/stc-v1.30.xsd" />
          </STCRegion>
        </Footprint>
        <Footprint>
          <STCRegion>
            <AstroCoordSystem xsi:nil="true" xmlns="http://www.ivoa.net/xml/STC/stc-v1.30.xsd" />
          </STCRegion>
        </Footprint>
      </FindByPositionsResult>
    </FindByPositionsResponse>
  </soap12:Body>
</soap12:Envelope>