amap-maps-streamableHTTP

OneKey Gateway

Use One Access Key to connect to various commercial APIs. Please visit the OneKey Gateway Keys and read the docs OneKey MCP Router Doc and OneKey Gateway Doc.

Dependencies

Install the required Python package before running any scripts.

pip install ai-agent-marketplace

Alternatively, install dependencies from the requirements file:

pip install -r requirements.txt

If the package is already installed, skip installation.

Agent rule

Before executing any script in the scripts/ directory, ensure the dependencies are installed.

amap-maps-streamableHTTP Skill

Use the OneKey Gateway to access tools for this server via a unified access key.

Quick Start

Set your OneKey access key:

export DEEPNLP_ONEKEY_ROUTER_ACCESS=YOUR_API_KEY

If no key is provided, the scripts fall back to the demo key BETA_TEST_KEY_MARCH_2026. Common settings:

• unique_id: amap-maps-streamableHTTP/amap-maps-streamableHTTP
• api_id: one of the tools listed below

Tools

maps_direction_bicycling

骑行路径规划用于规划骑行通勤方案，规划时会考虑天桥、单行线、封路等情况。最大支持 500km 的骑行路线规划

Parameters:

• origin (string, required): 出发点经纬度，坐标格式为：经度，纬度
• destination (string, required): 目的地经纬度，坐标格式为：经度，纬度

maps_direction_driving

驾车路径规划 API 可以根据用户起终点经纬度坐标规划以小客车、轿车通勤出行的方案，并且返回通勤方案的数据。

Parameters:

• origin (string, required): 出发点经纬度，坐标格式为：经度，纬度
• destination (string, required): 目的地经纬度，坐标格式为：经度，纬度

maps_direction_transit_integrated

根据用户起终点经纬度坐标规划综合各类公共（火车、公交、地铁）交通方式的通勤方案，并且返回通勤方案的数据，跨城场景下必须传起点城市与终点城市

Parameters:

• origin (string, required): 出发点经纬度，坐标格式为：经度，纬度
• destination (string, required): 目的地经纬度，坐标格式为：经度，纬度
• city (string, required): 公共交通规划起点城市
• cityd (string, required): 公共交通规划终点城市

maps_direction_walking

根据输入起点终点经纬度坐标规划100km 以内的步行通勤方案，并且返回通勤方案的数据

Parameters:

• origin (string, required): 出发点经度，纬度，坐标格式为：经度，纬度
• destination (string, required): 目的地经度，纬度，坐标格式为：经度，纬度

maps_distance

测量两个经纬度坐标之间的距离,支持驾车、步行以及球面距离测量

Parameters:

• origins (string, required): 起点经度，纬度，可以传多个坐标，使用竖线隔离，比如120,30|120,31，坐标格式为：经度，纬度
• destination (string, required): 终点经度，纬度，坐标格式为：经度，纬度
• type (string, optional): 距离测量类型,1代表驾车距离测量，0代表直线距离测量，3步行距离测量

maps_geo

将详细的结构化地址转换为经纬度坐标。支持对地标性名胜景区、建筑物名称解析为经纬度坐标

Parameters:

• address (string, required): 待解析的结构化地址信息
• city (string, optional): 指定查询的城市

maps_regeocode

将一个高德经纬度坐标转换为行政区划地址信息

Parameters:

• location (string, required): 经纬度

maps_ip_location

IP 定位根据用户输入的 IP 地址，定位 IP 的所在位置

Parameters:

• ip (string, required): IP地址

maps_schema_personal_map

用于行程规划结果在高德地图展示。将行程规划位置点按照行程顺序填入lineList，返回结果为高德地图打开的URI链接，该结果不需总结，直接返回！

Parameters:

• orgName (string, required): 行程规划地图小程序名称
• lineList (array of object, required): 行程列表
• lineList[].title (string, required): 行程名称描述（按行程顺序）
• lineList[].pointInfoList (array of object, required): 行程目标位置点描述
• lineList[].pointInfoList[].name (string, required): 行程目标位置点名称
• lineList[].pointInfoList[].lon (number, required): 行程目标位置点经度
• lineList[].pointInfoList[].lat (number, required): 行程目标位置点纬度
• lineList[].pointInfoList[].poiId (string, required): 行程目标位置点POIID

maps_around_search

周边搜，根据用户传入关键词以及坐标location，搜索出radius半径范围的POI

Parameters:

• keywords (string, required): 搜索关键词
• location (string, required): 中心点经度纬度
• radius (string, optional): 搜索半径
• strategy (integer, optional): 召回策略，0=默认召回策略，1=优先召回扫街榜POI

maps_search_detail

查询关键词搜或者周边搜获取到的POI ID的详细信息

Parameters:

• id (string, required): 关键词搜或者周边搜获取到的POI ID

maps_text_search

关键字搜索 API 根据用户输入的关键字进行 POI 搜索，并返回相关的信息

Parameters:

• keywords (string, required): 查询关键字
• city (string, optional): 查询城市
• citylimit (boolean, optional): 是否限制城市范围内搜索，默认不限制

maps_schema_navi

Schema唤醒客户端-导航页面，用于根据用户输入终点信息，返回一个拼装好的客户端唤醒URI，用户点击该URI即可唤起对应的客户端APP。唤起客户端后，会自动跳转到导航页面。

Parameters:

• lon (string, required): 终点经度
• lat (string, required): 终点纬度

maps_schema_take_taxi

根据用户输入的起点和终点信息，返回一个拼装好的客户端唤醒URI，直接唤起高德地图进行打车。直接展示生成的链接，不需要总结

Parameters:

