Geographic Configuration

The geographic configuration module is one of the most frequently used sections of the admin portal. It manages the territorial hierarchy that defines where climate data is collected and analyzed.

Country Management

Administrators can create, edit, enable, and disable countries in the system. Each country is identified by its name and a two-letter ISO2 code. Countries can be enabled or disabled without deleting them, which is useful when a country should not appear in the frontend but its historical data should be preserved. The country form includes fields for the name and ISO2 code, and once created, a country becomes the root entity for all geographic divisions below it.

Admin Level 1 Management

This section manages the first level of administrative divisions within each country. Depending on the country, these could be departments (Colombia), provinces, states, or regions. Each division is linked to its parent country and has an external identifier that can be used to cross-reference with official government codes. Administrators can create new divisions, edit existing ones, or disable them as needed.

Admin Level 2 Management

The second level of administrative divisions represents municipalities, districts, or counties within each admin level 1 entity. These are the most granular administrative units managed in the system and are often the level at which climate data is aggregated and analyzed. The management interface allows administrators to create, edit, search, and disable these divisions, maintaining the full geographic hierarchy from country down to municipality.

Location Management

Locations represent the actual points where climate data is collected, typically weather stations. Each location is linked to a specific admin level 2 division and a data source. The location form includes fields for the station name, a machine name used in URLs, external identifiers, geographic coordinates (latitude, longitude, altitude), and a visibility setting that controls whether the station appears in the frontend. Administrators can also enable or disable locations to control which stations are active in the system.

The location management module also includes a bulk import feature that allows administrators to load multiple stations at once from a CSV file, which is particularly useful when setting up the system for a new region or country.