Difference between revisions of "PUBLISHED MAPS"

From Anitra Support
Jump to: navigation, search
(Editing and settings)
 
(10 intermediate revisions by the same user not shown)
Line 3: Line 3:
 
= Overview =
 
= Overview =
  
: A tool tailored to configure simplified and secured public live telemetry maps from your full data sets.
+
: A tool tailored to configure simplified and secured live telemetry maps from your full data sets.
  
: Configured maps are then available in form of a link or in form of short HTML code which can be simply added to your web presentation or published on Facebook.
+
: Configured maps are available in form of a link or in form of short HTML code which can be simply added to your web presentation or published on Facebook.
  
: Map output can be created
+
: Map output can be created:
:* on top of single organization data or
+
:* on top of single organization data  
:* across a more complex ownership structure covered by "project"
+
:* on top of "project" (i.e. across more complex data ownership structure)
  
 
: Map editor with a live preview is used to configure the map<br>[[File:publish_map_configuration_groups.JPG|900px]]
 
: Map editor with a live preview is used to configure the map<br>[[File:publish_map_configuration_groups.JPG|900px]]
  
: Prepared maps are available in the form of
+
: Two map modes can be configured:
:* URL links for quick link sharing and opening the map in browser or e.g. posting it to your Facebook presentation
+
:* map showing the simplified '''Tracks'''
:* a short HTML code ready to be easily embedded into your WEB page or in particular formatted online articles
+
:* map showing the '''Last positions''' only
  
: Samples showing some of the map features
+
: For the mode of "Tracks" an '''Animation''' can be enabled
:* map with tracks and gallery: https://app.anitra.cz/share/map/5d2e379ed6f9c
 
:* map of last positions with categories: https://app.anitra.cz/share/map/5f1a97bb13ba5
 
  
: The functionality includes:
+
: The map configuration includes:
:* animal selection (i.e. input map filter)
+
:* animal selection
:* map name and description possibly in alternative language variants
+
:* language localisations (alternative language variants)
:* tracks vs. last position map modes
+
:* map mode (tracks vs. the last position), grouping options, ordering, data filtering (e.g. track simplified to one position a day)
:* icon/track styles including color setting and wide range of icons
 
:* grouping options, ordering, data filtering (e.g. track simplified to one position a day)
 
 
:* security features (security delay, zoom restriction, position "rounding")
 
:* security features (security delay, zoom restriction, position "rounding")
:* presentation and visualization tools (a default map selection, logos with links, foto gallery)
+
:* presentation and visualization presets (a default map selection, icon/track styles, choice of icons, logos with links, foto gallery, animation enabling)
  
 
= Creating and managing your public maps =
 
= Creating and managing your public maps =
  
