Get IQAir air-quality map data

Review IQAir’s global air-quality map overview, with grouped map locations, reported air-quality index values and the number of stations represented.

Your AI

Use with your AI

For tasks with several steps, continue in the AI you already use.

CodexClaude CodeCursorWindsurfCline

View instructions

Use Toolmu get-air-quality-map-data-iqair to inspect the default global map view. Reuse a working Toolmu connection or follow https://toolmu.com/SKILL.md to connect. Check current inputs, availability and credit ceiling, keeping requests within my authorization and total budget. For this example omit the optional area boundary and zoom inputs rather than requiring me to provide coordinates. If I separately request a city or region, ask for its familiar name and country and obtain reliable actual map boundaries through a supported lookup before preparing the optional boundary internally. Do not infer city boundaries from a name, invent coordinates or describe global results as local results. If reliable boundaries are unavailable, explain this and clarify whether I want the supported global overview. Read each returned group’s position, source air-quality index and represented station count together. A marker is a grouped location, not an individual measurement, complete inventory or guaranteed current reading. Do not invent measurement time, concentration units, index standard, grouping method or health guidance.

Task:
Get IQAir’s global air-quality map overview. Summarize the returned map locations, reported air-quality index values and station counts, and explain that grouped map markers are different from individual station readings.

Paste into your connected AI's conversation.

Connection guide

Up to 0.012 credits / call

The final charge is based on confirmed usage. Unused reserved credits return to your available balance.

IQAir

Get IQAir air-quality map data

Review IQAir’s global air-quality map overview, with grouped map locations, reported air-quality index values and the number of stations represented.

You receive

Review grouped map locations with the source’s air-quality index and number of represented stations. The default global view can be requested without preparing map coordinates.

Start with your task

Get IQAir’s global air-quality map overview. Summarize the returned map locations, reported air-quality index values and station counts, and explain that grouped map markers are different from individual station readings.

What to know

Grouped markers are not individual station readings or a complete station list. The result does not provide measurement time, pollutant concentrations, the index standard or grouping method, and cannot establish health or safety conditions.

Inputs & outputs

Inspect the current inputs, availability, and maximum charge before starting.

Input schema

Input schema
Field / Path	Type	Requirement	Meaning
Map view options`queryParams`	`object`	Optional	Optionally set the bounding box and map zoom. No location-name or date input is provided.
Bounding box`queryParams.bbox`	`string`	Optional	Optional comma-separated minLng,minLat,maxLng,maxLat string, for example -122.5,37.0,-121.5,38.0. Omitting it requests global map data.
Map zoom`queryParams.zoom`	`integer`	Optional	Optional integer zoom level, documented from 1 to 20. Higher zoom levels produce finer clusters with fewer stations per group.

View raw JSON

{
  "type": "object",
  "required": [],
  "properties": {
    "queryParams": {
      "type": "object",
      "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'). Omitting returns global data."
        },
        "zoom": {
          "type": "integer",
          "description": "Map zoom level (1-20). Higher values return more granular clusters with fewer stations per cluster."
        }
      },
      "additionalProperties": false
    }
  },
  "additionalProperties": false
}

Result schema

No fixed output contract is available. Field types reflect saved result evidence; individual responses can differ.

Result schema
Field / Path	Type	Meaning
Map markers`result.data.markers`	`array`	Returned collection of geographic map markers. Cluster records combine station data for the selected map view.
Marker type`result.data.markers[].type`	`string`	Source marker type. The cluster value identifies a grouped map marker; read it together with stationsCount.
Cluster AQI`result.data.markers[].aqi`	`number`	Source-reported aggregated AQI for the marker. Keep the numeric value as supplied; it is not a pollutant concentration or an individual station reading.
Marker latitude`result.data.markers[].coordinates.latitude`	`number`	Latitude of the returned marker location. For a cluster, this is a grouped map position, not a confirmed sensor location.
Marker longitude`result.data.markers[].coordinates.longitude`	`number`	Longitude of the returned marker location; use it with latitude to locate the grouped marker.
Stations represented`result.data.markers[].stationsCount`	`number`	Number of stations the source reports for this marker. It is a grouping count, not a count of AQI measurements or a complete regional inventory.

Additional notes

Define the map view with bbox in longitude, latitude order: minLng,minLat,maxLng,maxLat. Omitting bbox requests the source’s global map data. Zoom controls grouping detail: the documented range is 1–20, with higher levels producing finer clusters and fewer stations per cluster.

Read stationsCount alongside the marker type and location. A cluster combines station data for a map display; its coordinate is a marker location, not proof of an individual sensor at that point. Changing zoom changes the grouping, so marker counts are not a station inventory.

Keep the AQI value as reported. It is an index value rather than a pollutant concentration, and the result does not identify its measurement period or calculation method. Use it to inspect the source’s returned map grouping without converting it into concentration units or a health classification. Review the current Tool input requirements

Questions about this tool.

Inputs, results and details to know before running it.

Get connected

Tell your assistant the city and country so it can first confirm a reliable map area. A city name alone does not define the exact map boundaries. This example starts with the supported global overview.

Get IQAir air-quality map data

Get IQAir air-quality map data

You receive

Start with your task

What to know

Inputs & outputs

Input schema

Result schema

Send the ready-to-use example

Start with the global map view

Read grouped map information

Questions about this tool.

You receive

Start with your task

What to know

Inputs & outputs

Input schema

Result schema

Send the ready-to-use example

Start with the global map view

Read grouped map information

Questions about this tool.

What if I want to see a particular city?