Note
Please note that this program solution is currently in BETA stage and some details are potentially to be changed, more functionality may be added soon or later.
Current version: 0.64b
Tip
You can find some useful info about GAIA aspects in wiki: https://github.com/OSINT-TECHNOLOGIES/gaia/wiki
Tip
You can contact GAIA developer by sending message on the following e-mail: osint.technologies@gmail.com
README Table of Contents:
GAIA is a program created using Mercury Framework (runmercury.com), Google Earth Engine (earthengine.google.com) and OpenStreetMap (openstreetmap.org) specially for those who works with geospatial images of Earth or interested in this subject. This program implements the idea of getting as much sources of sattelite and aerial images as it possible in one app. It allows you to get planetary images from different providers using APIs of various services and, what is important, without any coding knowledge and in a pleasant web interface
-
Fires map in South America, visualised using NASA FIRMS
-
North Gaza visualised using Sentinel-2 MSI during October 2023 conflict
-
Google Earth Engine integrated knowledge base
-
OpenStreetMap GeoJSON file processing
Google Earth Engine. This service combines a multi-petabyte catalog of satellite imagery and geospatial datasets with planetary-scale analysis capabilities. Scientists, researchers, and developers use Earth Engine to detect changes, map trends, and quantify differences on the Earth's surface. Earth Engine is now available for commercial use, and remains free for academic and research use. Support has been added with 0.3b update.
OpenStreetMap. OSM is a collaborative project for world mapping using data from various sources and volunteers. In GAIA you can get, use and explore different OSM-provided maps with different additional functions. Support has been added with 0.4b update.
The very first step on your way to start researching using GAIA is installing necessary requirements. You can install them using setup.py script
Your second step is integrated services connection. Instructions below will help you to properly configure and connect them to GAIA
To start researching using Google Earth Engine you need to:
- Register on Google Earth Engine using your Google account (https://code.earthengine.google.com/register) OR start GAIA using start.bat and press EE registration button
- Register a new project with unpaid usage, choose any type of project you want and name it however you want
- Confirm everything you've chosen
- Go to https://console.cloud.google.com/iam-admin/serviceaccounts/ and create service account for your project.
- Once service account created, click the menu for that account, then Create key > JSON. Download the JSON key file and put it in GAIA directory
- Open GAIA in web interface and if you don't see any errors and see the map - congratulations, you've just finished Google EE connection procedure. Now you can start using GAIA with Google EE
Basically you don't need to do any things out of GAIA to start researching using OpenStreetMap. You need only to install new libraries from system requirements and you'll be ready to start your research using OSM.
After all needed services are connected, you can start your research. In order to do this you need to start GAIA web-interface using start.bat script which will open welcome window in your default browser.
Software requirements:
- OS Windows 10/11
- Python 3.10 and above (lower versions won't guarantee correct and stable work)
- PIP package installer
Installed Python libraries (all of them can be installed using setup.py script):
- ee==0.2
- earthengine-api==0.1.392
- mercury==2.3.7
- colorama==0.4.6
- osmnx==1.7.0
- contextily==1.4.0
- folium==0.16.0
- future==0.18.3
- eefolium==0.2.0
- ipyleaflet==0.18.2
Network:* High-Speed Broadband Internet connection for good experience with datasets downloading