# Visualize forecast grids and regions

To run this introductory colab and visualize forecasts, use the
[Public_Contrails_API_Tester](https://github.com/google-research/google-research/blob/master/contrails/demos/Public_Contrails_API_Tester.ipynb) notebook.

## Fetch a forecast grid

To access the forecast grid API with Python:

    import io
    import requests
    import xarray as xr

    API_KEY = "AIza...(replace with your API key)"
    params = {"time": "2025-05-15T20:00:00Z"}

    response = requests.get(
        url="https://contrails.googleapis.com/v2/grids",
        params=params,
        headers={"x-goog-api-key": API_KEY},
    )
    response.raise_for_status()

    dataset = xr.load_dataset(io.BytesIO(response.content))

## Fetch forecast regions

To access the forecast region API with Python:

    import requests
    import geopandas as gpd

    API_KEY = "AIza...(replace with your API key)"
    params = {"time": "2025-05-15T20:00:00Z"}

    response = requests.get(
        url="https://contrails.googleapis.com/v2/regions",
        params=params,
        headers={"x-goog-api-key": API_KEY},
    )
    response.raise_for_status()

    geodataframe = gpd.GeoDataFrame.from_features(response.json())