Air Quality Map Clusters (by Bounding Box)

{
  "type": "object",
  "required": [
    "bbox"
  ],
  "properties": {
    "bbox": {
      "type": "string",
      "description": "Bounding box as comma-separated string: minLng,minLat,maxLng,maxLat (e.g. '-122.5,37.0,-121.5,38.0'). Required -- identifies the geographic area to query."
    },
    "zoom": {
      "type": "integer",
      "description": "Map zoom level (1-20). Higher values return more granular clusters with fewer stations per cluster."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "status",
    "data"
  ],
  "properties": {
    "data": {
      "type": "object",
      "required": [
        "markers"
      ],
      "properties": {
        "markers": {
          "type": "array",
          "items": {
            "type": "object",
            "required": [
              "type",
              "geohash",
              "stationsCount",
              "coordinates",
              "aqi"
            ],
            "properties": {
              "aqi": {
                "type": "number",
                "description": "Air quality index for this marker -- the cluster's average on a 'cluster' type marker, or that one station's own reading on a 'station' type marker."
              },
              "name": {
                "type": "string",
                "description": "The individual monitoring station's display name -- only present when `type` is 'station', never on a 'cluster' marker (see the sf-bay-area-zoom8 fixture, where only 1 of 22 markers carries this field)."
              },
              "type": {
                "type": "string",
                "description": "Either 'cluster' (an aggregate of nearby stations) or 'station' (a single resolved monitoring station) -- both values observed on the same real call at zoom 8."
              },
              "geohash": {
                "type": "string",
                "description": "The geohash cell this marker was clustered into."
              },
              "coordinates": {
                "type": "object",
                "required": [
                  "latitude",
                  "longitude"
                ],
                "properties": {
                  "latitude": {
                    "type": "number"
                  },
                  "longitude": {
                    "type": "number"
                  }
                },
                "additionalProperties": false
              },
              "stationsCount": {
                "type": "integer",
                "description": "Number of monitoring stations grouped into this marker; 1 on every 'station' type marker observed."
              }
            },
            "additionalProperties": false
          },
          "description": "Empty when no monitoring stations fall inside the given bbox (see the pacific-ocean-empty fixture); otherwise one entry per cluster or, at high zoom over a sparse area, one entry per individual station."
        }
      },
      "additionalProperties": false
    },
    "status": {
      "type": "string",
      "description": "'success' on both real calls observed."
    }
  },
  "description": "The map-cluster record, as returned at routing.responseResultPath ($.output). A bounding box with no monitoring stations in it returns `data.markers` as an empty array rather than omitting the field -- see the pacific-ocean-empty fixture.",
  "additionalProperties": false
}