Improve error message when metadata cannot be encoded

[benjeffery]

See tskit-dev/tsinfer#546 We currently report TypeError: Object of type TYPE is not JSON serializable when encoding things that are not supported. It would be better to catch and re-raise with an error message that mentions metadata.