coalition.stakeholders.spatial
==============================

.. py:module:: coalition.stakeholders.spatial


Classes
-------

.. autoapisummary::

   coalition.stakeholders.spatial.SpatialQueryUtils


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

.. py:class:: SpatialQueryUtils

   Utility class for spatial queries related to stakeholders and districts


   .. py:method:: find_districts_for_point(point: django.contrib.gis.geos.Point) -> dict[str, coalition.regions.models.Region | None]
      :staticmethod:


      Find all legislative districts containing a given point

      :param point: Geographic point to search for

      :returns: Dictionary with district types as keys and Region objects as values



   .. py:method:: get_stakeholders_in_district(district: coalition.regions.models.Region, include_unverified: bool = False) -> list[coalition.stakeholders.models.Stakeholder]
      :staticmethod:


      Get all stakeholders within a specific district

      :param district: Region object representing the district
      :param include_unverified: Whether to include stakeholders with unverified emails

      :returns: List of Stakeholder objects in the district



   .. py:method:: get_stakeholders_by_district_type(district_type: coalition.stakeholders.constants.DistrictType | str, state_filter: str | None = None) -> dict[str, list[coalition.stakeholders.models.Stakeholder]]
      :staticmethod:


      Get stakeholders grouped by districts of a specific type

      :param district_type: Type of district (DistrictType enum or string)
      :param state_filter: Optional state abbreviation to filter by

      :returns: Dictionary with district names as keys and lists of stakeholders as values



   .. py:method:: find_nearby_stakeholders(point: django.contrib.gis.geos.Point, radius_miles: float = 10.0) -> list[coalition.stakeholders.models.Stakeholder]
      :staticmethod:


      Find stakeholders within a radius of a given point

      :param point: Center point for search
      :param radius_miles: Search radius in miles

      :returns: List of nearby Stakeholder objects, ordered by distance



   .. py:method:: get_district_statistics() -> dict[str, dict]
      :staticmethod:


      Get statistics about stakeholder distribution across districts

      :returns: Dictionary with district types and their stakeholder counts



   .. py:method:: get_unassigned_stakeholders() -> list[coalition.stakeholders.models.Stakeholder]
      :staticmethod:


      Get stakeholders who have coordinates but haven't been assigned to districts

      :returns: List of Stakeholder objects needing district assignment