maps

Geocodes coordinates and place names and computes routes, nearby POIs, and timezones via OpenStreetMap, OSRM, and TimeAPI.io.

Updated Apr 9, 2026
One-click install
npx skills add https://github.com/MarbleSodas/Mavis --skill maps-marblesodas
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: maps
Source: https://github.com/MarbleSodas/Mavis/tree/main/skills/productivity/maps
Command: npx skills add https://github.com/MarbleSodas/Mavis --skill maps-marblesodas

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

It solves location-lookup and routing friction by turning place names, coordinates, and user queries into usable geographic results without needing paid APIs.

Core Features & Use Cases

  • Geocode and reverse geocode: Convert a place name to coordinates and coordinates to a human-readable address.
  • POI search (nearby and within area): Find restaurants, hospitals, pharmacies, hotels, and more using OpenStreetMap data.
  • Routing and travel intelligence: Compute driving/walking/cycling distance and duration, plus turn-by-turn directions.
  • Timezone lookup: Determine timezone name, UTC offset, and current local time for coordinates.
  • Use case example: Ask for nearby cafés around a Telegram location pin to get a ranked list of places with distance and tap-to-open map links.

Quick Start

Request coordinates and nearby places from a user by asking: Find nearby restaurants around 48.8584, 2.2945 with a radius of 1500 meters.

Frequently Asked Questions about maps

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

FAQPage Schema
How do I find nearby points of interest using OpenStreetMap data?

POI search uses Overpass to query OpenStreetMap data, finding nearby restaurants, hospitals, or hotels around coordinates with distance and map links. You specify a latitude/longitude and radius to get ranked category results.

Can I compute driving distance and turn-by-turn directions without a paid API?

Routing and travel intelligence uses OSRM to compute driving, walking, and cycling distance with step-by-step directions. It calculates route duration and turn-by-turn instructions without requiring paid API keys.

How do I get the local timezone and UTC offset for specific coordinates?

Timezone lookup queries TimeAPI.io to determine the timezone name, UTC offset, and current local time for provided coordinates. It returns timezone intelligence alongside geocoding and routing results.

Does this geocoding approach work with Telegram location pins?

Geocoding supports Telegram latitude/longitude inputs, converting location pins into nearby category results like cafés or pharmacies. It processes coordinate inputs directly through OpenStreetMap Nominatim and Overpass queries.

What are the limitations of using OpenStreetMap Nominatim for reverse geocoding?

OpenStreetMap Nominatim queries require rate limiting and built-in retries to handle usage constraints. The Skill enforces these automatically, but accuracy depends on OpenStreetMap data coverage and availability in the requested region.