The Locate API is a spatial analysis endpoint that determines site locations based on a given polygon, specific required locations, and distance constraints. This API is available via a POST request to: http://127.0.0.1:5000/api/v2/spatial/site_location

Request Body (JSON) The request contains: polygon: Defines the area of interest using GeoJSON-like coordinates (longitude, latitude). must_have_locations: A list of coordinates that must be included in the result. min_distance_km: Minimum required distance (in km) between selected locations. num_sensors: Number of locations (sensors) to determine. Example JSON Request json Copy Edit { "polygon": { "coordinates": [ [ [32.575107, 0.305577], [32.575364, 0.319138], [32.597337, 0.32034], [32.607894, 0.312787], [32.608752, 0.297509], [32.599225, 0.292102], [32.580342, 0.291845], [32.574334, 0.296994], [32.575107, 0.305577] ] ] }, "must_have_locations": [ [-1.2790166, 36.816709] ], "min_distance_km": 2.5, "num_sensors": 2 }

API Functionality Defines a polygonal search area The given GeoJSON-style coordinates form a closed polygon, specifying the area for site selection. Ensures specific locations are included The must_have_locations parameter guarantees that certain points (e.g., [-1.2790166, 36.816709]) are part of the result.

Maintains minimum distance constraints The min_distance_km (2.5 km) ensures that selected points are sufficiently spaced apart. Limits the number of selected sites The API will return exactly num_sensors (2 in this case) within the defined constraints.

Locate

Overview

Details

Locate

Overview

Details