voxcity.geoprocessor.draw.polygon
=================================

.. py:module:: voxcity.geoprocessor.draw.polygon

.. autoapi-nested-parse::

   Building footprint display and polygon drawing utilities.

   Provides:
   - display_buildings_and_draw_polygon: Visualise buildings and draw polygons
   - get_polygon_vertices: Extract vertices from drawn polygons



Functions
---------

.. autoapisummary::

   voxcity.geoprocessor.draw.polygon.display_buildings_and_draw_polygon
   voxcity.geoprocessor.draw.polygon.get_polygon_vertices


Module Contents
---------------

.. py:function:: display_buildings_and_draw_polygon(voxcity=None, building_gdf=None, rectangle_vertices=None, zoom=17)

   Display building footprints and enable polygon drawing on an interactive map.

   :param voxcity: VoxCity object to extract data from.
   :type voxcity: VoxCity, optional
   :param building_gdf: Building footprints.
   :type building_gdf: GeoDataFrame, optional
   :param rectangle_vertices: [lon, lat] rectangle corners.
   :type rectangle_vertices: list, optional
   :param zoom: Initial zoom level. Default=17.
   :type zoom: int

   :returns: (Map, drawn_polygons list of dicts with 'id', 'vertices', 'color')
   :rtype: tuple


.. py:function:: get_polygon_vertices(drawn_polygons, polygon_id=None)

   Extract vertices from drawn polygons data structure.

   :param drawn_polygons: List returned from display_buildings_and_draw_polygon().
   :param polygon_id: Specific polygon ID. If None, returns all.
   :type polygon_id: int, optional

   :returns: List of (lon, lat) tuples for the specified polygon, or list of lists for all.