MapWidget

class pyqtgraph_gis.MapWidget(
    tile_server_url: str,
    headers: str | None = None,
    parent: QtCore.QObject | None = None,
    attribution_text: str | None = None,
    **kwargs
)

Extends from pyqtgraph.PlotWidget.

PlotWidget that loads map tiles from a given Tile Provider into the background of the plot area.

Parameters

• tile_server_url (str): URL of the Tile Provider API.
• headers (str or None, default None): Headers for the API Request.
• parent (QtCore.QObject or None, default None): Parent QObject for the Widget.
• attribution_text (str or None, default None): Attribution Text shown in the bottom right corner of the map area, for attributions to the tile or data providers.

Signals

• sigMapClicked (Signal): Signal that is emitted when the map is clicked. Emits the latitude and longitude of the clicked point.
• sigMouseMoved (Signal): Signal that is emitted when the mouse is moved over the map. Emits the latitude and lomgitude of the mouse position.

plot(lats: list, lons: list, *args, **kwargs)

Plots sets of WGS84 latitudes and longitudes to the map as a line. Returns a pyqtgraph.PlotItem object.

Parameters

• lats (list): List of latitudes to plot.
• lons (list): List of longitudes to plot.

scatter(lats: list, lons: list, **kwargs)

Plots sets of WGS84 latitudes and longitudes to the map as points. Returns a pyqtgraph.ScatterPlotItem object.

Parameters

• lats (list): List of latitudes to plot.
• lons (list): List of longitudes to plot.

image(image_data: numpy.ndarray, min_lat: float, min_lon: float, max_lat: float, max_lon: float, **kwargs)

Plot an image to the map. Takes the image data as a numpy.ndarray and bounding box coordinates and returns a pyqtgraph.ImageItem object.

Parameters

• image_data (numpy.ndarray): Image as a numpy.ndarray.
• min_lat (float): Bounding Box lower WGS84 latitude.
• min_lon (float): Bounding Box lower WGS84 longitude.
• max_lat (float): Bounding Box higher WGS84 latitude.
• max_lon (float): Bounding Box higher WGS84 longitude.