OpenStreetMap

Qubes 10.0 Displays a map using OpenStreetMap or compatible services.

Properties

PropertyDescription
CenterCoordinates where the map should be centered.
EnabledBoolean indicating whether or not the component is enabled.
HintSpecifies the user hint string that will appear in the component's interactive help bubble.
MarkersList of geo-located markers to be overlayed.
ScaleDisplay of the map scale in metric, imperial or both units.
TilesURLSpecify the URL for an alternative or custom map tiles provider.
ValueInitialDetermines the component's initial value when the screen opens and each time it is reset (see Reset Button).
VisibleBoolean indicating whether or not the component will be visible.
ZoomLevel for the map (2 to 19).

Value

The component displays a map using OpenStreetMap service.

Remarks

This component requires Chrome/Edge 102 or higher.

The client browser must have Internet access when no custom TilesURL provider is specified. When Internet access is not desirable or possible, it is possible to self-host part of whole of the OpenStreetMap data, please refer to the OpenStreeMap documentation for further details.

The Center property can be either:

  • a list with at list two elements (decimal latitude and longitude)
  • string with decimal latitude and longitude separated by a comma

Geo-located markers can be overlayed on the maps with the Markers property, it is a list of strings:

  • each string is pipe-separated (|) and can contain latitude,longitude|title|pin_color_in_hex
  • 48.858353,2.294464 will place a marker on Eiffel tower, paris
  • 48.858353,2.294464|Eiffel Tower will give an "Eiffel tower" hint to the pin
  • 48.858353,2.294464|Eiffel Tower|#FF0000 will give it a red color

The TilesURL default value is https://{s}.tile.openstreetmap.org/{z}/{x}/{y}.png, typical uses for alternative URLs are to provide maps from within an intranet or to use alternative tile sets (localization, satellite imagery...). Many tile sets are available under various licensing and access options.

When Interactive is set to true, zoom, panning and dragging by the user are possible, and may interfere with property updates for Center and Zoom.

Classification

Cloud