# Maps Weather API

> Maps Weather API on Apizie: 18 endpoints (Use to get current air quality information that includes potential risks and suggested precautions., Use to get daily air quality forecasts for the next one to seven days that include pollutant levels,…, Use to get hourly air quality forecasts for the next one to 96 hours that include pollutant levels,…, Use to get current weather conditions., …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://apizie.tech/v1/cloud:azure-maps-weather/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `cloud:azure-maps-weather`
- Category: Cloud
- Status: byok
- Source: https://learn.microsoft.com/rest/api/azure/
- Page: https://apizie.tech/api/cloud/azure-maps-weather
- OpenAPI: https://apizie.tech/api/cloud/azure-maps-weather/openapi.json

Azure Maps Weather REST APIs

## Endpoints

### Use to get current air quality information that includes potential risks and suggested precautions.
`GET https://apizie.tech/v1/cloud:azure-maps-weather/weather-get-current-air-quality` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | The Azure Maps service hostname. Use `https://atlas.microsoft.com` for the Azure public cloud. To target a specific Azure Maps geography… |
| api-version | string | no | The API version to use for this operation. |
| format | string | yes | Desired format of the response. Only `json` format is supported. |
| x-ms-client-id | string | no | Indicates the account intended for use with the Microsoft Entra ID security model. This unique ID for the Azure Maps account can be… |
| language | string | no | Language in which search results should be returned. Should be one of supported IETF language tags, case insensitive. When data in… |
| query | array | yes | The applicable query specified as a comma separated string composed by latitude followed by longitude e.g. "47.641268,-122.125679".… |
| pollutants | boolean | no | Boolean value that returns detailed information about each pollutant. By default is True. |

### Use to get daily air quality forecasts for the next one to seven days that include pollutant levels,…
`GET https://apizie.tech/v1/cloud:azure-maps-weather/weather-get-air-quality-daily-forecasts` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | The Azure Maps service hostname. Use `https://atlas.microsoft.com` for the Azure public cloud. To target a specific Azure Maps geography… |
| api-version | string | no | The API version to use for this operation. |
| format | string | yes | Desired format of the response. Only `json` format is supported. |
| x-ms-client-id | string | no | Indicates the account intended for use with the Microsoft Entra ID security model. This unique ID for the Azure Maps account can be… |
| language | string | no | Language in which search results should be returned. Should be one of supported IETF language tags, case insensitive. When data in… |
| query | array | yes | The applicable query specified as a comma separated string composed by latitude followed by longitude e.g. "47.641268,-122.125679".… |
| duration | number | no | Defines the duration for the air quality forecast, with options ranging from 1 to 7 days. The default duration is 1 day. |

### Use to get hourly air quality forecasts for the next one to 96 hours that include pollutant levels,…
`GET https://apizie.tech/v1/cloud:azure-maps-weather/weather-get-air-quality-hourly-forecasts` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | The Azure Maps service hostname. Use `https://atlas.microsoft.com` for the Azure public cloud. To target a specific Azure Maps geography… |
| api-version | string | no | The API version to use for this operation. |
| format | string | yes | Desired format of the response. Only `json` format is supported. |
| x-ms-client-id | string | no | Indicates the account intended for use with the Microsoft Entra ID security model. This unique ID for the Azure Maps account can be… |
| language | string | no | Language in which search results should be returned. Should be one of supported IETF language tags, case insensitive. When data in… |
| query | array | yes | The applicable query specified as a comma separated string composed by latitude followed by longitude e.g. "47.641268,-122.125679".… |
| duration | number | no | Defines the duration, in hours, for the air quality forecast. Available values are 1, 12, 24, 48, 72, and 96. The default value is 1 hour. |
| pollutants | boolean | no | Boolean value that returns detailed information about each pollutant. By default is True. |

### Use to get current weather conditions.
`GET https://apizie.tech/v1/cloud:azure-maps-weather/weather-get-current-conditions` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | The Azure Maps service hostname. Use `https://atlas.microsoft.com` for the Azure public cloud. To target a specific Azure Maps geography… |
| api-version | string | no | The API version to use for this operation. |
| format | string | yes | Desired format of the response. Only `json` format is supported. |
| x-ms-client-id | string | no | Indicates the account intended for use with the Microsoft Entra ID security model. This unique ID for the Azure Maps account can be… |
| query | array | yes | The applicable query specified as a comma separated string composed by latitude followed by longitude e.g. "47.641268,-122.125679".… |
| unit | string | no | Specifies to return the data in either metric units or imperial units. Default value is metric. |
| details | string | no | Return full details for the current conditions. Available values are * `true` - Returns full details. By default all details are returned.… |
| duration | integer | no | Time frame of the returned weather conditions. By default, the most current weather conditions will be returned. Default value is 0.… |
| language | string | no | Language in which search results should be returned. Should be one of supported IETF language tags, case insensitive. When data in… |

### Use to get a daily detailed weather forecast for the next 1, 5, 10, 15, 25, or 45 days.
`GET https://apizie.tech/v1/cloud:azure-maps-weather/weather-get-daily-forecast` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | The Azure Maps service hostname. Use `https://atlas.microsoft.com` for the Azure public cloud. To target a specific Azure Maps geography… |
| api-version | string | no | The API version to use for this operation. |
| format | string | yes | Desired format of the response. Only `json` format is supported. |
| x-ms-client-id | string | no | Indicates the account intended for use with the Microsoft Entra ID security model. This unique ID for the Azure Maps account can be… |
| query | array | yes | The applicable query specified as a comma separated string composed by latitude followed by longitude e.g. "47.641268,-122.125679".… |
| unit | string | no | Specifies to return the data in either metric units or imperial units. Default value is metric. |
| duration | integer | no | Specifies for how many days the daily forecast responses are returned. Available values are * `1` - Return forecast data for the next day.… |
| language | string | no | Language in which search results should be returned. Should be one of supported IETF language tags, case insensitive. When data in… |

### Use to get a detailed hourly weather forecast for up to 24 hours or a daily forecast for up to 10 days.
`GET https://apizie.tech/v1/cloud:azure-maps-weather/weather-get-hourly-forecast` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | The Azure Maps service hostname. Use `https://atlas.microsoft.com` for the Azure public cloud. To target a specific Azure Maps geography… |
| api-version | string | no | The API version to use for this operation. |
| format | string | yes | Desired format of the response. Only `json` format is supported. |
| x-ms-client-id | string | no | Indicates the account intended for use with the Microsoft Entra ID security model. This unique ID for the Azure Maps account can be… |
| query | array | yes | The applicable query specified as a comma separated string composed by latitude followed by longitude e.g. "47.641268,-122.125679".… |
| unit | string | no | Specifies to return the data in either metric units or imperial units. Default value is metric. |
| duration | integer | no | Time frame of the returned weather forecast. By default, the forecast data for next hour will be returned. Available values are * `1` -… |
| language | string | no | Language in which search results should be returned. Should be one of supported IETF language tags, case insensitive. When data in… |

### Use to get a minute-by-minute forecast for the next 120 minutes in intervals of 1, 5 and 15 minutes.
`GET https://apizie.tech/v1/cloud:azure-maps-weather/weather-get-minute-forecast` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | The Azure Maps service hostname. Use `https://atlas.microsoft.com` for the Azure public cloud. To target a specific Azure Maps geography… |
| api-version | string | no | The API version to use for this operation. |
| format | string | yes | Desired format of the response. Only `json` format is supported. |
| x-ms-client-id | string | no | Indicates the account intended for use with the Microsoft Entra ID security model. This unique ID for the Azure Maps account can be… |
| query | array | yes | The applicable query specified as a comma separated string composed by latitude followed by longitude e.g. "47.641268,-122.125679".… |
| interval | integer | no | Specifies time interval in minutes for the returned weather forecast. Supported values are * `1` - Retrieve forecast for 1-minute… |
| language | string | no | Language in which search results should be returned. Should be one of supported IETF language tags, case insensitive. When data in… |

### Use to get a Quarter-Day Forecast for the next 1, 5, 10, or 15 days.
`GET https://apizie.tech/v1/cloud:azure-maps-weather/weather-get-quarter-day-forecast` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | The Azure Maps service hostname. Use `https://atlas.microsoft.com` for the Azure public cloud. To target a specific Azure Maps geography… |
| api-version | string | no | The API version to use for this operation. |
| format | string | yes | Desired format of the response. Only `json` format is supported. |
| x-ms-client-id | string | no | Indicates the account intended for use with the Microsoft Entra ID security model. This unique ID for the Azure Maps account can be… |
| query | array | yes | The applicable query specified as a comma separated string composed by latitude followed by longitude e.g. "47.641268,-122.125679".… |
| unit | string | no | Specifies to return the data in either metric units or imperial units. Default value is metric. |
| duration | integer | no | Specifies for how many days the quester-day forecast responses are returned. Supported values are: * `1` - Return forecast data for the… |
| language | string | no | Language in which search results should be returned. Should be one of supported IETF language tags, case insensitive. When data in… |

### Use to get climatology data such as past daily actual observed temperatures, precipitation, snowfall and…
`GET https://apizie.tech/v1/cloud:azure-maps-weather/weather-get-daily-historical-actuals` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | The Azure Maps service hostname. Use `https://atlas.microsoft.com` for the Azure public cloud. To target a specific Azure Maps geography… |
| api-version | string | no | The API version to use for this operation. |
| format | string | yes | Desired format of the response. Only `json` format is supported. |
| x-ms-client-id | string | no | Indicates the account intended for use with the Microsoft Entra ID security model. This unique ID for the Azure Maps account can be… |
| query | array | yes | The applicable query specified as a comma separated string composed by latitude followed by longitude e.g. "47.641268,-122.125679".… |
| startDate | string | yes | Start date in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format, for example, 2019-10-27. The date range supported… |
| endDate | string | yes | End date in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format, for example, 2019-10-28. The date range supported… |
| unit | string | no | Specifies to return the data in either metric units or imperial units. Default value is metric. |

### Use to get climatology data such as past daily normal temperatures, precipitation and cooling/heating degree…
`GET https://apizie.tech/v1/cloud:azure-maps-weather/weather-get-daily-historical-normals` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | The Azure Maps service hostname. Use `https://atlas.microsoft.com` for the Azure public cloud. To target a specific Azure Maps geography… |
| api-version | string | no | The API version to use for this operation. |
| format | string | yes | Desired format of the response. Only `json` format is supported. |
| x-ms-client-id | string | no | Indicates the account intended for use with the Microsoft Entra ID security model. This unique ID for the Azure Maps account can be… |
| query | array | yes | The applicable query specified as a comma separated string composed by latitude followed by longitude e.g. "47.641268,-122.125679".… |
| startDate | string | yes | Start date in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format, for example, 2019-10-27. The date range supported… |
| endDate | string | yes | End date in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format, for example, 2019-10-28. The date range supported… |
| unit | string | no | Specifies to return the data in either metric units or imperial units. Default value is metric. |

### Use to get climatology data such as past daily record temperatures, precipitation and snowfall at a given…
`GET https://apizie.tech/v1/cloud:azure-maps-weather/weather-get-daily-historical-records` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | The Azure Maps service hostname. Use `https://atlas.microsoft.com` for the Azure public cloud. To target a specific Azure Maps geography… |
| api-version | string | no | The API version to use for this operation. |
| format | string | yes | Desired format of the response. Only `json` format is supported. |
| x-ms-client-id | string | no | Indicates the account intended for use with the Microsoft Entra ID security model. This unique ID for the Azure Maps account can be… |
| query | array | yes | The applicable query specified as a comma separated string composed by latitude followed by longitude e.g. "47.641268,-122.125679".… |
| startDate | string | yes | Start date in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format, for example, 2019-10-27. The date range supported… |
| endDate | string | yes | End date in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format, for example, 2019-10-28. The date range supported… |
| unit | string | no | Specifies to return the data in either metric units or imperial units. Default value is metric. |

### Use when you want to know if the weather conditions are optimal for a specific activity such as outdoor…
`GET https://apizie.tech/v1/cloud:azure-maps-weather/weather-get-daily-indices` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | The Azure Maps service hostname. Use `https://atlas.microsoft.com` for the Azure public cloud. To target a specific Azure Maps geography… |
| api-version | string | no | The API version to use for this operation. |
| format | string | yes | Desired format of the response. Only `json` format is supported. |
| x-ms-client-id | string | no | Indicates the account intended for use with the Microsoft Entra ID security model. This unique ID for the Azure Maps account can be… |
| query | array | yes | The applicable query specified as a comma separated string composed by latitude followed by longitude e.g. "47.641268,-122.125679".… |
| language | string | no | Language in which search results should be returned. Should be one of supported IETF language tags, case insensitive. When data in… |
| duration | integer | no | Specifies for how many days the daily indices are returned. By default, the indices data for the current day will be returned. When… |
| indexId | integer | no | Numeric index identifier that can be used for restricting returned results to the corresponding index type. Cannot be paired with… |
| indexGroupId | integer | no | Numeric index group identifier that can be used for restricting returned results to the corresponding subset of indices (index group).… |

### Use to get a locationally precise, up-to-the-minute forecast that includes weather hazard assessments and…
`GET https://apizie.tech/v1/cloud:azure-maps-weather/weather-get-weather-along-route` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | The Azure Maps service hostname. Use `https://atlas.microsoft.com` for the Azure public cloud. To target a specific Azure Maps geography… |
| api-version | string | no | The API version to use for this operation. |
| format | string | yes | Desired format of the response. Only `json` format is supported. |
| x-ms-client-id | string | no | Indicates the account intended for use with the Microsoft Entra ID security model. This unique ID for the Azure Maps account can be… |
| query | string | yes | Coordinates through which the route is calculated, separated by colon (:) and entered in chronological order. A minimum of two waypoints… |
| language | string | no | Language in which search results should be returned. Should be one of supported IETF language tags, case insensitive. When data in… |

### Use to get information about severe weather conditions such as hurricanes, thunderstorms, flooding,…
`GET https://apizie.tech/v1/cloud:azure-maps-weather/weather-get-severe-weather-alerts` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | The Azure Maps service hostname. Use `https://atlas.microsoft.com` for the Azure public cloud. To target a specific Azure Maps geography… |
| api-version | string | no | The API version to use for this operation. |
| format | string | yes | Desired format of the response. Only `json` format is supported. |
| x-ms-client-id | string | no | Indicates the account intended for use with the Microsoft Entra ID security model. This unique ID for the Azure Maps account can be… |
| query | array | yes | The applicable query specified as a comma separated string composed by latitude followed by longitude e.g. "47.641268,-122.125679".… |
| language | string | no | Language in which search results should be returned. Should be one of supported IETF language tags, case insensitive. When data in… |
| details | string | no | Return full details for the severe weather alerts. Available values are * `true` - Returns full details. By default all details are… |

### Use to get a list of storms issued by national weather forecasting agencies.
`GET https://apizie.tech/v1/cloud:azure-maps-weather/weather-get-tropical-storm-search` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | The Azure Maps service hostname. Use `https://atlas.microsoft.com` for the Azure public cloud. To target a specific Azure Maps geography… |
| api-version | string | no | The API version to use for this operation. |
| format | string | yes | Desired format of the response. Only `json` format is supported. |
| x-ms-client-id | string | no | Indicates the account intended for use with the Microsoft Entra ID security model. This unique ID for the Azure Maps account can be… |
| year | integer | yes | Year of the cyclone(s) |
| basinId | string | no | The `basinId` enum categorizes the different ocean basins where tropical storms can originate. Each basin is assigned a unique identifier… |
| govId | integer | no | Government storm Id |

### Use to get a list of the active tropical storms issued by national weather forecasting agencies.
`GET https://apizie.tech/v1/cloud:azure-maps-weather/weather-get-tropical-storm-active` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | The Azure Maps service hostname. Use `https://atlas.microsoft.com` for the Azure public cloud. To target a specific Azure Maps geography… |
| api-version | string | no | The API version to use for this operation. |
| format | string | yes | Desired format of the response. Only `json` format is supported. |
| x-ms-client-id | string | no | Indicates the account intended for use with the Microsoft Entra ID security model. This unique ID for the Azure Maps account can be… |

### Use to get a list of tropical storms forecasted by national weather forecasting agencies.
`GET https://apizie.tech/v1/cloud:azure-maps-weather/weather-get-tropical-storm-forecast` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | The Azure Maps service hostname. Use `https://atlas.microsoft.com` for the Azure public cloud. To target a specific Azure Maps geography… |
| api-version | string | no | The API version to use for this operation. |
| format | string | yes | Desired format of the response. Only `json` format is supported. |
| x-ms-client-id | string | no | Indicates the account intended for use with the Microsoft Entra ID security model. This unique ID for the Azure Maps account can be… |
| year | integer | yes | Year of the cyclone(s) |
| basinId | string | yes | The `basinId` enum categorizes the different ocean basins where tropical storms can originate. Each basin is assigned a unique identifier… |
| govId | integer | yes | Government storm Id |
| unit | string | no | Specifies to return the data in either metric units or imperial units. Default value is metric. |
| details | boolean | no | When true, wind radii summary data is included in the response |
| radiiGeometry | boolean | no | When true, wind radii summary data and geoJSON details are included in the response |
| windowGeometry | boolean | no | When true, window geometry data (geoJSON) is included in the response |

### Use to get the location of tropical storms from individual national weather forecasting agencies.
`GET https://apizie.tech/v1/cloud:azure-maps-weather/weather-get-tropical-storm-locations` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | The Azure Maps service hostname. Use `https://atlas.microsoft.com` for the Azure public cloud. To target a specific Azure Maps geography… |
| api-version | string | no | The API version to use for this operation. |
| format | string | yes | Desired format of the response. Only `json` format is supported. |
| x-ms-client-id | string | no | Indicates the account intended for use with the Microsoft Entra ID security model. This unique ID for the Azure Maps account can be… |
| year | integer | yes | Year of the cyclone(s) |
| basinId | string | yes | The `basinId` enum categorizes the different ocean basins where tropical storms can originate. Each basin is assigned a unique identifier… |
| govId | integer | yes | Government storm Id |
| details | boolean | no | When true, wind radii summary data is included in the response |
| radiiGeometry | boolean | no | When true, wind radii summary data and geoJSON details are included in the response |
| unit | string | no | Specifies to return the data in either metric units or imperial units. Default value is metric. |
| current | boolean | no | When true, return the current storm location |

## Example
```
curl "https://apizie.tech/v1/cloud:azure-maps-weather/weather-get-current-air-quality" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Maps Weather API?
Create a free Apizie key, then send GET https://apizie.tech/v1/cloud:azure-maps-weather/weather-get-current-air-quality with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Maps Weather API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. Maps Weather itself also needs your own key from azure.com.

### Can AI agents use the Maps Weather API?
Yes. Add the Apizie MCP server (https://apizie.tech/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key cloud:azure-maps-weather.

### What is the status of the Maps Weather API?
Needs your own provider key (bring your own key)