搜索

PythonReactSEOPDF
OpenClaw

maps

Distance, routing, and geocoding using free APIs (OSRM + Nominatim/OSM). Use when the user asks about distance between places, travel time, directions, how far something is, or needs to convert a place name to coordinates. No API key required. Requires python3 (3.6+).

adhishthite0 来源安装数☆ 0 仓库 Stars

安装与使用

请根据来源仓库和你的 AI 工具说明安装此技能。先阅读技能文件和依赖要求,再添加到工作流。

SkillHub CLI

skillhub install adhishthite/maps-osrm

打开来源仓库,查看说明和兼容环境后,按来源提供的命令或步骤安装。

将来源链接提供给你的 Agent,让它先读取说明、核对依赖,并向你说明将执行的安装步骤。

查看来源 ↗使用指南

技能说明

Maps

Free distance/routing (OSRM) and geocoding (Nominatim/OSM). No API keys needed.

Geocoding (place name → coordinates)

bash scripts/geocode.sh "Times Square, New York"

Returns lat,lon and display name. Use this first when you have place names instead of coordinates.

Distance & Route

bash scripts/distance.sh <origin_lat>,<origin_lon> <dest_lat>,<dest_lon> [mode]

Modes: driving (default), foot, bicycle

Examples:

# Manhattan to JFK Airport
bash scripts/distance.sh 40.7580,-73.9855 40.6413,-73.7781 driving

# Golden Gate Park to Fisherman's Wharf (walking)
bash scripts/distance.sh 37.7694,-122.4862 37.8080,-122.4177 foot

Workflow

  1. If user gives place names → geocode both with geocode.sh
  2. Use returned lat,lon pairs with distance.sh
  3. Report distance in km and duration in minutes

Limits

  • OSRM: free public demo server, no hard rate limit but be reasonable
  • Nominatim: max 1 request/second (OSM policy), include User-Agent
  • No live traffic data — durations are estimates based on road type/speed
  • Routing is road-network only (no public transit)

来源信息

Source
github
Repository
openclaw/skills
Path
skills/adhishthite/maps-osrm
Version
—
Commit
ebbe0144eb49a136d4ba09969f092a1748cbfe5a
分类来源
rules
状态
active
可见性
public

这些信息来自收录时的来源分析,可能滞后;使用前请核对最新来源文件。

README

Maps Skill

Free distance, routing, and geocoding for OpenClaw — no API keys required.

What it does

  • Geocode place names to coordinates using Nominatim (OpenStreetMap)
  • Route & distance between two points using OSRM (Open Source Routing Machine)
  • Supports driving, walking, and cycling modes

Requirements

  • python3 (3.6+)
  • POSIX shell (bash)

Usage

Geocode a place
bash scripts/geocode.sh "Central Park, New York"
# [1] Central Park, Manhattan, New York, USA
#     lat,lon: 40.7828647,-73.9653551
#     type: park / leisure
Get distance & travel time
bash scripts/distance.sh 40.7580,-73.9855 40.6413,-73.7781 driving
# Mode: driving
# Distance: 20.3 km
# Duration: 22 min
Modes
Mode Aliases
Driving driving, car
Walking foot, walk, walking
Cycling bicycle, bike, cycling

How it works

  • Geocoding: Queries Nominatim's free API (1 req/sec rate limit per OSM policy)
  • Routing: Queries OSRM's public demo server for shortest path on the road network
  • No API keys needed — both services are free and open

Limitations

  • No live traffic data — durations are road-type estimates
  • No public transit routing
  • OSRM demo server is best-effort (not for high-volume production use)
  • Nominatim rate limit: 1 request per second

License

MIT

来源内容

SKILL.md
# Maps

Free distance/routing (OSRM) and geocoding (Nominatim/OSM). No API keys needed.

## Geocoding (place name → coordinates)

```bash
bash scripts/geocode.sh "Times Square, New York"
```

Returns lat,lon and display name. Use this first when you have place names instead of coordinates.

## Distance & Route

```bash
bash scripts/distance.sh <origin_lat>,<origin_lon> <dest_lat>,<dest_lon> [mode]
```

Modes: `driving` (default), `foot`, `bicycle`

Examples:
```bash
# Manhattan to JFK Airport
bash scripts/distance.sh 40.7580,-73.9855 40.6413,-73.7781 driving

# Golden Gate Park to Fisherman's Wharf (walking)
bash scripts/distance.sh 37.7694,-122.4862 37.8080,-122.4177 foot
```

## Workflow

1. If user gives place names → geocode both with `geocode.sh`
2. Use returned lat,lon pairs with `distance.sh`
3. Report distance in km and duration in minutes

## Limits

- OSRM: free public demo server, no hard rate limit but be reasonable
- Nominatim: max 1 request/second (OSM policy), include User-Agent
- No live traffic data — durations are estimates based on road type/speed
- Routing is road-network only (no public transit)
README
# Maps Skill

Free distance, routing, and geocoding for OpenClaw — no API keys required.

## What it does

- **Geocode** place names to coordinates using [Nominatim](https://nominatim.openstreetmap.org/) (OpenStreetMap)
- **Route & distance** between two points using [OSRM](https://router.project-osrm.org/) (Open Source Routing Machine)
- Supports driving, walking, and cycling modes

## Requirements

- `python3` (3.6+)
- POSIX shell (bash)

## Usage

### Geocode a place

```bash
bash scripts/geocode.sh "Central Park, New York"
# [1] Central Park, Manhattan, New York, USA
#     lat,lon: 40.7828647,-73.9653551
#     type: park / leisure
```

### Get distance & travel time

```bash
bash scripts/distance.sh 40.7580,-73.9855 40.6413,-73.7781 driving
# Mode: driving
# Distance: 20.3 km
# Duration: 22 min
```

### Modes

| Mode | Aliases |
|------|---------|
| Driving | `driving`, `car` |
| Walking | `foot`, `walk`, `walking` |
| Cycling | `bicycle`, `bike`, `cycling` |

## How it works

- **Geocoding**: Queries Nominatim's free API (1 req/sec rate limit per OSM policy)
- **Routing**: Queries OSRM's public demo server for shortest path on the road network
- **No API keys** needed — both services are free and open

## Limitations

- No live traffic data — durations are road-type estimates
- No public transit routing
- OSRM demo server is best-effort (not for high-volume production use)
- Nominatim rate limit: 1 request per second

## License

MIT

相关技能