---
title: "Retrieve forecast values within given GeoJSON polygon for all requested weather elements and time periods."
method: POST
path: "/us/v1/wx-forecast/polygon-query"
tags: ["Weather"]
---

# Retrieve forecast values within given GeoJSON polygon for all requested weather elements and time periods.

`POST /us/v1/wx-forecast/polygon-query`

Retrieve forecast values located within given area for requested weather elements and time period. Request body parameters are:
* poly:  [GeoJSON Polygon](https://www.rfc-editor.org/rfc/rfc7946.html#appendix-A) defining the area. Max allowed area is 1000 km^2.
* wxtypes:  list of one or more weather forecast elements you wish to retrieve. Allowed values are "CIG", "DEWPT", "SKY", "TEMP", "VIS", "WINDDIR", "WINDGUST", "WINDSPEED".
* hours:  number of hourly forecasts to return (1-24). For current hour only you should enter value of 1. To also retrieve values for each of the next n hours, enter n.


The response will consist of a GeoJSON FeatureCollection with one Feature for each forecast location found within requested area,
properties of which will include an ordered list of forecast values for each requested weather element, for each requested hour. Units for each element are as follows:
* CIG: meters AGL
* DEWPT: degrees Celsius
* SKY: % cloud cover
* TEMP: degrees Celsius
* VIS: meters
* WINDDIR: degrees true
* WINDGUST: meters/sec
* WINDSPEED: meters/sec

## Headers

- `x-api-key` string

## Request body

- WxByPolygon — Geometry-defining arguments for polygon requests
  - `poly` object, required
  - `wxtypes` string[], required
  - `hours` integer, required

## Response `200`

A GeoJSON FeatureCollection with one Feature for each forecast location found within requested area.

- WxPolyResponse
  - `found` object, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/ljaero/apis/dflight-api.md) · [All operations](https://skmtc.net/ljaero/apis/dflight-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ljaero/dflight-api/revisions/1395ce057bfd/schema)