Skip to main content

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 Clone the repository:
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