terrakio-api 0.3.0

A client library for Terrakio's WCS API service

Terrakio API Client

A Python client for Terrakio API. This package provides a user-friendly interface for accessing Terrakio's data services.

Features

• Authentication
• WCS queries and data retrieval
• Mass stats related functionalities

Installation

pip install terrakio-api

Usage Example

from terrakio_api import Client
from shapely.geometry import Point

# Initialize the client
client = Client()

# Login to your account
token = client.login(email = "XXX", password = "XXX")
print(f"✓ Login successful, personal token: {token[:10]}...")

# The login account will automatically be used for the requests

# View API key
api_key = client.view_api_key()
print(f"✓ Current API key: {api_key[:10]}...")

# Create a geographic feature
point = Point(149.057, -35.1548)
geojson = {
     "type": "Feature",
     "geometry": {
          "type": "Point",
          "coordinates": [point.x, point.y]
     },
     "properties": {
          "name": "Location in Canberra region",
          "description": "Coordinates: 149.057, -35.1548"
     }
}

# Make a WCS request
dataset = client.wcs(
     expr="prec=MSWX.precipitation@(year=2024, month=1)\nprec",
     feature=geojson,
     output="netcdf"
)

For more documentation, see the main repository.