.. _exploring-maps:
.. _asemap-switcher:

Map tools and configuration
================================

In this section, we are going to explore all tools provided on the Map View page. From the list of available maps, you can select the map you are interested in and click *View map*, the map will look like this.

.. figure:: img/explore_map_viewer.png
     :align: center

     *The Map View*

The Map View (based on `MapStore <https://mapstore2.geo-solutions.it/mapstore/#/>`_) provides the following tools:

* the :ref:`toc` to manage the map contents;
* the *Basemap Switcher* to change the basemap (see the next paragraphs);
* the *Search Bar* to search by location, name and coordinates (see the paragraph below);
* the :ref:`options-menu-tools` which contains the link to the datasets *Catalog*;
* the *Sidebar* which contains, by default, the link to the *Print* tool and to the *Measure* tool;
* the *Navigation Bar* and its tools such as the *Zoom* tools, the *3D Navigation* tool and the *Get Features Info* tool;
* the *Footer Tools* to manage the scale of the map, to track the mouse coordinates and change the CRS (Coordinates Reference System).

A map can be configured to use a custom :ref:`map-viewers`, with which the lsit of tools available in the map can be customized.

.. toctree::
    :hidden:
    :maxdepth: 1

    map_viewers
    toc
    attribute_table
    creating_widgets
    timeline
    options_menu
    get_fetureinfo
    

Search Bar
----------

| The *Search Bar* of the map viewer allows you to find point of interests (POIs), streets or locations by name.
| Lets type the name of some place then select the first record.

.. figure:: img/search_bar_typing_name.png
     :align: center

     *The Search Bar*

The map will automatically re-center on that area delimiting it by a polygon in the case of an area, by a line in the case of a linear shape (e.g. streets, streams) and by a marker in the case of a point.

.. figure:: img/search_bar_result.png
     :align: center

     *Result of a Search*

.. _sidebar:

Navigation bar
-------------

.. |sidebar_expand_button| image:: img/sidebar_expand_button.png
    :width: 30px
    :height: 30px
    :align: middle

.. |zoom_in_button| image:: img/zoom_in_button.png
    :width: 30px
    :height: 30px
    :align: middle

.. |zoom_out_button| image:: img/zoom_out_button.png
    :width: 30px
    :height: 30px
    :align: middle

.. |3d_button| image:: img/3d_button.png
    :width: 30px
    :height: 30px
    :align: middle

.. |query_objects_on_map_button| image:: img/query_objects_on_map_button.png
    :width: 30px
    :height: 30px
    :align: middle

.. |zoom_to_max_extent_button| image:: img/zoom_to_max_extent_button.png
    :width: 30px
    :height: 30px
    :align: middle

.. |go_back_button| image:: img/go_back_button.png
    :width: 30px
    :height: 30px
    :align: middle

.. |go_forward_button| image:: img/go_forward_button.png
    :width: 30px
    :height: 30px
    :align: middle

.. |full_screen_button| image:: img/full_screen_button.png
    :width: 30px
    :height: 30px
    :align: middle

.. |show_hide_coordinates_button| image:: img/show_hide_coordinates_button.png
    :width: 30px
    :height: 30px
    :align: middle

| The *Map Viewer* makes also available the *Navigation bar*.
  It is a navigation panel containing various tools that help you to explore the map such as tools for zooming, changing the extent and querying objects on the map.
| By default the *Navigation bar* shows you the zooming buttons |zoom_in_button|, |zoom_out_button| and |3d_button|, other options can be explored by clicking on |sidebar_expand_button| which expands/collapses the toolbar.|

.. figure:: img/collapsed_sidebar.png
     :align: center
     :width: 300px

     *The Default Navigation bar*

.. figure:: img/expanded_sidebar.png
    :align: center
    :width: 300px

    *The Expanded Navigation bar*

The *Navigation bar* contains the following tools:

* The *Query Objects on map* allows you to get feature information through the |query_objects_on_map_button| button.
  It allows you to retrieve information about the features of some datasets by clicking them directly on the map.

  .. figure:: img/querying_objects_on_map.png
      :align: center

      *Querying Objects on map*

  When clicking on map a new panel opens. That panel will show you all the information about the clicked features for each active loaded dataset.

* You can *Zoom To Max Extent* by clicking |zoom_to_max_extent_button|.


Basemap Switcher
----------------

By default, GeoNode allows to enrich maps with many world backgrounds. You can open available backgrounds by clicking on the map tile below:

* *OpenStreetMap*
* *OpenTopoMap*
* *Sentinel-2-cloudless*

.. figure:: img/basemap_switcher.png
     :align: center
     :height: 400px

     *The Basemap Switcher Tool*

You can also decide to have an *Empty Background*.

.. figure:: img/basemap_switching.png
    :align: center
    :height: 400px

    *Switching the Basemap*

Footer Tools
------------

At the bottom of the map, the *Footer* shows you the *Scale* of the map and allows you to change it.

.. figure:: img/map_scaling.png
    :align: center
    :height: 600px

    *The Map Scale*

The |show_hide_coordinates_button| button allows you to see the pointer *Coordinates* and to change the Coordinates Reference System (CRS), WGS 84 by default.

.. figure:: img/map_coordinates.png
    :align: center

    *The Pointer Coordinates and the CRS*