maps

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

Use the search command, which calls the free Nominatim geocoding service from OpenStreetMap. It returns latitude, longitude, display name, bounding box, and importance score with no API key or registration required.

No, the script uses only the Python 3.8+ standard library, including urllib and json. There are no pip dependencies to install, so it runs on any system with a standard Python installation.

Yes, the directions command supports driving, walking, and cycling modes via the OSRM routing engine. It returns numbered turn-by-turn steps with instruction text, distance, duration, and road names.

The public Overpass API can be slow during peak hours or rate-limited. The script automatically retries and falls back between two mirrors (overpass-api.de and overpass.kumi.systems) before reporting an error.

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