action ptv_stops_stops_by_geolocation {
  label: "View all stops near a specific location"
  provider: ptv
  method: GET
  path: "/v3/stops/location/{latitude},{longitude}"
  encoding: json
  input: {
    type: "object"
    properties: {
      devid: {
        type: "string"
      }
      latitude: {
        type: "number"
        format: "float"
      }
      longitude: {
        type: "number"
        format: "float"
      }
      max_distance: {
        type: "number"
        format: "double"
      }
      max_results: {
        type: "integer"
        format: "int32"
      }
      route_types: {
        type: "array"
        items: {
          type: "integer"
          format: "int32"
          enum: [0, 1, 2, 3, 4]
        }
      }
      signature: {
        type: "string"
      }
      stop_disruptions: {
        type: "boolean"
      }
      token: {
        type: "string"
      }
    }
    required: ["latitude", "longitude"]
    additionalProperties: false
  }
  output: {
    type: "object"
    properties: {
      disruptions: {
        type: "object"
        description: "Disruption information applicable to relevant routes or stops"
      }
      status: {
        type: "object"
        properties: {
          health: {
            type: "integer"
            format: "int32"
            description: "API system health status (0=offline, 1=online)"
            enum: [0, 1]
          }
          version: {
            type: "string"
            description: "API Version number"
          }
        }
      }
      stops: {
        type: "array"
        description: "Train stations, tram stops, bus stops, regional coach stops or Night Bus stops"
        items: {
          type: "object"
          properties: {
            disruption_ids: {
              type: "array"
              description: "Disruption information identifier(s)"
              items: {
                type: "integer"
                format: "int64"
              }
            }
            route_type: {
              type: "integer"
              format: "int32"
              description: "Transport mode identifier"
            }
            routes: {
              type: "array"
              description: "List of routes travelling through the stop"
              items: {
                type: "object"
                properties: {}
              }
            }
            stop_distance: {
              type: "number"
              format: "float"
              description: "Distance of stop from input location (in metres); returns 0 if no location is input"
            }
            stop_id: {
              type: "integer"
              format: "int32"
              description: "Stop identifier"
            }
            stop_landmark: {
              type: "string"
              description: "Landmark in proximity of stop"
            }
            stop_latitude: {
              type: "number"
              format: "float"
              description: "Geographic coordinate of latitude at stop"
            }
            stop_longitude: {
              type: "number"
              format: "float"
              description: "Geographic coordinate of longitude at stop"
            }
            stop_name: {
              type: "string"
              description: "Name of stop"
            }
            stop_sequence: {
              type: "integer"
              format: "int32"
              description: "Sequence of the stop on the route/run; return 0 when route_id or run_id not specified. Order ascendingly by this field (when non zero) to get physical order (earliest first) of stops on the route_id/run_id."
            }
            stop_suburb: {
              type: "string"
              description: "suburb of stop"
            }
          }
        }
      }
    }
  }
}