'The current home location (:py:class:`LocationGlobal`).
To get the attribute you must first download the :py:func:`Vehicle.commands`.
The attribute has a value of ``None`` until :py:func:`Vehicle.commands` has been downloaded
**and** the autopilot has set an initial home location (typically where the vehicle first gets GPS lock).
.. code-block:: python
#Connect to a vehicle object (for example, on com14)
vehicle = connect(\'com14\', wait_ready=True)
# Download the vehicle waypoints (commands). Wait until download is complete.
cmds = vehicle.commands
cmds.download()
cmds.wait_ready()
# Get the home location
home = vehicle.home_location
The ``home_location`` is not observable.
The attribute can be written (in the same way as any other attribute) after it has successfully
been populated from the vehicle. The value sent to the vehicle is cached in the attribute
(and can potentially get out of date if you don\'t re-download ``Vehicle.commands``):
.. warning::
Setting the value will fail silently if the specified location is more than 50km from the EKF origin.'

@property
def home_location(self):

    return copy.copy(self._home_location)
