示例#1
0
def iss_pass():

    # Sanitize inputs
    lat = request.args.get('lat', False)
    if lat:
        lat = safe_float(lat, (-90.0, 90.0))
        if not lat:
            return {
                "message": "failure",
                "reason": "Latitude must be number between -90.0 and 90.0"
            }, 400
    else:
        return {
            "message": "failure",
            "reason": "Latitude must be specified"
        }, 400

    lon = request.args.get('lon', False)
    if lon:
        lon = safe_float(lon, (-180.0, 180.0))
        if not lon:
            return {
                "message": "failure",
                "reason": "Longitue must be number between -180.0 and 180.0"
            }, 400
    else:
        return {
            "message": "failure",
            "reason": "Longitude must be specified"
        }, 400

    alt = request.args.get('alt', False)
    if alt:
        alt = safe_float(alt, (0, 10000))
        if not alt:
            return {
                "message": "failure",
                "reason": "Altitude must be number between 0 and 10,000"
            }, 400
    else:
        alt = 100

    n = request.args.get('n', False)
    if n:
        n = safe_float(n, (1, 100))
        if not n:
            return {
                "message": "failure",
                "reason": "Number of passes must be number between 1 and 100"
            }, 400
    else:
        n = 5

    # Calculate data and return
    d = iss.get_passes(lon, lat, alt, int(n))
    return dict({"message": "success"}, **d), 200
示例#2
0
def iss_pass():
    try:
        # Sanitize inputs
        lat = request.args.get('lat', False)
        if lat:
            lat = safe_float(lat, (-90.0, 90.0))
            if not lat:
                raise ValueError("Latitude must be number between -90.0 and 90.0")
        else:
            raise ValueError("Latitude must be specified.")
        lon = request.args.get('lon', False)
        if lon:
            lon = safe_float(lon, (-180.0, 180.0))
            if not lon:
                ValueError("Longitude must be number between -180.0 and 180.0")
        else:
            raise ValueError("Longitude must be specified.")
        alt = request.args.get('alt', False)
        if alt:
            alt = safe_float(alt, (0, 10000))
            if not alt:
                raise ValueError("Altitude must be number between 0 and 10,000")
        else:
            alt = 100

        n = request.args.get('n', False)
        if n:
            n = safe_float(n, (1, 100))
            if not n:
                raise ValueError("Number of passes must be number between 1 and 100")
        else:
            n = 5
    except ValueError as e:
        error_response = {"message": "failure", "reason": e.message, "request": request.args}
        return error_response, 400

    # Calculate data and return
    d = iss.get_passes(lon, lat, alt, int(n))
    return dict({"message": "success"}, **d), 200
示例#3
0
def iss_pass():
    """The international space station (ISS) is an orbital outpost circling
    high above out heads. Sometimes it's overhead, but when? It depends on your
    location. Given a location on Earth (latitude, longitude, and altitude)
    this API will compute the next n number of times that the ISS will be
    overhead.

    Overhead is defined as 10 degrees in elevation for the observer. The times
    are computed in UTC and the length of time that the ISS is above 10 degrees
    is in seconds.

    This gives you enough information to compute pass times for up to several
    weeks, but beware! times are less and less accurate as you go into the future.
    This is because the orbit of the ISS decays unpredictably over time and because
    station controllers periodically move the station to higher and lower orbits
    for docking, re-boost, and debris avoidance.

    **Overview**

    The API returns a list of upcoming ISS passes for a particular location
    formatted as JSON.

    As input it expects a latitude/longitude pair, altitude and how many results
    to return. All fields are required.

    As output you get the same inputs back (for checking) and a time stamp when
    the API ran in addition to a success or failure message and a list of passes.
    Each pass has a duration in seconds and a rise time as a unix time stamp.

    :status 200: when successful
    :status 400: if one or more inputs is out of range or invalid

    :query lat: latitude in decimal degrees of the ground station. **required** Range: -90, 90
    :query lon: longitude in decimal degress of the ground station. **required** Range: -180, 180
    :query alt: altitude in meters of the gronud station. optional. Range: 0, 10,000
    :query n: requested number of predictions. default: 5. May return less than requested

    :>json str message: Operation status.
    :>json obj request: Parameters used in prediction
    :>json list response: List of predicted passes

    **Example Request**:

    .. sourcecode:: http

        GET /iss/v1/?lat=40.027435&lon=-105.251945&alt=1650&n=1 HTTP/1.1
        Host: api.open-notify.org
        Accept: application/json, text/javascript


    **Example Response**:

    .. sourcecode:: http

        HTTP/1.1 200 OK
        Content-Type: application/json

        {
          "message": "success",
          "request": {
            "altitude": 1650.0,
            "datetime": 1454475126,
            "latitude": 40.027435,
            "longitude": -105.251945,
            "passes": 1
          },
          "response": [
            {
              "duration": 525,
              "risetime": 1454475538
            }
          ]
        }

    """

    # Sanitize inputs
    lat = request.args.get('lat', False)
    if lat:
        lat = safe_float(lat, (-90.0, 90.0))
        if not lat:
            return {
                "message": "failure",
                "reason": "Latitude must be number between -90.0 and 90.0"
            }, 400
    else:
        return {
            "message": "failure",
            "reason": "Latitude must be specified"
        }, 400

    lon = request.args.get('lon', False)
    if lon:
        lon = safe_float(lon, (-180.0, 180.0))
        if not lon:
            return {
                "message": "failure",
                "reason": "Longitue must be number between -180.0 and 180.0"
            }, 400
    else:
        return {
            "message": "failure",
            "reason": "Longitude must be specified"
        }, 400

    alt = request.args.get('alt', False)
    if alt:
        alt = safe_float(alt, (0, 10000))
        if not alt:
            return {
                "message": "failure",
                "reason": "Altitude must be number between 0 and 10,000"
            }, 400
    else:
        alt = 100

    n = request.args.get('n', False)
    if n:
        n = safe_float(n, (1, 100))
        if not n:
            return {
                "message": "failure",
                "reason": "Number of passes must be number between 1 and 100"
            }, 400
    else:
        n = 5

    # Calculate data and return
    d = iss.get_passes(lon, lat, alt, int(n))
    return dict({"message": "success"}, **d), 200
