location-system

Resolve geographic coordinates into country, state, and city entities via geocoding.

132|42|Updated Aug 19, 2020
One-click install
npx skills add https://github.com/OpenLitterMap/openlittermap-web --skill location-system
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: location-system
Source: https://github.com/OpenLitterMap/openlittermap-web/tree/main/.ai/skills/location-system
Command: npx skills add https://github.com/OpenLitterMap/openlittermap-web --skill location-system

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Location data is often siloed and inconsistently modeled across services; this Skill standardizes geography by providing identity-only Location tables (Country, State, City) and a geocoding workflow to resolve coordinates into structured location entities, backed by Redis caches.

Core Features & Use Cases

  • Resolve coordinates to country/state/city using ResolveLocationAction and ReverseGeocodeLocationAction.
  • LocationType enum defines Global, Country, State, and City hierarchies with route keys based on shortcode.
  • Identity-only location tables (countries, states, cities) support scalable lookups and Redis-backed metrics for fast access.

Quick Start

Provide latitude and longitude, then call ResolveLocationAction to obtain a LocationResult containing the country, state, city, and address details.

Frequently Asked Questions about location-system

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I convert latitude and longitude coordinates into structured country, state, and city data?

Reverse geocoding converts latitude and longitude coordinates into structured location entities. By using ResolveLocationAction, you obtain a LocationResult containing the resolved country, state, city, and address details.

What is the best way to standardize global location data across multiple services?

Standardizing global location data requires identity-only location tables for countries, states, and cities. This approach provides a consistent geographic model and uses shortcode-based routing to ensure reliable location identity resolution.

How does Redis caching improve geocoding lookup performance?

Redis-backed metrics and caches accelerate geocoding lookups by storing resolved location entities. This ensures fast access to country, state, and city data without repeatedly querying the underlying geocoding workflow for every coordinate.

Can I resolve coordinates into a hierarchical location structure with specific route keys?

Yes, a LocationType enum defines Global, Country, State, and City hierarchies with route keys based on shortcodes. This structure supports scalable lookups and identity resolution for geographic coordinates.

Do I need a specific database schema to support location identity resolution and caching?

You need identity-only location tables for countries, states, and cities to support scalable lookups. These tables integrate with a Redis cache to store and quickly retrieve resolved geographic coordinates.

What actions are required to map geographic coordinates to structured location entities?

Mapping geographic coordinates requires ReverseGeocodeLocationAction and ResolveLocationAction. These actions process the latitude and longitude inputs to resolve and cache the corresponding country, state, and city entities.