> ## 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.

# Overview

> Core service for managing geo locations database, powering Pinpoint and many tools

## Overview

Geos is one of the **core services** that powers Pinpoint and many other tools. It manages the geo locations database and provides location search, resolution, and management capabilities.

## Repository

**Repository:** [https://git.wthr.ws/weathertech/geos-v3](https://git.wthr.ws/weathertech/geos-v3)

Clone the repository:

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

## Location Types

Geos manages three types of locations:

1. **ICAO station** - Airport weather stations
2. **ID** - Location identifiers
3. **Geo** - Geographic coordinates (no override support for this type)

## Important Database Columns

* **`weather_id`** - Originally a mapper to 3rd party provider (Foreca), but now used extensively throughout the system. Cannot be removed.
* **`is_enterprise_only`** - Flag to manage ARD Solutions clients and control access to enterprise locations

## Important APIs

### Solr Select API

Query all locations with specific fields:

```
https://geos.arabiaweather.com/solr/geos/select?q=*:*&fl=id,longlat,is_enterprise_only&&wt=csv&indent=true&rows=999999
```

### Autocomplete API

Search for locations by name (supports Arabic):

```
https://geos.arabiaweather.com/autocomplete/%D8%B9%D8%B1%D8%AC%D8%A7%D9%86/*?global=true
```

### Get By ID API

Retrieve location by ID:

```
https://geos.arabiaweather.com/getById/1
```

## Quick Links

* **Architecture:** [Geos architecture](/data-ai/geos/architecture)
* **Deployment:** [How Geos is deployed](/data-ai/geos/deployment)
* **FAQ:** [Geos FAQ](/data-ai/geos/faq)

## Related Services

* **[Pinpoint](/data-ai/pinpoint)** - Weather API that uses Geos for location resolution
* **[Overrider Panel](/data-ai/legacy-met-tools/overrider-panel)** - Uses Geos location and weather IDs for overrides
* **MySQL** - Database backend (see [Infrastructure Databases](/infrastructure/databases))