# -------------------------
# FastAPI Application
# -------------------------
app = FastAPI(
    title="Study Area Map Generator",
    description="Professional GIS tool for generating study area maps with admin boundaries, OSM search, inset maps, and advanced cartographic features.",
    version="3.0.0",
)

class MapConfigRequest(BaseModel):
    title: str = Field(
        default="Study Area Cartographic Map",
        description="Map title to display in the header",
        example="Hawassa Region Study Area"
    )
    api_base_url: str = Field(
        default="http://196.191.180.142/gie/api",
        description="Base URL for API endpoints (admin_levels.php and admin_boundaries.php)",
        example="http://196.191.180.142/gie/api"
    )
    subcities_endpoint: str = Field(
        default="http://196.191.180.142/gie/api/subcities.php",
        description="API endpoint for subcities GeoJSON data",
        example="http://196.191.180.142/gie/api/subcities.php"
    )
    basemap: Literal["osm", "cartodb", "esri_imagery"] = Field(
        default="cartodb",
        description="Basemap style: osm (OpenStreetMap), cartodb (CartoDB Positron), esri_imagery (ESRI World Imagery)",
        json_schema_extra={"enum": ["osm", "cartodb", "esri_imagery"]}
    )
    inset_position: Literal["top", "bottom"] = Field(
        default="bottom",
        description="Position of the inset map: top (top-right) or bottom (bottom-right)",
        json_schema_extra={"enum": ["top", "bottom"]}
    )
    initial_zoom: int = Field(
        default=12,
        description="Initial zoom level for the map (1-18)",
        ge=1,
        le=18,
        example=12
    )
    center_lat: float = Field(
        default=7.0626,
        description="Initial map center latitude (WGS84 decimal degrees)",
        example=7.0626
    )
    center_lon: float = Field(
        default=38.4767,
        description="Initial map center longitude (WGS84 decimal degrees)",
        example=38.4767
    )

class MapResponse(BaseModel):
    html_page: str = Field(..., description="Complete HTML page with interactive Study Area Map Generator")
    message: str = Field(..., description="Status message")

@app.post("/", response_model=MapResponse)
async def generate_study_area_map(request: MapConfigRequest):
    """
    Generate a professional Study Area Map with advanced cartographic features.

    **Key Features:**
    - **Multi-source area selection**: Subcities, Administrative boundaries (Country/Region/Zone/District), or OSM location search
    - **Interactive controls**: Dropdown selectors, search box, basemap switcher, zoom radius adjuster
    - **Draw tools**: Point, Line, Polygon, Rectangle drawing with Replace/Overlay toggle
    - **Draggable north arrow**: Reposition by drag on the map
    - **Draggable & resizable legend**: Move and resize legend, customize colors/fonts/labels with Reset
    - **Cartographic elements**: North arrow, scale bar, coordinate grid (4-side labels with WGS84 + UTM), inset map
    - **Customization**: Custom titles, basemap selection (OSM/CartoDB/ESRI), inset position
    - **Map export**: PNG and PDF download with selectable paper size (A4/A3/Letter) and orientation
    - **Click-to-zoom**: Click any layer feature to zoom to its extent
    - **Professional GIS output**: Print-ready cartographic page layout with title, grid, frame, and all map elements

    **Study Area Selection Modes:**
    1. **Subcities**: Select Hawassa subcities from dropdown or click on map
    2. **Administrative Boundaries**: Cascading selection from Country → Region → Zone → District
    3. **OSM Search**: Search any city/location worldwide using OpenStreetMap Nominatim

    **Cartographic Features:**
    - **Coordinate Grid**: Auto-adjusting spacing with dual labels (WGS84 lat/lon + UTM Zone 37N)
    - **Grid Labels**: Positioned on all 4 sides (top, bottom, left, right) with ascending values
    - **North Arrow**: Professional SVG compass rose
    - **Scale Bar**: Metric and imperial units
    - **Inset Map**: Country outline with red box showing study area location (top-right or bottom-right)
    - **Legend**: Color-coded boundary display

    **Basemap Options:**
    - **osm**: OpenStreetMap standard view
    - **cartodb**: CartoDB Positron (clean minimal style)
    - **esri_imagery**: ESRI World Imagery (satellite view)

    **Parameters:**
    - **title**: Map title displayed in header
    - **api_base_url**: Base URL for admin_levels.php and admin_boundaries.php APIs
    - **subcities_endpoint**: URL for subcities GeoJSON API
    - **basemap**: Basemap style selection
    - **inset_position**: Position of inset map (top or bottom right)
    - **initial_zoom**: Starting zoom level (1-18)
    - **center_lat**: Initial center latitude in WGS84
    - **center_lon**: Initial center longitude in WGS84

    **Returns:**
    Complete standalone HTML page that can be deployed anywhere or opened in a browser.
    The page includes all interactive controls for runtime area selection and map customization.
    """
    logger.info(
        "Processing study area map request",
        title=request.title,
        basemap=request.basemap,
        inset_position=request.inset_position
    )

    # Generate the comprehensive HTML page
    html_content = generate_study_area_map_html(
        title=request.title,
        api_base_url=request.api_base_url,
        subcities_endpoint=request.subcities_endpoint,
        basemap=request.basemap,
        inset_position=request.inset_position,
        initial_zoom=request.initial_zoom,
        center_lat=request.center_lat,
        center_lon=request.center_lon
    )

    return MapResponse(
        html_page=html_content,
        message="Study Area Map generated successfully! The HTML includes interactive controls for area selection, basemap switching, and full cartographic features."
    )

if __name__ == "__main__":
    run_service(app)