The southern coast of the Central American nation offers beachfront villas, amenity-filled gated communities and activities near Panama City.