• slon (string, optional): 起点经度
• slat (string, optional): 起点纬度
• sname (string, optional): 起点名称
• dlon (string, required): 终点经度
• dlat (string, required): 终点纬度
• dname (string, required): 终点名称

maps_weather

根据城市名称或者标准adcode查询指定城市的天气

Parameters:

• city (string, required): 城市名称或者adcode

Usage

CLI

maps_direction_bicycling

npx onekey agent amap-maps-streamableHTTP/amap-maps-streamableHTTP maps_direction_bicycling '{"origin": "116.481028,39.989643", "destination": "116.465302,40.004717"}'

maps_direction_driving

npx onekey agent amap-maps-streamableHTTP/amap-maps-streamableHTTP maps_direction_driving '{"origin": "116.481028,39.989643", "destination": "116.465302,40.004717"}'

maps_direction_transit_integrated

npx onekey agent amap-maps-streamableHTTP/amap-maps-streamableHTTP maps_direction_transit_integrated '{"origin": "116.481028,39.989643", "destination": "116.465302,40.004717", "city": "北京", "cityd": "上海"}'

maps_direction_walking

npx onekey agent amap-maps-streamableHTTP/amap-maps-streamableHTTP maps_direction_walking '{"origin": "116.481028,39.989643", "destination": "116.465302,40.004717"}'

maps_distance

npx onekey agent amap-maps-streamableHTTP/amap-maps-streamableHTTP maps_distance '{"origins": "116.481028,39.989643|116.465302,40.004717", "destination": "116.481028,39.989643", "type": "1"}'

maps_geo

npx onekey agent amap-maps-streamableHTTP/amap-maps-streamableHTTP maps_geo '{"address": "Beijing Capital Airport", "city": "北京"}'

maps_regeocode

npx onekey agent amap-maps-streamableHTTP/amap-maps-streamableHTTP maps_regeocode '{"location": "116.481488,39.990464"}'

maps_ip_location

npx onekey agent amap-maps-streamableHTTP/amap-maps-streamableHTTP maps_ip_location '{"ip": "8.8.8.8"}'

maps_schema_personal_map

npx onekey agent amap-maps-streamableHTTP/amap-maps-streamableHTTP maps_schema_personal_map '{"orgName": "Weekend Trip", "lineList": [{"title": "Day1", "pointInfoList": [{"name": "Tiananmen", "lon": 116.3975, "lat": 39.9087, "poiId": "B000A8UIN8"}]}]}'

maps_around_search

npx onekey agent amap-maps-streamableHTTP/amap-maps-streamableHTTP maps_around_search '{"keywords": "coffee", "location": "116.481488,39.990464", "radius": "2000"}'

maps_search_detail

npx onekey agent amap-maps-streamableHTTP/amap-maps-streamableHTTP maps_search_detail '{"id": "B0FFFABCD1"}'

maps_text_search

npx onekey agent amap-maps-streamableHTTP/amap-maps-streamableHTTP maps_text_search '{"keywords": "Tsinghua University", "city": "北京", "citylimit": true}'

maps_schema_navi

npx onekey agent amap-maps-streamableHTTP/amap-maps-streamableHTTP maps_schema_navi '{"lon": "116.3975", "lat": "39.9087"}'

maps_schema_take_taxi

npx onekey agent amap-maps-streamableHTTP/amap-maps-streamableHTTP maps_schema_take_taxi '{"slon": "116.3975", "slat": "39.9087", "sname": "Tiananmen", "dlon": "116.481028", "dlat": "39.989643", "dname": "Sanlitun"}'

maps_weather

npx onekey agent amap-maps-streamableHTTP/amap-maps-streamableHTTP maps_weather '{"city": "北京"}'

Scripts

Each tool has a dedicated script in this folder:

• skills/amap-maps-streamableHTTP/scripts/maps_direction_bicycling.py
• skills/amap-maps-streamableHTTP/scripts/maps_direction_driving.py
• skills/amap-maps-streamableHTTP/scripts/maps_direction_transit_integrated.py
• skills/amap-maps-streamableHTTP/scripts/maps_direction_walking.py
• skills/amap-maps-streamableHTTP/scripts/maps_distance.py
• skills/amap-maps-streamableHTTP/scripts/maps_geo.py
• skills/amap-maps-streamableHTTP/scripts/maps_regeocode.py
• skills/amap-maps-streamableHTTP/scripts/maps_ip_location.py
• skills/amap-maps-streamableHTTP/scripts/maps_schema_personal_map.py
• skills/amap-maps-streamableHTTP/scripts/maps_around_search.py
• skills/amap-maps-streamableHTTP/scripts/maps_search_detail.py
• skills/amap-maps-streamableHTTP/scripts/maps_text_search.py
• skills/amap-maps-streamableHTTP/scripts/maps_schema_navi.py
• skills/amap-maps-streamableHTTP/scripts/maps_schema_take_taxi.py
• skills/amap-maps-streamableHTTP/scripts/maps_weather.py

Example

python3 scripts/<tool_name>.py --data '{"key": "value"}'

Related DeepNLP OneKey Gateway Documents

AI Agent Marketplace
Skills Marketplace AI Agent A2Z Deployment
PH AI Agent A2Z Infra
GitHub AI Agent Marketplace

Dependencies

CLI Dependency

Install onekey-gateway from npm

npm install @aiagenta2z/onekey-gateway

Script Dependency

Install the required Python package before running any scripts.

pip install ai-agent-marketplace

Alternatively, install dependencies from the requirements file:

pip install -r requirements.txt

If the package is already installed, skip installation.

Agent rule

Before executing command lines or running any script in the scripts/ directory, ensure the dependencies are installed. Use the npx onekey CLI as the preferred method to run the skills.