Mapa en Busqueda Publica

1. Definicion y proposito

Muestra resultados en mapa para reducir tiempo de decision por cercania, trafico y cobertura.

2. Reglas de negocio

• Requiere lat/lng o un centro derivado de geografia seleccionada.
• Debe soportar zoom + cluster de pines.
• Si no hay permisos de geolocalizacion, usar centro de municipio/departamento seleccionado.
• urgency=true prioriza pines con atencion inmediata/24h.

3. Endpoints propuestos

Recurso	Metodo	Descripcion	Rol
/api/v1/search/entities	GET	Resultados para pines de sedes.	Publico
/api/v1/search/doctors	GET	Resultados para pines de profesionales de la salud/sede principal.	Publico
/api/v1/maps/geocode	GET	Geocodificacion de direcciones (si aplica).	Publico

4. Campos minimos

• public_id, type, name.
• lat, lng, distance_km.
• is_24h, supports_urgency.
• next_available_slot.

5. NFR y observabilidad

• Render inicial del mapa < 2s con 200 pines.
• search_p95 < 300ms.
• Eventos: MAP_RESULT_CLICKED, MAP_PIN_SELECTED, MAP_GEO_DENIED.

6. Trazabilidad

• Relacionado con buscador.md, localizacion.md, admin-catalogos.md.
• Nota tecnica: el endpoint conserva alias historico /search/doctors; en producto se presenta como "profesionales de la salud".