Nearby¶

GET /v1/farmacias/nearby

Devuelve farmacias actuales dentro de un radio, ordenadas por distancia a una coordenada WGS84. Es el endpoint recomendado para estudios de viabilidad, mapas y consumidores como FarmaEstudio, porque evita descargar el snapshot completo cuando solo se necesita el entorno de una ubicacion.

Query params¶

territory_code (requerido): codigo ES-XX.
lat (requerido): latitud WGS84.
lng (requerido): longitud WGS84.
radius_m (default 750, max 100000): radio en metros.
limit (default 500, max 5000): maximo de resultados.
active_only (default true): si se devuelven solo farmacias activas.

Respuesta¶

territory_status: ready | needs_coords | not_loaded | ...
coords_complete: indica si el territorio no tiene coordenadas pendientes.
missing_coords_count: registros del territorio con coordenadas faltantes o invalidas.
requested_latitude, requested_longitude, radius_meters: eco de la consulta.
items: lista de PharmacyRecord con distance_m.

Ejemplo¶

curl -sS "$FARMAAPI_BASE_URL/v1/farmacias/nearby?territory_code=ES-MD&lat=40.4168&lng=-3.7038&radius_m=750&limit=2000" \
  -H "X-API-Key: $FARMAAPI_API_KEY"

503 not_loaded¶

Si el territorio no tiene datos cargados, devuelve 503 con la misma forma que snapshot:

{
  "territory_code": "ES-XX",
  "territory_status": "not_loaded",
  "message": "Territory not loaded yet."
}