Open Geodata API Icon

Open Geodata API Documentation

πŸ›°οΈ Unified Python Client for Satellite Data Access

Open Geodata API provides seamless access to multiple open geospatial data APIs with automatic URL management, intelligent filtering, and maximum flexibility for data reading.

Notebook (API Testing):

Here you can access or download the full API References for testing the Open Geodata API:

NOTE:

This documentation is a work in progress. Contributions are welcome! I appreciate your patience as I continue to improve it. AI helped me a lot to generate this documentation, but it still needs a lot of work to be complete and polished. So maybe all Examples are not tested, and some sections may be incomplete or not fully accurate. If you find any issues, please open an issue on GitHub or contribute directly to the documentation.

🎯 One Interface

Access Microsoft Planetary Computer & AWS EarthSearch APIs

πŸ” Smart URLs

Automatic signing, validation, and expiration handling URLs

πŸ“¦ Your Choice

Use any raster package (rioxarray, rasterio, GDAL) to read the data

πŸ”„ Complete Workflow

Search β†’ Filter β†’ Download β†’ Analyze

Quick Start

# Install the package
pip install open-geodata-api

import open_geodata_api as ogapi

# Create client with auto-signing
pc = ogapi.planetary_computer(auto_sign=True)

# Search for data
results = pc.search(
    collections=["sentinel-2-l2a"],
    bbox=[-122.5, 47.5, -122.0, 48.0],
    datetime="2024-01-01/2024-03-31"
)

# Get ready-to-use URLs
item = results.get_all_items()[0]
blue_url = item.get_asset_url('B02')  # Automatically signed!

# Use with ANY raster package
import rioxarray
data = rioxarray.open_rasterio(blue_url)

Documentation Sections

πŸš€ Getting Started

πŸ’‘ Examples & Tutorials

πŸ“š API Reference

πŸ–₯️ CLI Reference

❓ FAQ & Help

πŸ”§ Development

Philosophy

🎯 Core Focus: We provide URLs - you choose how to read them!
πŸ“¦ Use Any Package: rioxarray, rasterio, GDAL, or any package you prefer
πŸš€ Maximum Flexibility: Zero restrictions on your workflow

Perfect for researchers, data scientists, and developers working with satellite imagery and geospatial analysis.

Community & Support

Indices and Tables