PCMiler:专业卡车路径规划与地理编码 - Openclaw Skills

作者:互联网

2026-04-17

AI快讯

什么是 PCMiler?

PCMiler 技能为 PCMiler REST API 提供了强大的接口,该 API 是物流和运输行业的黄金标准。通过将此技能与 Openclaw Skills 集成,开发人员可以授权 AI 代理处理复杂的路径规划任务,检索详细的地理坐标,并管理商业车辆物流。它弥合了原始物流数据与智能自动化之间的差距,允许在统一的 AI 工作流中进行自动路径报告和地址验证。

此技能对于构建需要高保真地图数据和商业级路径规划逻辑的供应链解决方案或车队管理工具的开发人员特别有价值。利用 Openclaw Skills 执行这些任务可确保您的 AI 代理具备做出明智物流决策所需的技术背景。

下载入口:https://github.com/openclaw/skills/tree/main/skills/nchoudhury-trimble/pcmiler

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

npx clawhub@latest install pcmiler

2. 手动安装

将技能文件夹复制到以下位置之一

全局模式 ~/.openclaw/skills/ 工作区 /skills/

优先级:工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

请帮我使用 Clawhub 安装 pcmiler。如果尚未安装 Clawhub,请先安装(npm i -g clawhub)。

PCMiler 应用场景

  • 使用特定地理坐标为商业卡车运输业务生成详细的路径报告。
  • 将物理地址转换为精确的经纬度坐标以进行物流规划。
  • 自动检索多个商业停靠点之间的行驶时间和距离。
  • 验证不同地区的送货地点和邮政编码,以确保数据准确性。
PCMiler 工作原理
  1. AI 代理通过 Openclaw Skills 接口接收需要路径规划或地理编码信息的提示。
  2. 该技能使用安全的集成环境 API 密钥通过 PCMiler REST API 进行身份验证。
  3. 对于路径规划,代理向 routeReports 端点发送停靠点列表,以接收 MultiLineString 几何图形和时间/距离指标。
  4. 对于地理编码,代理使用街道、城市、州和国家等特定地址详情查询 locations 端点。
  5. 解析生成的 JSON 数据并将其返回给代理,以供后续物流操作或用户报告使用。

PCMiler 配置指南

要在 Openclaw Skills 生态系统中使用此工具,您必须使用来自 ALK Technologies 的有效 API 密钥配置您的环境。

设置以下环境变量:

export PCMILER_API_KEY='your_api_key_here'

使用简单的 curl 命令测试连接,以验证身份验证是否激活。

PCMiler 数据架构与分类体系

该技能与来自 ALK 服务的结构化 JSON 数据交互。关键数据组件包括:

对象 字段 描述
RoutePathReport geometry, TMinutes, TDistance 包含商业路线的 MultiLineString 坐标和行程时长。
Coords Lat, Lon 地理编码位置的地理坐标。
Address StreetAddress, City, State, Zip 详细的地址组件和元数据,包括县和国家。
Region Region ID 正在查询的地理区域的数字标识符(例如,北美为 NA)。
name: pcmiler
description: |
  PCMier REST API provides methods to retrieves a series of geographic coordinates that make up a route.
compatibility: Requires network access and valid PCMiler API key
metadata:
  author: nirjhar
  version: "1.0"

PCMiler

Access the PCMiler REST API with API authentication. Manage truck routing needs.

Quick Start

# Show route report
curl -s -X GET "https://pcmiler.alk.com/apis/rest/v1.0/Service.svc/route/routeReports?stops=-75.173297%2C39.942892%3B-74.83153%2C39.61703%3B-74.438942%2C39.362469&reports=RoutePath" -H "Authorization: $PCMILER_API_KEY"

Example JSON Response
[
    {
        "__type": "RoutePathReport:http://pcmiler.alk.com/APIs/v1.0",
        "RouteID": null,
        "type": "Feature",
        "geometry": {
            "type": "MultiLineString",
            "coordinates": [
                [
                    [
                        -75.173297,
                        39.942892
                    ],
                    [
                        -74.439742,
                        39.362342
                    ]
                ]
            ]
        },
        "TMinutes": 102,
        "TDistance": 74.411,
        "properties": null
    }
]
# Geocode an address to fir lat/lon
curl -s -X GET "https://pcmiler.alk.com/apis/rest/v1.0/Service.svc/locations?street=1%20Independence%20Way&city=princeton&state=nj&country=US&postcode=08540&postcodeFilter=us®ion=NA&dataset=Current" -H "Authorization: $PCMILER_API_KEY"

Example JSON Response
[
    {
        "Address": {
            "StreetAddress": "1 Independence Way",
            "City": "Princeton",
            "State": "NJ",
            "Zip": "08540",
            "County": "Mercer",
            "Country": "United States",
            "SPLC": null,
            "CountryPostalFilter": 0,
            "AbbreviationFormat": 0,
            "StateName": "New Jersey",
            "StateAbbreviation": "NJ",
            "CountryAbbreviation": "US"
        },
        "Coords": {
            "Lat": "40.360639",
            "Lon": "-74.599867"
        },
        "Region": 4,
        "Label": "",
        "PlaceName": "",
        "TimeZone": "EST",
        "Errors": [],
        "SpeedLimitInfo": null,
        "ConfidenceLevel": "Exact",
        "DistanceFromRoad": null,
        "CrossStreet": null,
        "TimeZoneOffset": "GMT-5:00",
        "TimeZoneAbbreviation": "EST",
        "IsDST": false
    }
]

Setup

Requires environment variable

  • PCMILER_API_KEY - PCMiler API Key