Skip to content

Vizzuality/amazonia-360

Repository files navigation

AmazoniaForever360+

Screenshot 2025-03-21 at 10 10 45

AmazoniaForever360+ is a platform developed to provide critical geospatial and territorial data, supporting conservation and sustainable efforts in the Amazon region. Designed for non-expert users, it equips government officials, NGOs, local communities, and professionals working in environmental planning and development with tools to monitor environmental changes and implement strategic actions.

Table of contents

  1. Platform Overview
  2. Architecture
    1. Components
      1. Front-end
      2. Backend API
      3. Infrastructure
      4. Science and prototypes
    2. Tech Stack
  3. Running the Platform Locally
  4. License

Platform Overview

AmazoniaForever360+ is designed to serve spatial and statistical data through a user-friendly interface that supports:

  • Exploring pre-processed geospatial indicators structured over an H3-based hexagonal grid. This allows quick access to large number of datasets and the ability to easily cross-filter any of them.
  • An in-depth report for all available data sources.
  • Querying aggregated data by area or administrative boundary through zonal statistics.
  • Filtering geographies based on custom polygons or map extent.
  • Generating reports with AI-assisted summaries.

The platform uses ArcGIS Online to host and serve most raster and vector data, including zonal statistics, administrative boundaries, and thematic layers. The h3 data server and AI summary reports are build in an independent python application.

Architecture

AmazoniaForever360+ uses a hybrid architecture that combines ArcGIS Online services with a custom backend for performance-sensitive data processing.

Components

  • Front-end: client/. React frontend using Mapbox GL JS and ArcGIS SDK
  • Backend API: api/. Python FastAPI service for h3 data server and AI summary generation
  • Infrastructure: infrastructure/. Infrastructure management with Terraform
  • Science and prototypes: science/. Python prototypes and data management sketches.

Tech Stack

  • Frontend: React, Next.js, ArcGIS SDK
  • Backend: python FastAPI
  • Infrastructure: Terraform

Running it locally

To set up AmazoniaForever360+ on your local machine first create a .env file from the template .env.default at the root of the project and fill in the needed environment variables.

Then run

docker compose up –build

from the root directory to spin all the services (client and api). Now visiting localhost:3000 in any browser should show the landing page.

Note that some environment variables are secret tokens needed to authorize the use of some parts of the API like ArcGIS services which may be crucial for some of the application features.

License

This project is licensed under the MIT License. See the LICENSE file for details.