核心用法
Jadwal Sholat 技能用于查询印度尼西亚境内各城市/地区的伊斯兰祈祷时间(imsak, subuh, dzuhur, ashar, maghrib, isya)。通过调用 api.myquran.com v3 接口,该 API 底层数据源为 Kemenag(宗教事务部)Bimas Islam,具有官方权威性。
主要功能:
- 城市搜索:支持模糊搜索印尼 Kabupaten/Kota,返回匹配列表
- 今日时刻表:获取指定城市当天的完整祈祷时间
- 特定日期查询:支持任意日期(YYYY-MM-DD 格式)
- 月度查询:获取整月祈祷时间表(YYYY-MM 格式)
- 时区适配:默认使用 Asia/Jakarta,支持时区参数
推荐工作流:
使用配套脚本 scripts/myquran_sholat.py 进行交互,支持四种模式:cari(搜索)、hari-ini(今日)、tanggal(指定日期)、bulan(整月)。脚本内置智能匹配逻辑:优先尝试精确匹配(不区分大小写),否则返回首个结果。如匹配不准确,建议使用更具体的关键词或直接使用城市 ID。
显著优点
1. 官方数据源:直接对接 Kemenag Bimas Islam,计算标准权威
2. 覆盖全面:涵盖印尼全境数千个市县区域
3. 灵活查询:支持单次、单日、整月多种时间维度
4. 开发友好:RESTful API + 配套 Python 脚本,降低接入门槛
5. 时区精确:支持时区参数,适应印尼跨时区需求
潜在缺点与局限性
1. 地理范围限制:仅覆盖印尼境内,不支持国际城市
2. 依赖外部服务:API 可用性受 myquran.com 运维影响
3. 搜索匹配精度:模糊搜索可能返回非预期结果,需人工校验或细化关键词
4. 无历史数据:主要服务于当前及未来日期查询
5. 网络依赖:必须联网使用,无离线模式
适合人群
- 印尼穆斯林居民及访客
- 需要集成祈祷时间功能的应用开发者
- 伊斯兰相关服务(旅行社、清真寺应用等)
- 需要自动化祈祷提醒的个人用户
常规风险
- 数据准确性:虽为官方源,极端地理位置或特殊日期可能存在计算偏差
- 隐私考量:搜索关键词可能暴露用户大致地理位置
- 服务中断风险:第三方 API 存在变更或下线可能性
- 时区混淆:用户需确保正确设置时区,避免时间偏差