GEO-INFER-PLACE

Instructions

Core Capabilities

• Place identification: Named place resolution and geocoding
• Catchment analysis: Service area and accessibility modeling
• H3 place-shedding: Hexagonal tessellation of administrative boundaries
• Boundary operations: County/region geometry loading and manipulation
• Unified backend: Multi-source geographic data integration

Key Imports

from geo_infer_place.core.unified_backend import UnifiedPlaceBackend
from geo_infer_place.core.catchment import CatchmentAnalyzer
from geo_infer_place.core.geocoding import PlaceGeocoder

Examples

```python
from geo_infer_place.core.unified_backend import UnifiedPlaceBackend

backend = UnifiedPlaceBackend()
place = backend.resolve("Portland, OR")
print(f"Resolved: {place.name}, Center: ({place.lat}, {place.lng})")
boundary = backend.get_boundary(place.id)
print(f"Boundary: {boundary.area_km2:.1f} km²")

```python
from geo_infer_place.core.catchment import CatchmentAnalyzer

analyzer = CatchmentAnalyzer(mode="drive_time")
catchment = analyzer.compute(
    facility_location=(45.5, -122.6),
    max_time_minutes=15
)
print(f"15-min catchment: {catchment.area_km2:.1f} km²")
print(f"Population covered: {catchment.population:,}")

Guidelines

• Uses H3 v4 API exclusively
• Fallback synthetic geometries are used when county data is unavailable
• Test: uv run python -m pytest GEO-INFER-PLACE/tests/ -v

Integrations

• SPACE → H3 tessellation of place boundaries
• DATA → Boundary geometry data sources
• CIV → Community place identification
• HEALTH → Health district boundary resolution
• TRANSPORT → Accessible catchment areas