:Public maps can be created with devices owned by the Customer/Organization or attached to a particular Project with a more complex ownership structure.
+
: Public maps can be created using telemetry data owned by the Customer/Organization or data attached to a particular Project with a more complex ownership structure.
:Because of this the map creation and managing functionality is accessible in two distinct places in Anitra  
+
: Because of this the map creation and managing functionality is accessible in two distinct places in Anitra  
:* in [[Main_Page#Organisation.2FCustomer_profile | Customer/Organization profile]]
+
:* in the [[Main_Page#Organisation.2FCustomer_profile | Customer/Organization profile]]
:* in Project/Group profile
+
:* in the Project/Group profile
  
Depending on the context the Customer or Project admins respectively can manage (create, edit, remove) particular Organization or Project maps
+
: Depending on the context the Customer or Project admins respectively can manage (create, edit, remove) particular Organization or Project maps
  
:In both locations, the list of existing published maps is shown with the following properties and options available
+
: In both locations, the list of existing published maps is shown with the following properties and options available
:* you can switch between existing language variants - note a different URL/HTML for each language and also a distinct link to map with language switching control
+
:* '''create''' new map using the "Add map" button
:* you can remove existing maps using the "REMOVE" button. Note that once removed any previously published map references will stop working ! Make sure you maintain control over where your links were previously used.
+
:* '''modify''' existing map using the "EDIT" button. <br>'' Note editing of the map definition, later on, does not affect the actual URL/HTML of it. Any changes that apply to the existing map definition are reflected into all the online instances right away.''
:* you can edit the existing map using the "EDIT" button. Note resaving the map definition does not affect the actual URL/HTML of it. Therefore any subsequent changes you do to the map definition are reflected into all the online instances right away.
+
:* '''remove''' existing map using the "DELETE" button. <br> ''Note that once removed any previously published map references will stop working! Make sure you maintain control over where your links were previously used.''<br>[[File:publish_map_projects_maplist.JPG|900px]]
:* use the CREATE button to create a map
 
  
<br>[[File:Chjgjvfi.JPG|900px]]
+
:The map list shows the '''URL links''' and '''HTML code''' strings ready to be used for map publication
 +
:* URL links: for quick link sharing and opening the map in the browser or e.g. posting it to your Facebook presentation
 +
:* HTML code: a code ready to be easily embedded into your WEB page or in particular formatted online articles
 +
: You can switch between existing language variants (if you defined those in map configuration - see below) and pick the URL variant which suits your publication best. Note the distinct URL/HTML while switching "LANGUAGE".
 +
:* URL for particular language variant (e.g. "Spanish"): to be used in language variant of your website (e.g. Spanish page)
 +
:* "CHOICE": a map with the language switching control in legend - the public map will show language switching control in legend (the flag symbol) <br>[[File:publish_map_languageSwitchingx.jpg|300px]]
  
=Editing and settings=
+
=Editing map definition=
  
: The map editing interface consists of left definition panel and map preview on the right side (any changes in structure done in the left are preview on the right).
+
: Map editing screen contains these main components:
 +
:* map filter (top left, red)
 +
:* map definition panel (left, yellow)
 +
:* interactive preview of the final map (right, green)<br>[[File:publish_map_layout.JPG|600px]]
  
: Note the changes you do on the left side are live previewed in the map on the right side to help you see the ongoing modifications. But be aware the changes are not saved automaticaly and you need to save the changes any time the map shows what you need - at least before leaving the map editor not to loose your work !
+
: In the map filter a selection of Animals can be done using a simplified [[Main_Page#FILTERS_.26_SEARCHES:_How_do_I_find_what_I_am_looking_for_.3F |filter functionality]]<br> [[File:publish_map_filter.jpg|600px]]
 +
: ''Note that any time you modify the filter the whole map definition is saved and preview reloaded''
  
[[File:publish_map_configuration_groups.JPG|900px]]
 
  
The map definitions conists of these steps or areas:
+
: The map definition itself covers these areas/steps:
  
* Name and Description
+
:* Name and Description  
 +
:** Name and Description are visible in the "map legend" (top left corner of the final map) <br> ''Note the "Name" from the default language also defines the map name (shown top left in map definition and used in the list of maps)''
 +
:** a basic text formatting available (italics, bold, underline, and link)
 +
:* Language options
 +
:** the language specified first is considered to be a "default"
 +
:** you can add and define more language versions of your map using the "Add language" button
 +
:** you can change the default language or remove the unneeded language version completely
 +
:** ''Note more alternative map links are generated (switching language in the list of maps) - also mentioned in the the map creation section above''<br> [[File:publish_map_nameDescr.jpg|600px]]
 +
:* '''Visibility settings''': this section defines the structure and the look of the final map.
 +
:** The "mode" setting represented by the "Tracks"/"Last positions" switch modifies available settings down in the section.
 +
:*** "Tracks" (mode) - a simplified track or animation of it is shown in the final map. the symbol for the last position is "flag" or "mortality cross" (when marked as dead)
 +
:*** "Last Positions" (mode) - only last positions are shown. the icons and colors can be flexibly defined.
 +
:** The "Group by" setting: adds an extra hierarchy structure to the data displayed
 +
:*** in the "Tracks" mode:
 +
:**** the basic/default "group by" and display detail is "Animal"<br>[[File:publish_map_modeTracks_Animal.jpg|700px]]
 +
:**** when the hierarchy is modified it only applies in the map legend grouping the Animals listed <br>'' Note while doing that the grouping attribute moves from Animal text string to grouping level (see the two next images)''<br>species level added:<br>[[File:publish_map_modeTracks_SpeciesAnimal.jpg|700px]]<br>animal level removed:<br>[[File:publish_map_modeTracks_Species.jpg|700px]]
 +
:**** more visibility settings applying at Animal (track) level available (line color, aliases displayed, order of the trackings)<br>[[File:publish_map_modeTracks_AliasBarvaOrder.jpg|700px]]
 +
:*** in the "Last Positions" mode:
 +
:**** the Group structure creates hierarchical categories and allows application of formating (icon and color) to those groups using formatting matrix
 +
:**** defined hierarchy applies everywhere - to map legend, to the map icons, and to format defining matrix in the left panel
 +
:**** formatting is applied in a top-down direction (icons and/or colors defined at parent level are inherited by the child nodes unless overridden by particular child node definition)<br>[[File:publish_map_modeLPs_IconsColors.jpg|900px]]<br>'' Note you can define the hierarchy structure of up to four levels from available attributes but the formating rules are only available for the two top levels (the matrix only shows the two top levels and all the lower hierarchy levels inherit definitions from parent nodes)''
 +
:** Remaining visibility setting allow to
 +
:*** show/hide counts for the grouped attributes in the map legend
 +
:*** enable/disable photo gallery
 +
:*** enable/disable animation running (for "Tracks" mode)
 +
:*** modify the Line width (for "Tracks" mode)<br>[[File:publish_map_modeTracks_CountGalleryAnimationLine.jpg|900px]]
 +
:* Security settings:
 +
:** Maximum zoom level
 +
:** GPS rounding (masking exact positions by rounding to X decimal places)
 +
:** Security delay (in days) - latest positions not shown before the delay defined
 +
:** Date range restriction<br>[[File:publish_map_Security.jpg|600px]]
 +
:* Other options:
 +
:** Logos
 +
:*** project-related logos can be uploaded, ordered, and then displayed in the "logos" areas in the bottom right corner of the final map,
 +
:*** organization`s link can be attached to the logo allowing click through to the organization's website is possible
 +
:** Base maps
 +
:*** a list of maps - those marked with the green check will be available in the final public map
 +
:*** a default background map (e.g. Google maps) can be marked using the star symbol. The marked map will be used by default when the map displayed by the viewer<br>[[File:publish_map_LogosMaps.jpg|600px]]
  
** Both including basic formatting (italics, bold, underline, and link)
+
: Some more general remarks:
** Language options (the final iframe will show a button with a flag for the possibility of language switching)
+
:* while modifying the definition the preview map is refreshed automatically with a small delay.
* Selection of titles to the legend (Tracking based settings)
+
:* Note despite map preview getting automatically updated most of the modifications are not saved till you press the "Save" button (in the top right corner). Make sure you save your changes before closing the map definition (not to lose your changes)!
** You can select whether to use “TO name” and/or “TO code”
 
** It is possible to define a color for each TO
 
:[[File:Con.JPG|900px]]
 
* Security settings
 
** GPS rounding level
 
** Maximum zoom
 
** Option to enable/disable photo gallery
 
* Logos
 
** Possibility of uploading logos, including a click through to the organization's website
 
* On the screen "Edit"
 
** Adjusting settings on the left
 
** On the right, a preview of the final iframe form is displayed dynamically
 
** All changes can then be saved by clicking on the button "Save changes"
 
:[[File:Cog_.JPG|900px]]
 
  
=Other functions of the final iframe=
+
=Other=
* Fullscreen
+
: Functionality of the final published map
* Option to turn on / off only selected trackings in the legend
+
:* the fullscreen mode
** The selection in the legend also filters the enabled photo gallery
+
:* selecting/unselecting particular animals or groups in the map legend  
** Browser remembers your tracking selection  
+
:** ''note the selection in the map legend also filters the animals in the photo gallery (only photos of checked animals are displayed)''
* The legend also shows species, age, and gender
+
:** ''also note internet browser will remember the user's selection till next time''
* The legend shows the icon for the death of an individual (if the date of death is filled) and after the mouse movement, the reason for the death (from the field "Mortality reason" - if it is filled in)
+
:* Animation control displayed on mouseover when animation enabled in the map definition
 +
:** "play" button: plays and pauses the animation. also "space" plays and pauses
 +
:** "speed control": a default speed set to 2 days a second
 +
:** "stop" button terminates the animation playback and resumes to regular "tracks" view<br>[[File:publish_map_animationControl.jpg|600px]]
 +
 
 +
: Sample published maps - these sample maps are showing some of the features
 +
:* map with tracks and gallery: https://app.anitra.cz/share/map/5d2e379ed6f9c
 +
:* map of the last positions with categories: https://app.anitra.cz/share/map/5f1a97bb13ba5

Latest revision as of 21:02, 23 February 2022


Overview

A tool tailored to configure simplified and secured live telemetry maps from your full data sets.
Configured maps are available in form of a link or in form of short HTML code which can be simply added to your web presentation or published on Facebook.
Map output can be created:
  • on top of single organization data
  • on top of "project" (i.e. across more complex data ownership structure)
Map editor with a live preview is used to configure the map
Publish map configuration groups.JPG
Two map modes can be configured:
  • map showing the simplified Tracks
  • map showing the Last positions only
For the mode of "Tracks" an Animation can be enabled
The map configuration includes:
  • animal selection
  • language localisations (alternative language variants)
  • map mode (tracks vs. the last position), grouping options, ordering, data filtering (e.g. track simplified to one position a day)
  • security features (security delay, zoom restriction, position "rounding")
  • presentation and visualization presets (a default map selection, icon/track styles, choice of icons, logos with links, foto gallery, animation enabling)

Creating and managing your public maps

Public maps can be created using telemetry data owned by the Customer/Organization or data attached to a particular Project with a more complex ownership structure.
Because of this the map creation and managing functionality is accessible in two distinct places in Anitra
Depending on the context the Customer or Project admins respectively can manage (create, edit, remove) particular Organization or Project maps
In both locations, the list of existing published maps is shown with the following properties and options available
  • create new map using the "Add map" button
  • modify existing map using the "EDIT" button.
    Note editing of the map definition, later on, does not affect the actual URL/HTML of it. Any changes that apply to the existing map definition are reflected into all the online instances right away.
  • remove existing map using the "DELETE" button.
    Note that once removed any previously published map references will stop working! Make sure you maintain control over where your links were previously used.
    Publish map projects maplist.JPG
The map list shows the URL links and HTML code strings ready to be used for map publication
  • URL links: for quick link sharing and opening the map in the browser or e.g. posting it to your Facebook presentation
  • HTML code: a code ready to be easily embedded into your WEB page or in particular formatted online articles
You can switch between existing language variants (if you defined those in map configuration - see below) and pick the URL variant which suits your publication best. Note the distinct URL/HTML while switching "LANGUAGE".
  • URL for particular language variant (e.g. "Spanish"): to be used in language variant of your website (e.g. Spanish page)
  • "CHOICE": a map with the language switching control in legend - the public map will show language switching control in legend (the flag symbol)
    Publish map languageSwitchingx.jpg

Editing map definition

Map editing screen contains these main components:
  • map filter (top left, red)
  • map definition panel (left, yellow)
  • interactive preview of the final map (right, green)
    Publish map layout.JPG
In the map filter a selection of Animals can be done using a simplified filter functionality
Publish map filter.jpg
Note that any time you modify the filter the whole map definition is saved and preview reloaded


The map definition itself covers these areas/steps:
  • Name and Description
    • Name and Description are visible in the "map legend" (top left corner of the final map)
      Note the "Name" from the default language also defines the map name (shown top left in map definition and used in the list of maps)
    • a basic text formatting available (italics, bold, underline, and link)
  • Language options
    • the language specified first is considered to be a "default"
    • you can add and define more language versions of your map using the "Add language" button
    • you can change the default language or remove the unneeded language version completely
    • Note more alternative map links are generated (switching language in the list of maps) - also mentioned in the the map creation section above
      Publish map nameDescr.jpg
  • Visibility settings: this section defines the structure and the look of the final map.
    • The "mode" setting represented by the "Tracks"/"Last positions" switch modifies available settings down in the section.
      • "Tracks" (mode) - a simplified track or animation of it is shown in the final map. the symbol for the last position is "flag" or "mortality cross" (when marked as dead)
      • "Last Positions" (mode) - only last positions are shown. the icons and colors can be flexibly defined.
    • The "Group by" setting: adds an extra hierarchy structure to the data displayed
      • in the "Tracks" mode:
        • the basic/default "group by" and display detail is "Animal"
          Publish map modeTracks Animal.jpg
        • when the hierarchy is modified it only applies in the map legend grouping the Animals listed
          Note while doing that the grouping attribute moves from Animal text string to grouping level (see the two next images)
          species level added:
          Publish map modeTracks SpeciesAnimal.jpg
          animal level removed:
          Publish map modeTracks Species.jpg
        • more visibility settings applying at Animal (track) level available (line color, aliases displayed, order of the trackings)
          Publish map modeTracks AliasBarvaOrder.jpg
      • in the "Last Positions" mode:
        • the Group structure creates hierarchical categories and allows application of formating (icon and color) to those groups using formatting matrix
        • defined hierarchy applies everywhere - to map legend, to the map icons, and to format defining matrix in the left panel
        • formatting is applied in a top-down direction (icons and/or colors defined at parent level are inherited by the child nodes unless overridden by particular child node definition)
          Publish map modeLPs IconsColors.jpg
          Note you can define the hierarchy structure of up to four levels from available attributes but the formating rules are only available for the two top levels (the matrix only shows the two top levels and all the lower hierarchy levels inherit definitions from parent nodes)
    • Remaining visibility setting allow to
      • show/hide counts for the grouped attributes in the map legend
      • enable/disable photo gallery
      • enable/disable animation running (for "Tracks" mode)
      • modify the Line width (for "Tracks" mode)
        Publish map modeTracks CountGalleryAnimationLine.jpg
  • Security settings:
    • Maximum zoom level
    • GPS rounding (masking exact positions by rounding to X decimal places)
    • Security delay (in days) - latest positions not shown before the delay defined
    • Date range restriction
      Publish map Security.jpg
  • Other options:
    • Logos
      • project-related logos can be uploaded, ordered, and then displayed in the "logos" areas in the bottom right corner of the final map,
      • organization`s link can be attached to the logo allowing click through to the organization's website is possible
    • Base maps
      • a list of maps - those marked with the green check will be available in the final public map
      • a default background map (e.g. Google maps) can be marked using the star symbol. The marked map will be used by default when the map displayed by the viewer
        Publish map LogosMaps.jpg
Some more general remarks:
  • while modifying the definition the preview map is refreshed automatically with a small delay.
  • Note despite map preview getting automatically updated most of the modifications are not saved till you press the "Save" button (in the top right corner). Make sure you save your changes before closing the map definition (not to lose your changes)!

Other

Functionality of the final published map
  • the fullscreen mode
  • selecting/unselecting particular animals or groups in the map legend
    • note the selection in the map legend also filters the animals in the photo gallery (only photos of checked animals are displayed)
    • also note internet browser will remember the user's selection till next time
  • Animation control displayed on mouseover when animation enabled in the map definition
    • "play" button: plays and pauses the animation. also "space" plays and pauses
    • "speed control": a default speed set to 2 days a second
    • "stop" button terminates the animation playback and resumes to regular "tracks" view
      Publish map animationControl.jpg
Sample published maps - these sample maps are showing some of the features