Auckland Bus Stops

Location of AT Bus Stops and Routes (Auckland, New Zealand). This API is a public utility. It may change or be discontinued without notice.

原始信息汇总

Auckland Bus Stops API 数据集概述

基本信息

• 数据集名称：Auckland Bus Stops
• 类别：Transportation
• 提供者：augsmachado
• 访问地址：https://rapidapi.com/augsmachado/api/auckland-bus-stops
• 定价：Freemium（免费使用，但有速率限制）
• 服务等级：100% Service Level
• 延迟：259ms Latency
• 流行度：8.7 Popularity

数据集描述

• 数据来源：Auckland Transport 的开放公交站点数据集。
• 数据格式：JSON/HTTP 包装的 Parquet 快照。
• 地理范围：新西兰奥克兰的公交站点和路线位置。
• 更新频率：源数据定期刷新，但 API 层面不保证数据新鲜度。
• 性质：公共实用程序，用于实验、原型设计和研究。
• 免责声明：
  • 可能更改或终止服务，恕不另行通知。
  • 非奥克兰交通局的官方服务。
  • 非为关键任务或生产级 SLO 支持的 API 设计。

功能与用途

主要功能

• 提供只读 REST API。
• 支持通过分页和部分名称匹配查询站点。
• 支持通过精确 stop_code 查询站点。
• 支持通过站点名称或坐标对（lat, lon）进行邻近查询。
• 使用 Haversine 距离近似计算进行地理空间查询。

典型用途

• 围绕公交站点位置构建小型演示或仪表板。
• 快速探索站点及其近似空间关系。
• 作为教学、实验室或空间数据练习的后端。

限制与注意事项

非目标功能

• 非实时、保证新鲜的数据源。
• 非官方路线或时刻表 API（不提供路线规划、时刻表、延误或实时车辆位置）。
• 非完整 GIS 引擎（仅支持通过 DuckDB 计算 Haversine 距离的基本邻近查询）。
• 非通用 GTFS API（仅关注站点；路线、行程、日历等超出范围）。

使用限制

• 速率限制：每分钟 10 个请求。
• 数据可能不完整或略微过时。
• 服务可能更改或终止。

负责任使用建议

• 请勿将此 API 作为安全关键或运营决策的唯一真相来源。
• 遵守速率限制和 API 密钥策略。
• 如果基于此 API 构建应用，请告知用户数据可能不完整或略微过时，且服务可能更改或终止。

API 端点参考

健康检查

• 端点：GET /
• 描述：返回 API 基本信息及其运行时间。

站点列表

• 端点：GET /stops
• 描述：列出公交站点（分页），可选部分名称过滤。
• 查询参数：
  • limit：结果数量（默认 50，最小 1，最大 1000）。
  • offset：分页偏移量（默认 0，最小 0）。
  • name：站点名称的部分匹配（不区分大小写，可选）。

站点详情

• 端点：GET /stops/code/{stop_code}
• 描述：通过数字代码获取公交站点的完整详情。
• 路径参数：stop_code（整数，数据集中的站点代码）。

按名称查找邻近站点

• 端点：GET /stops/nearby/by-name
• 描述：给定站点名称（部分或完整），查找其坐标并返回半径内的邻近站点。
• 查询参数：
  • stop_name：站点名称（部分或完整，不区分大小写，必需）。
  • radius_m：最大距离（米，默认 100.0，最小 0）。
  • limit：考虑候选站点的上限数量（默认 20，最小 1，最大 200）。

按坐标查找邻近站点

• 端点：GET /stops/nearby/by-coords
• 描述：给定坐标，返回半径内的邻近站点。
• 查询参数：
  • lat：纬度（度，必需）。
  • lon：经度（度，必需）。
  • radius_m：最大距离（米，默认 100.0，最小 0）。
  • limit：在按半径过滤前考虑的最近站点数量（默认 20，最小 1，最大 200）。

技术实现

• 后端框架：FastAPI。
• 数据库引擎：DuckDB（支持 SQL 查询过滤、排序、分页和 Haversine 距离计算）。
• 部署：轻量级部署（设计为在 Cloud Run / 容器上轻松运行）。
• 日志：JSON 结构化日志，便于观察。
• 速率限制：基于每 IP 的速率限制。

搜集汇总

背景与挑战

背景概述

该数据集提供新西兰奥克兰地区的公交站点与线路位置信息，通过公共API形式开放，但可能随时变更或终止服务。