maps

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

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, bounding box, and an importance score.

No external packages are needed. The client script uses only the Python 3.8+ standard library (urllib, json, argparse) and calls public HTTP APIs, so there is nothing to install via pip.

Yes, the directions and distance commands accept a --mode flag with driving, walking, or cycling. Routing is handled by OSRM, which maps these modes to its driving, foot, and bike profiles.

Public Overpass servers can be rate-limited or overloaded during peak hours. The script automatically falls back between two mirrors (overpass-api.de and overpass.kumi.systems) and retries transient HTTP errors before failing.

OSRM routing coverage is best for Europe and North America and may be sparse elsewhere. Nominatim also enforces a one-request-per-second limit, which the script handles automatically with built-in rate limiting.