Changes

Jump to: navigation, search

GeoView

2,812 bytes added, 02:02, 8 July 2021
no edit summary
Work in progress{{man warn|The GeoView addon was originally integrated into earlier Gramps versions than Gramps 3.3 then I created a new map renderer since some month now. go there : [[GeoViewHelp]]|The newer [[Geography]] renderer based on OsmGpsMap was integrated into Gramps 3.3, see the [[User_manual|user manual]] for further information <br>[[Gramps_{{man version}}_Wiki_Manual_-_Categories#Geography_Category]]}}
{{man warn|Instructions for the older GeoView addon that was based on webkit/gtkmozembed}} '''All we need to understand and test GeoView.'''
== Why GeoView ? ==
I would like to see my ancestors all around the world on a map. And if possible, I would like to see them moving during time periods.
== Installation The future ==
How to do this easily and with For approximatively three years, geoview is based on html technology using webkit or gtkmozembed.We have some problems depending on the minimum of software to install ?distribution, the webkit version, ... : crashes, messages on console, ...
GeoView The mecanism for rendering the map is one solution. In GRAMPS 3.1.x it is present as an experimental view you can activate. For GeoView to work you need asynchronous and difficult tomanage :# change the GRAMPS configuration file to list the view in the list of views# install the required backend so you can see webpages inside of GRAMPS.# set the GeoView Preferences# use the appropriate latidude renderer and longitude format in your data (Note: the [[Place completion tool]] can look up latitude and longitude of the places defined in GRAMPSgramps are two different things which don't easily communicate.)
The first is simple to achieve. Start So, I am working on a text editor and go to your gramps home directory, and open the keys.ini file. Scoll down to the interface section, and look for the ''data-views'' variablenew map renderer since some month now. On a clean install of GRAMPS, this variable is normally: data-views=GrampletView,PersonView,RelationshipView,FamilyListView,PedigreeView,EventView,SourceView,PlaceView,MediaView,RepositoryView,NoteViewTo add GeoView, just add it to the back, so your configuration reads: data-views=GrampletView,PersonView,RelationshipView,FamilyListView,PedigreeView,EventView,SourceView,PlaceView,MediaView,RepositoryView,NoteView,GeoView
That's it. If you are impatient, go there : [[Geography]]
To ==GeoView is divided in two parts : ==This module is now in two parts in 3.2. I'll try to explain how to install the backend, scroll down them and how to [[GeoView#How_to_get_the_HTML_kits_use them. You have two new views named Geography (geoviev) and Web (htmlrenderer).=== The html rendering engine ===This module is called htmlrenderer.3F|We use it when we use the installation section]]Web view.
Finally, you How to do this easily and with the minimum of software to install ?==== The html kits ====The Html rendering machine is used to show remote and local "urls" inside of GRAMPS. We need to set be connected to the Geoview Preferences:network. You probably also need a broadband connection to have a smooth result. Try eg Google maps in your browser to see if your internet connection is sufficiently fast.
[[Image:GeoViewPreferences.png]]. == The html kits ==The Geoview shows internet map services inside of GRAMPS with your genealogical data marked. Although there is no visual web browsing, that is what GRAMPS is actually doing, so we need to be connected to the network. You probably also need a broadband connection to have a smooth result. Try eg Google maps in your browser to see if your internet connection is sufficiently fast. GRAMPS can use two different kind of engines, webkit or gtkmozembed, to view HTML pages. If they are not installed, you'll never see GeoView [[Geography]] and the Web appearing among your views. If you are looking on how to install these, see [[GeoView#How_to_get_the_HTML_kits_.3F| below]]
If both two kits are installed, webkit will be used.
 Even if you have a HTML kit installed, you can always say : I don't mind ! I don't want to see the GeoView.For this, you can disallow Geoview in the Internet Maps preferences tab. ===== WebKit =====
Be aware, WebKit is always in development.
*http://blogs.gnome.org/epiphany/2008/04/01/the-future-of-epiphany/
==== Proxies ====WebKit uses the libsoup library. You need to set for the environment variable http_proxyproxy===== Gecko ( GtkMozEmbed ) =====
What will gtkmozembed be in the future ?
The embedding API of Gecko (GtkMozEmbed) has been unmaintained and stagnant for a long time.
==== Proxies ====GtkMozEmbed is proxy aware. I implement implemented this and I use the http_proxy environment variable.
Authentication is allowed. The http_proxy format used is :
''http://[user:password@]proxy:port/''==== The proxies ====Most people don't need a proxy. The majority of us are connected directly to internet. In this case, forget all this. You need a proxy only if you installed one or if you depend on some internet providers. You need to set the environment variable http_proxy or use your desktop proxy configuration. ==== How to get the HTML kits ? ====It depends on the distribution you're working on ! They are listed in reverse order. python-webkitgtk is also called pywebkitgtk in some distributions. ===== debian =========== webkit ====== ''aptitude install python-webkit''====== gecko ====== ''aptitude install python-gnome2-extras'' or ''aptitude install python-gtkmozembed'' ===== fedora =========== webkit ======You must use : WebKit-gtk  ''yum install WebKit-gtk pywebkitgtk'' ====== gecko ====== ===== MAC/OS X =========== webkit ======WebKit is the standard renderer on OSX, but WebKitGtk doesn't work with the installed WebKit framework. You must build WebKitGtk or obtain it via Fink or MacPorts. Gtk-OSX provides a patch for building WebKitGtk with quartz. Once WebKitGtk is built or installed, PyWebKitGtk installs and works well.====== gecko ======
To confirm ===== mandriva =========== webkit ======for 2009.0 and 2009.1: You need to use gnomeUse the package manager and install python-controlwebkitgtk or : ''urpmi python-center webkitgtk''====== gecko ======Seems not to set the proxywork. Causes segmentation fault.
== Supported longitude/latitude formats === suse =========== webkit ======When you create/modify a place, the possible formats used for longitude/latitude are :* libwebkit-1_0
I didn'D.D4' : degree notation, 4 decimals eg +12.0154 , -124.3647 'D.D8' : degree notation, 8 decimals (precision like ISO-DMS) eg +12.01543265 , -124.36473268 'DEG' : degree, minutes, seconds notation eg 50°52'21.92"N , 124°52'21.92"E ° has UTF-8 code c2b00a or N 50º52'21.92" , E 124º52'21.92" º has UTF-8 code c2ba0a The character for seconds can be either one double quote " t test GeoView on suse or two single quote ' 'DEG-:' : degree, minutes, seconds notation with : eg -50:52:21.92 , 124:52:21.92 'ISO-D' : ISO 6709 degree notation i.e. ±DD.DDDD±DDD.DDDD 'ISO-DM' : ISO 6709 degree, minutes notation i.e. ±DDMM.MMM±DDDMM.MMM 'ISO-DMS' : ISO 6709 degree, minutes, seconds notation i.e. ±DDMMSSopensuse.SS±DDDMMSSI need some feedback.SS
I found on example in : ftp5.gwdg.de/pub/opensuse/repositories/home:/bmotmans/openSUSE_<VERSION>/<ARCH>/ Replace <VERSION> by the fedora version you use. ie : Factory, 10.3, 1.0, ... Replace <ARCH> by i586, x86_64, ... * pywebkit http://packages.opensuse-community.org/index.jsp?searchTerm=pywebkit * pyton-webkit On OpenSUSE 11.3 that is the appropriate name. ====== gecko ====== ===== ubuntu === The maps providers ==There are a lot of providers. Some are free.====== webkit ======  ''aptitude install python-webkit''
By default====== gecko ======If you want gtkmozembed on ubuntu, the provider GRAMPS uses is OSM ( OpenStreetMap ). As a free project, we find it our duty to first and foremost support another free initiativeyou must install : python-gnome2-extras or python-gtkmozembed depending on you distrib version.
OpenStreetMap depends on the community and the maps are very light depending on the country. Nevertheless, the community made an extraordinary job and the quality is improving rapidly. And you can [http://openstreetbugs.appspot.com/ help make it better]! We can say OpenStreetMap is and will be the map GRAMPS uses per default. ''aptitude install python-gnome2-extras'' or ''aptitude install python-gtkmozembed''
Openlayers is free too and uses by default OSM map. A lot of private or non free maps depends on OpenLayers.===== windows XP/Vista =========== webkit ======
The most interesting * WebKitGTK is the IGN port of the portable web rendering engine WebKit to the GTK+ platform on Windows. This zip file contains webkitgtk itself and all needed dynamic link libraryes ( Institut Géographique National Français DLL). You will need [http://www.7-zip.org 7zip] to extract its contents ''This file is highly experimental and all functions may not work as expected!''** [http://www.geoportailgramps-project.frorg/wiki/images/d/d2/visu2DWebKitGTK-1.1.16.zip WebKitGTK-1.do?cg=djoxLjEqYzptZXRyb3BvbGUqY3Y6MS4wKnZ2OjEuMSp4eToyLjM0NTI3NDM5ODQwMTE4ODN8NDguODYwODMyNTU3MTczODgqczoxMCpwdjoxLjAqcDpkZWNvdXZlcnRlKmw6UGhvdG98fHwsU2NhbnwxfDEwMHwsQ2Fzc2luaXwxfHw%3D] which offers an old map of France ( about 1780 ) but this provider needs a key1. I'll speak about keys later16.zip]
Then yo haave Googlemaps, Yahoo! maps, Microsoft maps, * Update to version 1.1.23 (binary and devel files only)** [http://www.gramps-project.org/wiki/images/d/db/WebKitGTK-1.1.23-win32.zip WebKitGTK-1.1.23]
== mapstraction ==* [http://code.google.com/p/pywebkitgtk PyWebKitGtk] provide Python bindings to WebKitGTKLike you can see, it's impossible to implement all providers maps** [http://www.gramps-project.org/wiki/images/4/4d/PyWebKitGTK-1.1.7.win32-py2.6.zip PyWebKitGTK-1.1.7.win32-py2. For this reason, some people created an api over all these providers api6.msi]
With only a few modification, you can use the map you want[[All In One Gramps Software Bundle for Windows|Gramps AIO package]] contains WebKitGTK-1. And better! you can switch between the maps keeping the zoom 2.5 and the centered positionPyWebKitGTK-1.1.8
===== ... =====Your distributions are welcomed ...=== The Geographic part ===This module is called geoview. It's also depends on the htmlrenderer module.===== In GRAMPS 3.1.x =====If you really are in 3.1.2 and greater, you only have the development phase and geoview module. The htmlrenderer is sometimes buggyincluded in geoview.For installing the html renderer, you can see the documentation above.
It is present as an experimental view you can activate. For performances issues, I can confirm it takes approximately 30 seconds GeoView to work you need to:# change the GRAMPS configuration file to list the view 1000 markers for openstreetmap or googlein the list of views# install the required backend so you can see webpages inside of GRAMPS.If you have 2000 markers, this time is about 2 times 30 seconds# set the GeoView Preferences# use the appropriate latidude and longitude format in your data (Note: the [[Place completion tool]] can look up latitude and longitude of the places defined in GRAMPS.)
For thisThe first is simple to achieve. Start a text editor and go to your gramps home directory, I limit one HTML page and open the keys.ini file. Scoll down to 200 markersthe interface section, and look for the ''data-views'' variable. If you have more than On a clean install of GRAMPS, this limitvariable is normally: data-views=GrampletView,PersonView,RelationshipView,FamilyListView, GRAMPS creates PedigreeView,EventView,SourceView,PlaceView,MediaView,RepositoryView,NoteViewTo add GeoView, just add it to the necessary pages to see all back, so your markers.configuration reads: data-views=GrampletView,PersonView,RelationshipView,FamilyListView,PedigreeView,EventView,SourceView,PlaceView,MediaView,RepositoryView,NoteView,GeoView
During testing with a places database for France ( > 35000 markers ), I set the limit to 20 markers which permit to create 1760 pages without problems. So we can say we have an unlimited number of markers. Only the file system space will limit usThat's it.
== The provider Key ==GRAMPS is not a web site. Keys are mostly only for web sitesTo install the backend, scroll down to [[GeoView#How_to_get_the_HTML_kits_.In GeoView, I use a specific functionality : we are working on a local file instead of an url, so we again we normally don't need a key3F|the installation section]].
HoweverFinally, some providers like IGN you need a key even in those cases. So we can't use them. Why ?#To require a key would be too complex for to set the normal GRAMPS user#We need a key from the providerWe hope it is understood that our choice of maps is limited even is mapstraction can do more.Geoview Preferences:
=== Constraint ===We have no key, so we have a restricted access [[Image: About 10,000 to 15,000 requests by IP per day depending on the providerGeoViewPreferences.png]].
What Openlayers is a request ? As I understand with the IGN ( free too and uses by default OSM map. A lot of private or non free maps depends on OpenLayers ), a request is a tile ( an image ). You need several tiles for a view.
I think it The most interesting is sufficient for the lambda genealogistIGN ( Institut Géographique National Français )[http://www.geoportail.fr/visu2D.do?cg=djoxLjEqYzptZXRyb3BvbGUqY3Y6MS4wKnZ2OjEuMSp4eToyLjM0NTI3NDM5ODQwMTE4ODN8NDguODYwODMyNTU3MTczODgqczoxMCpwdjoxLjAqcDpkZWNvdXZlcnRlKmw6UGhvdG98fHwsU2NhbnwxfDEwMHwsQ2Fzc2luaXwxfHw%3D] which offers an old map of France ( about 1780 ) but this provider needs a key. I'll speak about keys later.
Then you have Googlemaps, Yahoo! maps, Microsoft maps, ... ===== In GRAMPS 3.2 === The proxies ==Most people You don't need a proxyto set the providers. The majority of us are connected directly to internet. In this case, forget all thisfirst one is always OpenStreetMap and the alternate is GoogleMaps.
You need ==== Supported longitude/latitude formats ====When you create/modify a proxy only if you installed one or if you depend on some internet providers.place, the possible formats used for longitude/latitude are:
== How to get the HTML kits ? ==It depends on the distribution you're working on ! They are listed in reverse order.* Floating point
pythone.g. +12.0154 -webkitgtk is also called pywebkitgtk124.3647
=== ubuntu ======= webkit ====You need libwebkit and python-webkitgtk.* Classic
Add to the /etc/apt/sourcese.list :g. 50°52'21.92"N 124°52'21.92"E
# for pythonThe degree symbol can be either UTF-webkitgtk deb http://ppa.launchpad.net/gwibber8 code c2b00a, UTF-team/ubuntu hardy main 8 code c2ba0a or the hash (# for libwebkit) character. deb http://ppa.launchpadThe seconds symbol can be either one double quote (") character or two single quote (') characters.net/webkit-team/ubuntu hardy main
It's from nightly builds, so it can crash.* Colon
If you have some crash and want to install the working package, you can get libwebkitfrom the following url e.g. -50:52:21.92 124:52:21.92
https://edge.launchpad.net/~stemp/+archive* Modified GEDCOM
==== gecko ====If you want gtkmozembed on ubuntu, you must install : python-gnome2-extrase.g. 12.0154N 124.3647E
It's stable but installs many gnome packages even if you ==== The maps providers ====There are on a KDE based distributionlot of providers. If you installed the Ubuntu GRAMPS package you already have this package as it contains the spell checking GRAMPS uses. However, there is an open bug with debian/ubuntu to split this mega package as gtkmozembed and spelling don't need the other GNOME components, so these package names might change in the futureSome are free.
=== suse ======= webkit ====* libwebkit-1_0By default, the provider GRAMPS uses is OSM ( OpenStreetMap ). As a free project, we find it our duty to first and foremost support another free initiative.
I didn't test GeoView OpenStreetMap depends on suse or opensusethe community and the maps are very light depending on the country. Nevertheless, the community made an extraordinary job and the quality is improving rapidly. And you can [http://openstreetbugs.appspot. I need some feedbackcom/ help make it better]! We can say OpenStreetMap is and will be the map GRAMPS uses per default.
I found on example in : ==== mapstraction ====ftp5Like you can see, it's impossible to implement all providers maps.gwdgFor this reason, some people created an api over all these providers api.de/pub/opensuse/repositories/home:/bmotmans/openSUSE_<VERSION>/<ARCH>/
Replace <VERSION> by With only a few modification, you can use the fedora version map you use. ie : Factory, 10.3, 1.0, .want.And better! you can switch between the maps keeping the zoom and the centered position.
Replace <ARCH> by i586For performances issues, x86_64I can confirm it takes approximately 30 seconds to view 1000 markers for openstreetmap or google.If you have 2000 markers, ..this time is about 2 times 30 seconds.
* pywebkitFor this, I limit one HTML page to 200 markers. If you have more than this limit, GRAMPS creates the necessary pages to see all your markers.
http://packagesDuring testing with a places database for France ( > 35000 markers ), I set the limit to 20 markers which permit to create 1760 pages without problems.opensuse-communitySo we can say we have an unlimited number of markers.org/indexOnly the file system space will limit us.jsp?searchTerm=pywebkit
==== gecko The provider Key ======= mandriva ======= webkit ======== gecko ======= fedora ======= webkit ====GRAMPS is not a web site. Keys are mostly only for web sites.You must In GeoView, I use a specific functionality : WebKit-gtkwe are working on a local file instead of an url, so we normally don't need a key.
yum install WebKit-gtk pywebkitgtkHowever, some providers like IGN need a key even in those cases. So we can't use them. Why ?#To require a key would be too complex for the normal GRAMPS user#We need a key from the providerWe hope it is understood that our choice of maps is limited even if mapstraction can do more.
==== gecko =Constraint =====We have no key, so we have a restricted access : About 10,000 to 15,000 requests by IP per day depending on the provider.
=== debian ======= webkit ====This What is a request ? As I understand with the same packager for ubuntu and debianIGN ( OpenLayers ), so go to the ubuntu paragrapha request is a tile ( an image ).==== gecko ====install the python-gtkmozembed packageYou need several tiles for a view.=== windows XP/Vista ===Perhaps the following link can help windows developers :
http://priscimonI think it is sufficient for the lambda genealogist.com/blog/2008/06/04/four-easy-steps-to-running-webkit-on-windows/
=== MAC/OS X ======= webkit Creating new places from the Geography view ====This You center the map for the place you want to create.You can use the double click for that.When you are sure the position is standard OK, click on MACthe "+" button in the tools bar.Now, the place editor is opened. Can someone confirm Enter all the field necessary for thisnew place then click on the OK button. That's all.Is there a python-webkit package on MAC ?==== gecko Associate a new position to an already existing place ====== ..You center the map for the place you want to modify like for creating a new place. ==Your modifications When you are welcomed sure the position is OK, click on the "map" button in the tools near the "+" button described above.A places list is opened.Choose the place you want to modify then click on the OK button.
You can use this method to modify the position you used in a prior creation.====Results====
<gallery>
Image:Geoview4.png|Fig.4 All places with coordinates on Family Tree
</gallery>
 
==== If you get a crash when starting gramps ====
It's probably a webkit problem.
So, you have two possibilities :
===== Remove the webkit rendering engine only =====
Remove webkit and install gtkmozembed (gecko) is not already installed. See the specific package for your distribution.
You'll have the gecko rendering.
===== Remove all rendering engines =====
Remove python-webkit and python-gtkmozembed. You'll never see geoview. See the specific packages for your distribution.
 
==See also==
* [[GeoViewHelp]] Addon
[[Category:GEPS|G]]
[[Category:Plugins]]
[[Category:Developers/General]]
[[Category:Views|G]]
2,186
edits

Navigation menu