maps

Use the nearby command with coordinates or a --near address to query the Overpass API for OpenStreetMap POIs. It supports 46 categories like restaurant, cafe, hospital, and pharmacy, returning names, distances, and clickable map links with no API key required.

The search command geocodes free-text place names through the Nominatim API using only Python's standard library urllib. It returns latitude, longitude, display name, bounding box, and an importance score for up to five results.

Yes, the distance and directions commands support driving, walking, and cycling modes via OSRM profiles. Directions returns numbered turn-by-turn steps with instruction text, distance, duration, road name, and maneuver type.

Yes, use the area command to get a named place's bounding box, then pass those coordinates to the bbox command with a category. This finds all matching POIs within the rectangle, useful for queries like restaurants in downtown Seattle.

Nominatim enforces a 1 request per second rate limit, which the script handles automatically. Overpass can be slow at peak hours, so the script falls back between mirrors, and OSRM routing coverage is best in Europe and North America.