maps

Run the nearby command with coordinates or a --near place name plus a category like restaurant or cafe. It queries the Overpass API and returns names, addresses, distances, opening hours, and Google Maps links sorted by distance.

Use the search command with a free-text place name or address. It calls the Nominatim API, which is free and keyless, and returns latitude, longitude, display name, bounding box, and an importance score.

No, it uses only the Python 3.8+ standard library, so no pip installs are needed. All HTTP calls to Nominatim, Overpass, OSRM, and TimeAPI.io are made with urllib.

Yes, the directions command takes an origin and a --to destination with a mode of driving, walking, or cycling. It returns numbered turn-by-turn steps with instruction, distance, duration, and road name via OSRM.

Public Overpass mirrors can be rate-limited or slow during peak hours. The script automatically falls back between overpass-api.de and overpass.kumi.systems, and Nominatim requests are throttled to 1 request per second per its terms of service.

OSRM routing coverage is best for Europe and North America and may be sparse elsewhere. Also, OSM opening hours are community-maintained, so open-now answers should be verified with a web search when the hours field is missing.