系列「每天一个高质量 API」第 14 篇。搜蚁智选(souyi.net.cn)是一个面向 AI Agent 的 API 发现与统一调用平台。今天聊 ISS 空间站实时位置(free-space-iss-position)。
国际空间站此刻在哪:经纬度、海拔、速度、可见性,一次请求全拿到。
这个 API 能做什么
Where the ISS at? 按 NORAD ID 25544 返回国际空间站当前状态:latitude / longitude(度)、altitude(公里)、velocity(公里/小时)、visibility(daylight 或 eclipsed)、footprint(地面可见范围半径)、timestamp。数据约每秒更新。
为什么 AI Agent 需要它
- 科普 / 教育 Agent:回答「国际空间站现在飞在哪个国家上空」。
- 可视化:纬度经度直接丢到地图上打点,配合 footprint 画覆盖圈。
- 可见性判断:
visibility=daylight表示空间站处于被太阳照亮的一侧,是观测窗口的判据之一。
怎么用
方式一:直连上游(免费、无需 Key)
curl "https://api.wheretheiss.at/v1/satellites/25544"
方式二:经搜蚁智选一键调用(带 Key,统一计费 / 限流 / 可观测)
curl -X POST https://souyi.net.cn/api/v1/ai/request \
-H "X-API-Key: YOUR_AIMALL_KEY" \
-H "Content-Type: application/json" \
-d '{"asset_id":"free-space-iss-position","call_data":{}}'
这些免费 API 的上游本身免密;经搜蚁智选代理后,多个数据源可以聚合到同一个 Agent 工作流里,统一走 X-API-Key + 统一计费、限流与可观测,省去每个上游单独接一遍。
返回示例
{
"name": "iss",
"id": 25544,
"latitude": -42.434987924443,
"longitude": -165.00054930898,
"altitude": 430.61999143443,
"velocity": 27557.329582959,
"visibility": "daylight",
"footprint": 4561.1033262005,
"timestamp": 1792465027,
"units": "kilometers"
}
价格
免费。上游限速约 1 req/s,轮询间隔别小于 1 秒。
怎么拿到 Key
注册 souyi.net.cn → 控制台一键生成 X-API-Key → 即可调用平台全部 API(含本系列 22 个)。
小结
这是最便宜的一个「真实世界锚点」:数字每秒钟都在变,Agent 拿它做演示、做科普,说服力远胜静态示例数据。
更多免费 API 见 系列目录。