GeoViewHelp

From Gramps
Jump to: navigation, search
Gnome-important.png
The Geography addon GeoView based on OsmGpsMap has been integrated into Gramps 3.3, see the user manual for further information

Gramps_5.2_Wiki_Manual_-_Categories#Geography_Category

Geography

To have these views plot a map pin for an Event correctly, the view needs to be told where to place the pin. This means each of those Events need to be related to a Place. Moreover, these Places must have coordinates data stored for latitude and longitude.

If a Place has no coordinates defined, no event in that Place will ever be seen on the map. If an Event has no Place defined, that Event will be omitted from the map

There are different ways to add coordinates to places :

  1. Within the Geography View's contextual menu popup, you can link or add one place.
  2. numeric coordinates may be keyed in directly using the Place Editor in one of the supported formats
  3. individual place coordinates can be added using an addon that harmonizes a Gramps Place with one of the GIS standards.

While you have an active internet connection, for all moves on the map, at each zoom scale ... the map service tiles displayed under the pins in the Geography view will be saved in caching folders. Cached tiles are re-used rather than repeatedly requesting the same map service data.

When you are without internet, all tiles cached in a previous session can be used. So, the map can be used without internet. If a tile has not been cached at that zoom scale, the cached tile at the closest wider zoom scale will be stretched to fit.

For each place or region that you want to view later while offline, zoom into these places. You'll be able to use those tiles again without connection.

Gnome-important.png
Be aware of the storage requirements

Caching tiles can consume gigabytes of storage. If you use several maps, this same gigabytes of usage will be multiplied by the number of map services used.

The different views

All known places for one person

The person

This view show all places visited by one person during his life.

This view is not connected to filters. It only depend on the active person and the history.

If you want to use the animate functionality, click on the right button of the mouse. You'll get a popup menu. In this menu popup, you can select 'animate' to see the life way of the current person :

If the active person has several related events, you can see a virtual move between those markers. The move is related to years or distance and can be modified in the person map preferences. If the distance between to markers is greater than a value in tenth of degree, we show moves depending on distance instead of years. In these case, the number of steps between these two markers can be modified. You can modify the animation speed between steps. The moves start at the first event year until the last event year.

In the configuration menu, you can set the following :

  1. The animation speed in milliseconds.
  2. How many steps betwwen two markers for long moves.
  3. The minimum latitude/longitude to select large move. This value is in tenth of degree.
The animation

All known places for one family

The family

This view show all places visited by all family's members during their life.

This view is not connected to filters. It only depend on the active family and the history.

You have no extra option in the configuration menu.

Have they been able to meet ? ( from 4.0 )

Persons meeting?

This view is used to show if two persons were able to meet during their life.

You must select one reference person :

  1. In the menu popup : Choose the reference person
  2. In the toolbar

When the reference person is active, you'll see its life way. For each known place with coordinates, you'll see a circle or an ovale depending on the longitude.

The circle radius can be tuned in the configuration view. This value is defined in tenth of degree.

The selection

Have these two families been able to meet ? ( from 4.0 )

Families meeting?

This view is used to show if two families were able to meet during their life.

You must select one reference family :

  1. In the menu popup : Choose the reference family
  2. In the toolbar

When the reference family is active, you'll see all its members's life way. For each known place with coordinates, you'll see a circle or an ovale depending on the longitude.

The circle radius can be tuned in the configuration view. This value is defined in tenth of degree.

The selection

All displacements for one person and their descendants ( from 4.0 )

Moves

This view is used to show all descendant's life ways.

There are displayed by generation. You can change the delay between the generation display in the view configuration.

This view is not connected to filters. It only depend on the active person and the history.

In the configuration menu, you can :

  1. Set the maximum generation to show
  2. Set the time in milliseconds between two generation drawing.
Parameters for moves

All places related to events

Events

This view is used to show all places related to events. It can take some time to show when we have many events.

You have no extra option in the configuration menu.

All known places

Places

This view show all places with coordinates in the database.

You have no extra option in the configuration menu.

Usage

The configuration

All views

The map
  1. Where to save the tiles of the map. Be careful, it can take several gigabytes.
  2. The zoom level when we center the map

Specific views

See the description of the view.

The mouse actions on the map

The right button below is for one right handed person. This will be the left button for one left handed person.

button 1 ( left button )

You have two usages for the button 1 :

  1. The marker selection.
  2. Valid the region selection

button 2 ( middle button )

The only usage for this button is to select an area on the map.

  1. when pressed : start the region selection
  2. when released, end the region selection.

You must use the button 1 to validate the selected region when finished.

button 3 ( right button )

Only one usage for this button.

  1. show the menu popup.

The mouse over a marker

When the mouse is placed over one marker, we display the place name in the status bar.

The menu popup

From this menu, you have the following functions available for views :

  1. hide or show the crosshair
  2. lock the zoom : force to no center and no autozoom. Useful when we want to see a selected area of the map.
  3. change the default map
  4. add a place and link a place at the mouse position
  5. center the map at the mouse position.
  6. change the map provider
  7. add place from kml
  8. show all events or places for the "show all places" and "all events related to places" views.
  9. clear the tile cache

Click on a marker

We have two cases :

  1. events : For each event, we can edit this event or center the map on this place.
  2. places : For each place, we can edit this place or center the map on this place.

When centering the map, the zoom used is defined in the geography preferences.

We may have several markers in the click area depending on the zoom. In this case, We show for each marker all related events and/or places. We obtain a mix between the two cases described above.

Adding or Linking to a place

For this, click on the right button of the mouse, you'll get a popup menu. In this menu, you can select Add place or Link place

When you add a place or try to link a place to the position of the mouse, you'll get a place selection in a region. You'll see on the map a circle in which you may choose markers place names. You can adjust the circle size with the cursor. Depending on the diameter of this circle, a list is created. If the place has already some filled fields, you'll see these values in a green color row. If you agree, you double click on this row. if you don't agree, you can choose another row.

How to change the map provider ?

We have several available providers in gramps. Click on the right button of the mouse, you'll get a popup menu. In the bottom of this menu, you can select a new provider. The following providers are avalible :

  1. OpenStreetMap
  2. Maps For Free
  3. OpenCycleMap
  4. Public Transport
  5. Google street
  6. Google sat
  7. Google hybrid
  8. Virtualearth street
  9. Virtualearth sat
  10. Virtualearth hybrid

Can we change the marker's color ?

We can't do that. The marker's colors are hard coded in gramps. The colors are green for the following renderers : openstreetmap, Maps for free, Opencyclemap and Public transport. All others are red.

How to get/remove the crosshair ?

It can be useful to have the crosshair visible to see the center of the map. This functionality is available with the right button of the mouse. you'll get a popup menu. Select Add or Remove cross hair.

How to lock/unlock the map ?

When we change the map ( person to family, ... ), the zoom is recalculated. It can be useful in some case to keep the same zoom when we change the map. For this, click on the right button of the mouse, you'll get a popup menu. In this menu, you can select lock or unlock zoom and position.

Gramps Integration

If you need more information on geography integration in gramps. GEPS 025: Geography

See also

"Map your family tree with Gramps and QGIS – how to digitize and visualize genealogy", a we article by Jakob on Digital-Geography.com

  Copyrighted This screenshot either does not contain parts or visuals of copyrighted programs, or the author(s) of those programs has released it under a free software license (which should be indicated beneath this notice). You may use it freely according to its particular license.
Free Software license: GPL

All images on this page are free screenshots

GeoView