示例#4
0
def iss_pass():
    """The international space station (ISS) is an orbital outpost circling
    high above out heads. Sometimes it's overhead, but when? It depends on your
    location. Given a location on Earth (latitude, longitude, and altitude)
    this API will compute the next n number of times that the ISS will be
    overhead.

    Overhead is defined as 10 degrees in elevation for the observer. The times
    are computed in UTC and the length of time that the ISS is above 10 degrees
    is in seconds.

    This gives you enough information to compute pass times for up to several
    weeks, but beware! times are less and less accurate as you go into the future.
    This is because the orbit of the ISS decays unpredictably over time and because
    station controllers periodically move the station to higher and lower orbits
    for docking, re-boost, and debris avoidance.

    **Overview**

    The API returns a list of upcoming ISS passes for a particular location
    formatted as JSON.

    As input it expects a latitude/longitude pair, altitude and how many results
    to return. All fields are required.

    As output you get the same inputs back (for checking) and a time stamp when
    the API ran in addition to a success or failure message and a list of passes.
    Each pass has a duration in seconds and a rise time as a unix time stamp.

    :status 200: when successful
    :status 400: if one or more inputs is out of range or invalid

    :query lat: latitude in decimal degrees of the ground station. **required** Range: -90, 90
    :query lon: longitude in decimal degress of the ground station. **required** Range: -180, 180
    :query alt: altitude in meters of the gronud station. optional. Range: 0, 10,000
    :query n: requested number of predictions. default: 5. May return less than requested

    :>json str message: Operation status.
    :>json obj request: Parameters used in prediction
    :>json list response: List of predicted passes

    **Example Request**:

    .. sourcecode:: http

        GET /iss/v1/?lat=40.027435&lon=-105.251945&alt=1650&n=1 HTTP/1.1
        Host: api.open-notify.org
        Accept: application/json, text/javascript


    **Example Response**:

    .. sourcecode:: http

        HTTP/1.1 200 OK
        Content-Type: application/json

        {
          "message": "success",
          "request": {
            "altitude": 1650.0,
            "datetime": 1454475126,
            "latitude": 40.027435,
            "longitude": -105.251945,
            "passes": 1
          },
          "response": [
            {
              "duration": 525,
              "risetime": 1454475538
            }
          ]
        }

    """

    # Sanitize inputs
    lat = request.args.get('lat', False)
    if lat:
        lat = safe_float(lat, (-90.0, 90.0))
        if not lat:
            return {"message": "failure", "reason": "Latitude must be number between -90.0 and 90.0"}, 400
    else:
        return {"message": "failure", "reason": "Latitude must be specified"}, 400

    lon = request.args.get('lon', False)
    if lon:
        lon = safe_float(lon, (-180.0, 180.0))
        if not lon:
            return {"message": "failure", "reason": "Longitue must be number between -180.0 and 180.0"}, 400
    else:
        return {"message": "failure", "reason": "Longitude must be specified"}, 400

    alt = request.args.get('alt', False)
    if alt:
        alt = safe_float(alt, (0, 10000))
        if not alt:
            return {"message": "failure", "reason": "Altitude must be number between 0 and 10,000"}, 400
    else:
        alt = 100

    n = request.args.get('n', False)
    if n:
        n = safe_float(n, (1, 100))
        if not n:
            return {"message": "failure", "reason": "Number of passes must be number between 1 and 100"}, 400
    else:
        n = 5

    # Calculate data and return
    d = iss.get_passes(lon, lat, alt, int(n))
    return dict({"message": "success"}, **d), 200