GPS Component¶
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.
![../_images/gps-full.jpg](../_images/gps-full.jpg)
For this component to work you need to have set up a UART bus in your configuration - only the RX pin should be necessary.
# 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 GPS Time Source for config options for the GPS time source.
Configuration variables:¶
latitude (Optional): Include the Latitude as a sensor
All options from Sensor.
longitude (Optional): Include the Longitude as a sensor
All options from Sensor.
speed (Optional): Include the measured speed as a sensor
All options from Sensor.
course (Optional): Include the measured course as a sensor
All options from Sensor.
altitude (Optional): Include the measured altitude as a sensor
All options from Sensor.
satellites (Optional): Include the number of tracking satellites being used as a sensor
All options from Sensor.