BroadbandMap Cell Coverage
Status: Preliminary skill (v0.x). This is an intentionally small first release and is expected to evolve quickly.
Use this skill to answer: “How good is cell coverage here?” for a specific location.
Quick workflow
- 1. Resolve location to coordinates (lat/lon).
- Run
scripts/cell_coverage_lookup.py to call the coverage API. - Summarize key results:
- top carriers
- network tech (4G/5G)
- confidence/quality fields if present
- 4. Include caveats when API fields are missing or endpoint behavior is unknown.
Run the script
CODEBLOCK0
Default endpoint used by this skill:
- - INLINECODE1
- Optional filters:
network (att|verizon|t-mobile|us-cellular|dish|gci|cellcom|c-spire), tech (4g|5g)
Address mode (uses OpenStreetMap Nominatim geocoding first):
CODEBLOCK1
Optional overrides and filters:
CODEBLOCK2
Advanced endpoint overrides:
CODEBLOCK3
Output contract
The script prints JSON by default with:
- -
input: address/lat/lon used - INLINECODE7 : final URL and query params
- INLINECODE8 : parsed API JSON (or raw body)
- INLINECODE9 : best-effort normalized fields (
providers, technologies, notes) - INLINECODE13 : any recoverable errors
Use --format report for a concise human-readable output.
Example commands
CODEBLOCK4
Known limitations
- - This skill is a preliminary v0.x release and will be iterated/enhanced.
- API is alpha and may change schema/limits without notice.
- Default public limit is low (~60 requests/hour/IP).
- Coverage maps are modeled estimates and may differ from real-world signal.
Response style
When replying to users:
- - Start with a one-paragraph answer.
- Then list providers/technologies in bullets.
- End with one caveat sentence: coverage maps are estimates and real-world signal may vary.
references/
Read references/api-notes.md when endpoint details need adjustment.
Links
- - Full coverage map: https://broadbandmap.com/coverage
- Developer resources: https://broadbandmap.com/developers
BroadbandMap 蜂窝网络覆盖
状态： 初步技能（v0.x版本）。这是有意设计的小型初始版本，预计将快速迭代。
使用此技能回答特定位置的疑问：这里的蜂窝网络覆盖情况如何？
快速工作流程
- 1. 将位置解析为坐标（纬度/经度）。
- 运行 scripts/cellcoveragelookup.py 调用覆盖范围API。
- 总结关键结果：
- 主要运营商
- 网络技术（4G/5G）
- 置信度/质量字段（如存在）
- 4. 当API字段缺失或端点行为未知时包含注意事项。
运行脚本
bash
python3 scripts/cellcoveragelookup.py --lat 39.7392 --lon -104.9903
此技能使用的默认端点：
- - GET /api/v1/location/cell?lat={lat}&lng={lng}
- 可选筛选条件：network（att|verizon|t-mobile|us-cellular|dish|gci|cellcom|c-spire），tech（4g|5g）
地址模式（首先使用OpenStreetMap Nominatim地理编码）：
bash
python3 scripts/cellcoveragelookup.py --address Denver, CO
可选覆盖和筛选条件：
bash
python3 scripts/cellcoveragelookup.py \
--lat 39.7392 --lon -104.9903 \
--network verizon \
--tech 5g \
--format report
高级端点覆盖：
bash
python3 scripts/cellcoveragelookup.py \
--lat 39.7392 --lon -104.9903 \
--base-url https://broadbandmap.com \
--endpoint /api/v1/location/cell \
--param-lat lat --param-lon lng \
--api-key $BROADBANDMAPAPIKEY
输出约定
脚本默认输出JSON，包含：
- - input：使用的地址/纬度/经度
- request：最终URL和查询参数
- response：解析后的API JSON（或原始内容）
- summary：尽力标准化的字段（providers、technologies、notes）
- errors：任何可恢复的错误
使用 --format report 获取简洁的人类可读输出。
示例命令
bash
按地址基本查询
python3 scripts/cell
coveragelookup.py --address Austin, TX --format report
筛选至单一网络且仅5G
python3 scripts/cell
coveragelookup.py --address Seattle, WA --network verizon --tech 5g --format report
用于自动化/管道的原始JSON
python3 scripts/cell
coveragelookup.py --lat 34.0522 --lon -118.2437 --format json
已知限制
- - 此技能为初步v0.x版本，将持续迭代/增强。
- API处于alpha阶段，可能随时更改架构/限制，恕不另行通知。
- 默认公共限制较低（约60次请求/小时/IP）。
- 覆盖地图为建模估算，可能与实际信号存在差异。
回复风格
回复用户时：
- - 以一段话的答案开头。
- 然后以项目符号列出提供商/技术。
- 以一句注意事项结尾：覆盖地图为估算值，实际信号可能有所不同。
references/
当端点详情需要调整时，请阅读 references/api-notes.md。
链接
- - 完整覆盖地图：https://broadbandmap.com/coverage
- 开发者资源：https://broadbandmap.com/developers
