Map Grabber

Get site base maps from OpenStreetMap: provide an address, receive street network and optional building footprints as vector data (SVG, GeoPackage, or DXF) for use in CAD or Rhino.

Dependencies

• osmnx (OSM data and graph; requires geopandas, networkx)
• ezdxf (optional; for DXF export)

Usage

Grab map by address

Parameters:

• address: Address or place name (e.g. "SoHo, New York" or "123 Main St, Los Angeles").
• --dist: Radius in meters around the point (default 500).
• --buildings: Also download building footprints.
• --svg: Output path for SVG (street network plot).
• --png: Output path for PNG (same map as image; use for Telegram or preview).
• --gpkg: Output path for GeoPackage (streets and optionally buildings as layers).
• --dxf: Output path for DXF (requires ezdxf; for CAD/Rhino).

# PNG for Telegram + GeoPackage
python3 scripts/grab_map.py "Times Square, New York" --dist 400 --png site.png --gpkg site.gpkg

# With buildings and DXF
python3 scripts/grab_map.py "Shanghai Tower, Shanghai" --dist 500 --buildings --png site.png --gpkg site.gpkg --dxf site.dxf

Output: street network (and optionally buildings) in the requested formats.

Sending images to Telegram

Used from the OpenClaw Telegram conversation. To show the user the map: run the script with --png .png (e.g. --png site.png), then send that PNG to the conversation via the OpenClaw message/media tool. Use --png (not only --svg) when the user expects an image in chat.

OpenClaw allowed paths: The message tool only sends files from allowed dirs (~/.openclaw/media/, ~/.openclaw/agents/, or /tmp). Use e.g. --png ~/.openclaw/media/site.png or --png /tmp/site.png; do not use the skill install directory or sending will fail.

Agent behavior: When the user asks for a site map, base map, or OSM map (by address or place name), run the script directly using exec: call grab_map.py with the given address, --png .png with under an allowed dir (and optional --dist, --buildings), then send the generated PNG to the user. Do not ask for confirmation; execute and return the image and a short confirmation.

Examples

User: "Get me a site base map for 123 Main St" or "抓一张这个地址的场地底图." Action: Run grab_map.py "123 Main St" --png /tmp/site.png (or similar path), then send the PNG to the user and confirm.

User: "Get me a site base map for 123 Main St as SVG and DXF." Action: Run grab_map.py with that address, --svg, --dxf, and optionally --png for chat; return the file paths and confirmation.

User: "I need OSM data for this address with building footprints for Rhino." Action: Run with --buildings, --gpkg and optionally --dxf; if they want an image in chat, also use --png and send it.