← Back to Skills Marketplace
vemec

SmartRoute - Google Routes Calculator

by vemec · GitHub ↗ · v1.0.4
cross-platform ✓ Security Clean
1498
Downloads
2
Stars
2
Active Installs
5
Versions
Install in OpenClaw
/install smart-route
Description
Calculate traffic-aware routes, travel times, and distances between locations using Google Routes API. Use when the user asks for "traffic to X", "how long to get to Y", "best route to Z", or "drive time". Returns JSON with duration, distance, and a direct Google Maps navigation link.
Usage Guidance
This skill appears coherent and implements only the documented Google Routes API calls, but consider the following before installing: - Provide a dedicated Google API key with the Routes API enabled and restrict that key (by referrer, IP, or API restrictions) to limit blast radius and accidental billing. - The script prints the origin/destination (PII) to stdout; avoid using sensitive addresses if you need privacy. - Keep the API key in a secure environment variable (as recommended) and avoid passing it on the CLI to prevent exposure in process lists. - Review and test the script in your environment (it has a small parsing assumption for duration) before trusting it in production. - If you allow autonomous agent invocation, monitor usage and billing (autonomous calls can consume quota).
Capability Analysis
Type: OpenClaw Skill Name: smart-route Version: 1.0.4 The skill bundle is benign. The `SKILL.md` clearly outlines the skill's purpose, required environment variables, and security considerations, without any prompt injection attempts against the agent. The `get_route.js` script correctly implements the described functionality, reading the `GOOGLE_ROUTES_API_KEY` from environment variables and making HTTPS requests to `routes.googleapis.com`. User inputs are safely parsed from `process.argv` and embedded into a JSON request body, preventing direct shell injection within the script. There is no evidence of data exfiltration beyond the stated purpose, unauthorized execution, or other malicious behaviors.
Capability Assessment
Purpose & Capability
Name/description match the actual implementation: a Node.js script that calls routes.googleapis.com. The only required binary (node) and required env var (GOOGLE_ROUTES_API_KEY) are appropriate for this functionality.
Instruction Scope
SKILL.md instructs running the included script with origin/destination and documents PII considerations. The script only sends addresses to Google Routes API and writes results to stdout; it does not read other files, other env vars, or contact other endpoints.
Install Mechanism
No install spec (instruction-only) and a single small JS file are present. The skill assumes node is already installed; there are no downloads or archive extraction steps.
Credentials
Only GOOGLE_ROUTES_API_KEY is required, which is proportional and expected. No unrelated credentials or config paths are requested.
Persistence & Privilege
always is false and the skill does not request persistent system-wide changes or write other skills' configs. Autonomous invocation is allowed (default) but the skill's scope is limited to the Routes API.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install smart-route
  3. After installation, invoke the skill by name or use /smart-route
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.4
- Added a privacy notice explaining that origin and destination addresses are sent to Google and printed in JSON, marking them as PII. - Updated metadata to explicitly require the presence of the Node.js binary.
v1.0.3
- Added a Privacy & Security section clarifying the skill only accesses routes.googleapis.com and restricts credential input to environment variables. - Emphasized that API keys cannot be passed via CLI flags, reducing risk of exposing secrets. - No changes to code or core functionality; documentation only.
v1.0.2
- Updated skill metadata to use the "openclaw" property for emoji and environment variable requirements. - Removed redundant "primary_credential" and "requires" fields from the top-level metadata.
v1.0.1
- Added metadata field primary_credential: GOOGLE_ROUTES_API_KEY for clarity on required credentials. - Updated usage examples to reference major US cities (San Francisco, Los Angeles) for better relevance. - Expanded the Configuration section with detailed API credential setup instructions and strict environment variable detection. - The skill now enforces runtime checking for the GOOGLE_ROUTES_API_KEY variable and exits on missing credentials.
v1.0.0
- Initial release of smart-route skill. - Calculates real-time, traffic-aware routes, travel times, and distances between locations using the Google Routes API. - Returns JSON with duration, distance, and a direct Google Maps navigation link. - Supports multiple travel modes (DRIVE, BICYCLE, WALK). - Requires configuration of the GOOGLE_ROUTES_API_KEY environment variable.
Metadata
Slug smart-route
Version 1.0.4
License
All-time Installs 2
Active Installs 2
Total Versions 5
Frequently Asked Questions

What is SmartRoute - Google Routes Calculator?

Calculate traffic-aware routes, travel times, and distances between locations using Google Routes API. Use when the user asks for "traffic to X", "how long to get to Y", "best route to Z", or "drive time". Returns JSON with duration, distance, and a direct Google Maps navigation link. It is an AI Agent Skill for Claude Code / OpenClaw, with 1498 downloads so far.

How do I install SmartRoute - Google Routes Calculator?

Run "/install smart-route" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is SmartRoute - Google Routes Calculator free?

Yes, SmartRoute - Google Routes Calculator is completely free (open-source). You can download, install and use it at no cost.

Which platforms does SmartRoute - Google Routes Calculator support?

SmartRoute - Google Routes Calculator is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created SmartRoute - Google Routes Calculator?

It is built and maintained by vemec (@vemec); the current version is v1.0.4.

💬 Comments