GPS Component ============= .. seo:: :description: Instructions for setting up GPS component in ESPHome. :image: crosshairs-gps.svg The ``gps`` component allows you to connect GPS modules to your ESPHome project. Any GPS module that uses the standardized NMEA communication protocol will work. .. figure:: images/gps-full.jpg :align: center :width: 50.0% GPS Module. Image by `Adafruit`_ .. _Adafruit: https://www.adafruit.com/product/746 For this component to work you need to have set up a :ref:`UART bus ` in your configuration - only the RX pin should be necessary. .. code-block:: yaml # Example configuration entry # Declare GPS module gps: latitude: name: "Latitude" longitude: name: "Longitude" altitude: name: "Altitude" # GPS as time source time: - platform: gps The component is split up in platforms, by defining the GPS module (as seen above). In addition to retrieving GPS position data, the module can also be used as a time platform to get the current date and time via the very accurate GPS clocks without a network connection. See :doc:`time/gps` for config options for the GPS time source. Configuration variables: ------------------------ - **latitude** (*Optional*): Include the Latitude as a sensor - All options from :ref:`Sensor `. - **longitude** (*Optional*): Include the Longitude as a sensor - All options from :ref:`Sensor `. - **speed** (*Optional*): Include the measured speed as a sensor - All options from :ref:`Sensor `. - **course** (*Optional*): Include the measured course as a sensor - All options from :ref:`Sensor `. - **altitude** (*Optional*): Include the measured altitude as a sensor - All options from :ref:`Sensor `. - **satellites** (*Optional*): Include the number of tracking satellites being used as a sensor - All options from :ref:`Sensor `. See Also -------- - :ref:`sensor-filters` - `TinyGPS++ library `__ - :apiref:`gps/gps.h` - :ghedit:`Edit`