maps

Geocode place names, reverse geocode coordinates, and search nearby points of interest.

3|Updated Apr 21, 2026
One-click install
npx skills add https://github.com/DarkArty07/Aether-Agents --skill maps-darkarty07
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: maps
Source: https://github.com/DarkArty07/Aether-Agents/tree/main/home/skills/productivity/maps
Command: npx skills add https://github.com/DarkArty07/Aether-Agents --skill maps-darkarty07

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill removes the barrier of paid location APIs by providing free, open-source access to geocoding, point-of-interest search, travel routing, and timezone data using OpenStreetMap sources, eliminating setup costs and API key requirements for location-related tasks.

Core Features & Use Cases

  • Geocoding & Reverse Geocoding: Convert place names to coordinates and coordinates to human-readable addresses, useful for processing user-submitted location pins or address data.
  • Nearby POI Search: Find points of interest across 44 categories (restaurants, hospitals, hotels, etc.) within a specified radius of a location or address, perfect for recommending nearby services to users.
  • Travel Routing & Timezone Lookup: Calculate driving, walking, or cycling distance and travel time between two places, get turn-by-turn directions, and retrieve timezone information for any global coordinates.

Quick Start

Use the maps skill to find 3 nearby pharmacies within 1km of 1600 Pennsylvania Ave, Washington DC.

Frequently Asked Questions about maps

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

FAQPage Schema
How do I geocode addresses to coordinates without a paid API key?

Geocode addresses to coordinates for free using OpenStreetMap's Nominatim service, eliminating setup costs and API key requirements. This open-source approach converts place names to latitude and longitude while enforcing Nominatim rate limits per terms of service.

Can I search for nearby points of interest like restaurants and hospitals around a specific location?

Search nearby points of interest across 44 categories including restaurants, hospitals, and hotels within a specified radius of any location. This POI search uses Overpass API mirror fallbacks for resilient queries against OpenStreetMap data sources.

What's the best way to calculate travel distance and time between two addresses?

Calculate travel distance and time between two addresses using free routing for driving, walking, and cycling modes. This approach provides turn-by-turn directions and travel time estimates without requiring paid routing APIs.

Do I need any external dependencies or API keys to use this geocoding and routing functionality?

No external dependencies or API keys are required; the functionality needs only Python 3.8+ standard library. All location intelligence queries run against free OpenStreetMap sources, removing setup barriers entirely.

How do I retrieve timezone data for global coordinates?

Retrieve timezone data for any global coordinates by querying the location intelligence service. This returns timezone information alongside geocoding results, supporting use cases like processing user-submitted location pins across different regions.

What are the limitations of using OpenStreetMap for geocoding and POI search?

Limitations include enforced Nominatim rate limits per terms of service, which may restrict query frequency. The system mitigates POI search resilience using Overpass API mirror fallbacks, but heavy usage may still encounter throttling.