geo-infer-api
REST and GraphQL API endpoints for geospatial services. Use when building API routes, defining spatial query endpoints, or exposing GEO-INFER functionality as web services.
Best use case
geo-infer-api is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
REST and GraphQL API endpoints for geospatial services. Use when building API routes, defining spatial query endpoints, or exposing GEO-INFER functionality as web services.
Teams using geo-infer-api should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/GEO-INFER-API/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How geo-infer-api Compares
| Feature / Agent | geo-infer-api | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
REST and GraphQL API endpoints for geospatial services. Use when building API routes, defining spatial query endpoints, or exposing GEO-INFER functionality as web services.
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
SKILL.md Source
# GEO-INFER-API
## Instructions
### Core Capabilities
- **REST endpoints**: FastAPI-based spatial query and analysis routes
- **GraphQL**: Schema for complex spatial queries
- **Authentication**: JWT/API key middleware
- **Rate limiting**: Per-endpoint and per-user throttling
- **Serialization**: GeoJSON response formatting
### Key Imports
```python
from geo_infer_api.core.router import SpatialRouter
from geo_infer_api.core.middleware import AuthMiddleware
from geo_infer_api.core.serializers import GeoJSONSerializer
```
## Examples
```python
from geo_infer_api.core.router import SpatialRouter
from geo_infer_api.core.serializers import GeoJSONSerializer
router = SpatialRouter(prefix="/v1/spatial")
@router.get("/query")
async def spatial_query(lat: float, lng: float, radius_km: float):
results = await spatial_engine.query_radius(lat, lng, radius_km)
return GeoJSONSerializer.to_feature_collection(results)
# Register with FastAPI app
app.include_router(router)
```
```python
from geo_infer_api.core.middleware import AuthMiddleware
# JWT authentication middleware
app.add_middleware(AuthMiddleware, secret_key="your-key", algorithm="HS256")
```
## Guidelines
- FastAPI with async handlers for spatial operations
- Response format defaults to GeoJSON (RFC 7946)
- Test: `uv run python -m pytest GEO-INFER-API/tests/ -v`
### Integrations
- **SEC** → JWT/API key authentication middleware
- **DATA** → Spatial query endpoint data sources
- **SPACE** → H3 and geographic query parameters
- **OPS** → API monitoring and rate limiting metrics
- **APP** → Frontend consuming API endpoints