.. _how-to-fetch-cps:

How to Fetch Charging Stations
------------------------------

Depending on your scenario, there are various ways to retrieve charging
stations using our API.

* Select one specific charging station (`cp`_)
* Select all available charging stations (`cpsPaged`_)
* Select all available charging stations based
  on a GPS location (`cpsPagedLocationBased`_)

Here is an example request for finding charging stations based on
a GPS location:

.. code-block:: javascript

    query cpsPagedLocationBased {
      cpsPagedLocationBased(
          location: {longitude: 12.12313, latitude: 13.12313, radius: 100.0}
        )
        {
          data {
            id
            label
            address
            city
            zip
            country
          }
        }
    }

.. _cp: https://graphql.docs.htb.services/api-reference/#query-cp
.. _cpsPaged: https://graphql.docs.htb.services/api-reference/#query-cpsPaged
.. _cpsPagedLocationBased: https://graphql.docs.htb.services/api-reference/#query-cpsPagedLocationBased