# Google Weather API

Proxies Google Maps Weather API. Current conditions, hourly/daily forecasts, history, public alerts — no separate Google API key.

## Prerequisites

Provision this resource before use. Edge requests without provisioning will error.

### Provision

    curl -s -X POST https://cohesivity.ai/api/resources/google-weather-api \
      -H "Authorization: Bearer <coh_management_key>"

### Delete

    curl -s -X DELETE https://cohesivity.ai/api/resources/google-weather-api \
      -H "Authorization: Bearer <coh_management_key>"

**Important:** Provision this resource now, before building or running the application. Provisioning is the agent's job, not the application's.

## Official Docs

https://developers.google.com/maps/documentation/weather — read before coding.

## Edge Usage

- **Base URL:** https://cohesivity.ai/edge/google-weather-api
- **Auth:** `coh_application_key` as the **key** query parameter
- **Format:** same as Google's Weather API — same paths, same query params, same response shapes

## Examples

- Current conditions: `GET https://cohesivity.ai/edge/google-weather-api/v1/currentConditions:lookup?key=<coh_application_key>&location.latitude=37.77&location.longitude=-122.42`
- Hourly forecast: `GET https://cohesivity.ai/edge/google-weather-api/v1/forecast/hours:lookup?key=<coh_application_key>&location.latitude=37.77&location.longitude=-122.42&hours=24`

## Response Shape

Responses are deeply nested. Key paths for current conditions:

    {
      "currentTime": "2026-03-14T17:31:35Z",
      "isDaytime": true,
      "weatherCondition": {
        "description": { "text": "Sunny" },
        "type": "CLEAR"
      },
      "temperature": { "degrees": 12.8, "unit": "CELSIUS" },
      "feelsLikeTemperature": { "degrees": 11.5, "unit": "CELSIUS" },
      "relativeHumidity": 57,
      "uvIndex": 2,
      "wind": {
        "direction": { "degrees": 349, "cardinal": "NORTH" },
        "speed": { "value": ..., "unit": "KILOMETERS_PER_HOUR" }
      },
      "precipitation": {
        "probability": { "percent": 0, "type": "RAIN" },
        "qpf": { "quantity": 0, "unit": "MILLIMETERS" }
      }
    }

Hourly forecast wraps each hour in `forecastHours[]` with the same fields plus `interval.startTime`/`endTime`.

**Common access patterns:**
- Temperature: `data.temperature.degrees` (NOT `data.temperature`)
- Description: `data.weatherCondition.description.text` (NOT `data.description`)
- Wind speed: `data.wind.speed.value`
- Rain chance: `data.precipitation.probability.percent`