maps

Use the nearby command with coordinates or a --near address and a category like restaurant, cafe, or pharmacy. It queries the Overpass API across 46 categories and returns names, distances, opening hours, and clickable Google Maps links sorted by distance.

Run the search command with a place name or address; it uses the free Nominatim service from OpenStreetMap, which requires no API key. Results include latitude, longitude, display name, bounding box, and importance score.

No, it uses only the Python 3.8+ standard library (urllib, json, math, argparse). There are no pip installs or external dependencies, and no API keys are needed for any of the data sources.

Yes, the directions command returns turn-by-turn steps via OSRM for driving, walking, or cycling modes. Each step includes the instruction, road name, distance, duration, and maneuver type such as turn, depart, or arrive.

The Overpass API can be slow during peak hours, so the script automatically falls back between two public mirrors. Nominatim also enforces a 1 request per second limit, which the script handles with built-in rate limiting.

OSRM routing coverage is best for Europe and North America and may be incomplete elsewhere. Also, opening hours come from community-maintained OpenStreetMap data, so verify current hours with a web search when accuracy matters.