Locations
=========
Locations are the physical places where charging stations
are installed and group stations together. Locations
represent a physical place, such as a parking lot or a
shopping mall, where one or more charging stations are
installed. They allow do settings on a group of stations
at once.

Reading
-------
Locations be accessed via the `lcations` `GET` endpoint.
This endpoint will return a list of all visible stations in be.ENERGISED.

The list endpoint is using
`cursor pagination <pagination.html#cursor-based-pagination>`__.

.. code-block:: bash

    curl --location --request GET 'https://<slug>.beenergised.cloud/api/cpoapi/v1/locations/' \
    --header 'Authorization: <access_token>' \
    --header 'Content-Type: application/json'

CRUD operations
---------------
Locations can be created and updated via the `locations`
`POST` and `PUT` endpoints. Delete is possible via the
`locations` `DELETE` endpoint.

Stations can be assigned or removed from a location
via the `locations` `PUT` and `DELETE` endpoints.

A location furthermore can have subjects which are
address, parking type, directions and time settings.