Dashboard User Guide

After you create an account and sign in, the ObservEarth dashboard is where you manage areas of interest (AOIs), copy your API key, review usage, and update your profile.

Tip: API requests use your key in the X-API-Key header. For request examples, see Authentication & API Keys and Working with Areas of Interest.

Opening the dashboard

  1. Go to Log in and enter your username and password.
  2. From the site navigation, open Dashboard (or go directly to /dashboard/ on your site).
  3. You land on the main AOI overview: summary tiles at the top and a table of your areas below.

Sidebar navigation

On large screens, the left sidebar groups the main dashboard actions:

  • Dashboard — Home view with AOI list and summary stats.
  • Add AOI — Draw or upload a geometry to register a new area for API calls.
  • API Usage — Your API key, copy-to-clipboard, and usage-related summaries.
  • Profile — Update your name, email, and password.

A Current Plan card shows your subscription tier and a link to pricing if you want to upgrade.

Dashboard home: stats and AOIs

Summary tiles

At a glance you can see:

  • Total AOIs — How many areas you have registered.
  • Total area — Combined footprint of your AOIs (in hectares).
  • Area usage — How much of your plan’s allowed total area you are using, with a progress bar. This aligns with limits enforced when you add geometry through the API or dashboard.
AOI table

Each row is one AOI with name, area, creation date, and actions (view details, weather tools where available, edit, delete). Use the search box to filter the list when you have many areas. Choosing view details opens the AOI workspace (see below), not only a static summary.

Adding and managing AOIs

Click Add New AOI (or Add AOI in the sidebar) to open the map workflow: define a polygon or upload compatible geometry, give it a name, and save.

From the dashboard table you can open an AOI for satellite or weather workflows, adjust boundaries on Edit, or remove an AOI with Delete if you no longer need it. Conceptually, the same AOIs are referenced by geometry_id in API requests; see the AOI tutorial for API-oriented detail.

AOI detail URL: search and view imagery on the map

Opening an AOI from the dashboard sends you to a URL path like /dashboard/aoi/<geometry-uuid>/. The UUID in the path is your AOI’s id—the same value you use as geometry_id in API calls.

On your machine that might be http://localhost:8000/dashboard/aoi/d27f6882-4046-450e-a045-07f05ed8c055/ (host and port depend on how you run the dev server).

That page is the satellite explorer for that area. You can:

  • Search — Choose satellite (Sentinel-2, Sentinel-1, Landsat, MODIS), an index or band preset, optional cloud-cover filter, and a date range, then run Search Images to list scenes that match.
  • View on the map — The Available Dates strip lists matching acquisitions; picking one loads that image onto the interactive map underneath, clipped to your AOI boundary.

So the AOI detail route is both your entry point for visual exploration of satellite data over that polygon and your bridge to understanding which dates and sensors are usable before you call the programmatic APIs.

Plans, signup, and area limits

When you sign up, you choose a plan. That choice sets how much total AOI area you can register across your account (square meters behind the scenes; the dashboard shows hectares).

  • Research & Non-commercial — default limit for exploration and non-commercial use.
  • Non-profit and Startup — higher combined AOI allowance for organizations and growing teams.
  • Giant and Super Giant — top tiers for large monitoring programs.

The Current Plan / usage strip on the dashboard reflects this cap. If adding or editing an AOI would push you over your limit, save the geometry with a smaller footprint or upgrade via pricing. The same limits apply when you create geometry through the API.

Commercial terms and exact quotas for your contract are always those shown on your account and in your agreement with ObservEarth.

API key and API Usage page

Open API Usage from the sidebar (you must be logged in).

  • Your API key is shown in a read-only field with a copy button. Treat it like a password.
  • Usage sections summarize how much satellite-related area has been processed, depending on what your account tracks.
  • A link to API documentation helps you jump to interactive docs (Swagger/ReDoc) from the same context.

For header format and code samples, use Authentication & API Keys.

Profile

Under Profile you can update your account details and change your password. Keeping your email current ensures you receive important account notices.

Next steps