> ## Documentation Index
> Fetch the complete documentation index at: https://docs-v2.ard.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Geoterra

> Service for astro data (sun, moon), hijri calendar info, and elevation

## Overview

Geoterra is a core service that provides astronomical data (sun and moon information), hijri calendar information, and elevation data. It is a dependency for **ArabiaWeather (AW)** and **Pinpoint**.

## Repository

**Repository:** [https://git.wthr.ws/weathertech/geoterra2](https://git.wthr.ws/weathertech/geoterra2)

Clone the repository:

```bash theme={null}
git clone https://git.wthr.ws/weathertech/geoterra2
cd geoterra2
```

## Service Endpoint

**Production Host:** [https://geoterra.devops.arabiaweather.com/](https://geoterra.devops.arabiaweather.com/)

## Deployment

Geoterra is deployed via **Portainer** on Docker Swarm with **CI/CD integration**.

### Deployment Location

**Portainer Stack:** [wt-geoterra-api](https://portainer.devops.arabiaweather.com/#!/2/docker/stacks/wt-geoterra-api?id=268\&type=1\&regular=true\&orphaned=false\&orphanedRunning=false)

### Deployment Process

Geoterra has **automated CI/CD**. To deploy:

1. **Make code changes** in the repository
2. **Commit** your changes:
   ```bash theme={null}
   git add .
   git commit -m "Your commit message"
   ```
3. **Push** to the repository:
   ```bash theme={null}
   git push
   ```
4. **Tag** the release:
   ```bash theme={null}
   git tag vYYYY.MM.DD-X
   git push --tags
   ```
5. **CI/CD pipeline** will automatically:
   * Build the Docker image
   * Push to the registry
   * Update the Portainer stack

<Note>
  The CI/CD pipeline handles the build and deployment automatically. You only need to push and tag the release.
</Note>

## Capabilities

Geoterra provides:

1. **Astronomical Data**
   * Sun position and timing (sunrise, sunset)
   * Moon position and phases
   * Astronomical calculations for any location

2. **Hijri Calendar Information**
   * Hijri date conversions
   * Islamic calendar data

3. **Elevation Data**
   * Elevation information for geographic coordinates
   * Terrain elevation calculations

## Related Services

* **[Pinpoint](/data-ai/pinpoint)** - Weather API that depends on Geoterra for astro and elevation data
* **ArabiaWeather (AW)** - Main application that depends on Geoterra