README.md

Automated Land-Subdivision API

Helping put smallholder farmers on the map

Automatically divide up a single, contiguous land expanse into pre-specified chunk sizes. Instantly reports back precise, high-resolution plot boundary coordinates that enables precision agriculture. The tool works regardless of the size of the initial land expanse.

Helps smallholder farmer geo-coops digitize their fam locations at very low cost.

🌐 Resources

Auto Land-Subdivision API Landing Page

Frontend demo app

Video demo (2min 23s)

Video pitch (3min 46s)

🛠️ Usage

Detailed API Documentation

🔄 Process Flow

1. Use a smartphone app to capture .gpx tracks that trace the extent of the collective land
2. Upload the .gpx data for processing via this endpoint /api/v2/geofiles/geofile/upload/
3. Upload list of plot owners (farmers) & acreage allocation per. owner to /api/v2/geo-clusters/geo-cluster/details/
4. Query this endpoint /api/v1/parcelized-agcs/?<rpeview_map_url_hash> for a preview map of the subdivided plots.

📊 Automated Land Division Examples

📝 NGINX Configuration

Config File

Add the following block to your NGINX configuration file (/etc/nginx/sites-available/land_subdivision_api):

    server {
         listen 80;
         server_name 13.61.173.110;
  
         root /var/www/land_subdivision_api;
         index index.html;
  
         proxy_set_header Upgrade $http_upgrade;
         proxy_set_header Connection 'upgrade';
         proxy_set_header Host $host;
         proxy_cache_bypass $http_upgrade;
  
         location / {
             proxy_pass http://localhost:9443;
             proxy_http_version 1.1;
         }
  
         location /api/ {
             proxy_pass http://localhost:9443/api/;
             proxy_http_version 1.1;
             proxy_set_header X-Real-IP $remote_addr;
             proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
         }
  
         error_page 404 /404.html;
         location = /404.html {
             root /var/www/land_subdivision_api;
         }
     }

🌠 Enable the Site

 Create a symbolic link in the `sites-enabled` directory:  
 ```bash
 sudo ln -s /etc/nginx/sites-available/land_subdivision_api /etc/nginx/sites-enabled/
 ```

🌠 Test the Configuration

 Before applying changes, verify the syntax and configuration:  
 ```bash
 sudo nginx -t
 ```

 Ensure the output confirms a successful test.  

🌠 Restart NGINX

 If the configuration test passes, restart NGINX to apply the changes:  
 ```bash
 sudo systemctl restart nginx
 ```

🌠 Verify System Functionality

 - Access the application in your browser via `http://13.61.173.110` to confirm it loads correctly.  
 - Check the API endpoints (e.g., `http://13.61.173.110/api/`) to ensure proper proxying.