Guardia Pharmacy Spain

Guardia Pharmacy Spain aggregates on-duty pharmacy ("farmacia de guardia") data from Spain's provincial pharmacist associations into a single, normalized JSON API. Spain has no unified national source for this today — each of the ~50 provinces publishes it independently, in inconsistent formats (JSON, CSV, HTML, even PDF). Query by date and municipality and get back a consistent schema (name, address, coordinates, phone, duty schedule) regardless of which province the data came from. Built fo...

原始信息汇总

数据集概述：Guardia Pharmacy Spain

该数据集聚合了西班牙各省药剂师协会发布的值班药店（farmacia de guardia）数据，通过统一的 JSON API 提供查询，解决了西班牙缺乏国家统一数据源、各省格式不一（如 JSON、CSV、HTML、PDF）的问题。

核心功能

• 聚合查询：根据日期和市镇，返回值班药店的标准化信息（名称、地址、坐标、电话、值班时间）。
• 单一规范接口：无论数据来自哪个省份，输出格式一致，省去用户逐个解析多个政府门户的麻烦。
• 适用场景：健康与保健应用、药店定位器、保险与远程医疗产品，以及需要告知用户附近值班药店的后台管理工具。

覆盖范围

数据按省份逐步接入，当前已覆盖：

• 卡斯特利翁（Castellón）
• 巴伦西亚（Valencia）
• 马拉加（Málaga） 更多省份持续增加中。

接口说明

• 推荐端点：GET /api/v2/guardias
  • 查询参数：date（可选，日期，格式 yyyy-MM-dd，默认为当天）、municipality（可选，市镇名称）、page（可选，分页索引，从0开始）、size（可选，每页数量，1-100，默认20）。
  • 响应结构：分页信封，包含 content（药店数组）、page、size、totalElements、totalPages。
  • 每个药店字段：
    • sourceId：数据来源省份代码（如 "castellon"）。
    • name：药店名称。
    • address：地址（街、邮政编码、市镇、省份）。
    • coordinates：坐标（可能缺失）。
    • phone：电话（可能缺失）。
    • schedules：值班时段列表，包含日期、起止时间（HH:mm:ss，endTime 早于 startTime 表示跨天）、是否为24小时值班。
    • fetchedAt：数据抓取时间（用于评估数据新鲜度）。
• 已弃用端点：GET /api/v1/guardias，返回未分页的 JSON 数组。

数据新鲜度说明

数据定期从各省源刷新，并非实时。可通过 fetchedAt 字段判断数据时效性。