Changes

Jump to: navigation, search

GeoView

6,375 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]]}}
'''All we need to understand and test {{man warn|Instructions for the older GeoView.'''addon that was based on webkit/gtkmozembed}}
'''All we need to understand 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.
 
== The future ==
 
For approximatively three years, geoview is based on html technology using webkit or gtkmozembed.
We have some problems depending on the distribution, the webkit version, ... : crashes, messages on console, ...
 
The mecanism for rendering the map is asynchronous and difficult to manage : the renderer and gramps are two different things which don't easily communicate.
 
So, I am working on a new map renderer since some month now.
 
If you are impatient, go there : [[Geography]]
 
==GeoView is divided in two parts : ==
This module is now in two parts in 3.2. I'll try to explain how to install them and how to use them. You have two new views named Geography (geoviev) and Web (htmlrenderer).
=== The html rendering engine ===
This module is called htmlrenderer. We use it when we use the Web view.
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 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 [[Geography]] and the Web appearing among your views. If you are looking on how to install these, see [[GeoView is one solution#How_to_get_the_HTML_kits_.3F| below]]
If both two kits are installed, webkit will be used.===== WebKit === The html kits ==We can use webkit or gtkmozembed to view html pages. If no one Be aware, WebKit is installed, you'll never see GeoViewalways in development.
If the two kits More and more projects are installedintegrating webkit ...Eg, webkit will be usedepiphany states: *http://blogs.gnome.org/epiphany/2008/04/01/the-future-of-epiphany/
For web browsing, we need to WebKit uses the libsoup library for the proxy.===== Gecko ( GtkMozEmbed ) =====What will gtkmozembed be connected to in the network.future ?
Even if you have The embedding API of Gecko (GtkMozEmbed) has been unmaintained and stagnant for a html kit installed, you can always say : I don't mind ! I don't want to see the HtmlViewlong time.
For GtkMozEmbed is proxy aware. I implemented this, you can disallow Geoview in and I use the Internet Maps preferences tabhttp_proxy environment variable.Authentication is allowed.The http_proxy format used is :
''http://[user:password@]proxy:port/''====The proxies = WebKit ===ItMost people don's the futuret need a proxy. The majority of us are connected directly to internet. Be awareIn this case, WebKit is always in developmentforget all this.
More 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 ====== ===== mandriva =========== webkit ======for 2009.0 and more projects are integrating 2009.1:Use the package manager and install python-webkitgtk or : ''urpmi python-webkitgtk''====== gecko ======Seems not to work. Causes segmentation fault. ===== suse =========== webkit ======* libwebkit-1_0 I didn't test GeoView on suse or opensuse. I need some feedback. 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 =========== webkit ======  ''aptitude install python-webkit''
The reason why for epiphany ====== gecko ======If you want gtkmozembed on ubuntu, you must install : python-gnome2-extras or python-gtkmozembed depending on you distrib version.
http://blogs.gnome.org/epiphany/2008/04/01/the ''aptitude install python-futuregnome2-ofextras'' or ''aptitude install python-epiphany/gtkmozembed''
==== Proxies = windows XP/Vista =====WebKit uses the libsoup library. You need the environment variable http_proxy.====== webkit ======
=== Gecko * WebKitGTK is the 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 ( GtkMozEmbed DLL) ===. You will need [http://www.7-zip.org 7zip] to extract its contentsWhat will gtkmozembed be in the future ? ''This file is highly experimental and all functions may not work as expected!''** [http://www.gramps-project.org/wiki/images/d/d2/WebKitGTK-1.1.16.zip WebKitGTK-1.1.16.zip]
The embedding API of Gecko * Update to version 1.1.23 (GtkMozEmbedbinary and devel files only) has been unmaintained and stagnant for a long time** [http://www.gramps-project.org/wiki/images/d/db/WebKitGTK-1.1.==== Proxies ====GtkMozEmbed is proxy aware23-win32. I implement this and I use the http_proxy environment variablezip WebKitGTK-1.Authentication is allowed1. The http_proxy format used is :23]
* [http://code.google.com/p/pywebkitgtk PyWebKitGtk] provide Python bindings to WebKitGTK** [userhttp:password@//www.gramps-project.org/wiki/images/4/4d/PyWebKitGTK-1.1.7.win32-py2.6.zip PyWebKitGTK-1.1.7.win32-py2.6.msi]proxy:port/
To confirm : We need to use gnome[[All In One Gramps Software Bundle for Windows|Gramps AIO package]] contains WebKitGTK-control1.2.5 and PyWebKitGTK-center to set the proxy.== The maps providers ==There are a lot of providers1. Some are free1.8
By default===== ... =====Your distributions are welcomed ...=== The Geographic part ===This module is called geoview. It depends on the htmlrenderer module.===== In GRAMPS 3.1.x =====If you really are in 3.1.2 and greater, you only have the provider geoview module. The htmlrenderer is OSM ( OpenStreetMap )included in geoview.For installing the html renderer, you can see the documentation above.
This provider depends on It is present as an experimental view you can activate. For GeoView to work you need to:# change the community and GRAMPS configuration file to list the view in the maps are very light depending on list of views# install the countryrequired backend so you can see webpages inside of GRAMPS. Nevertheless, # set the community made an extraordinary job since a few month. We GeoView Preferences# use the appropriate latidude and longitude format in your data (Note: the [[Place completion tool]] can say OpenStreetMap is look up latitude and will be longitude of the map for grampsplaces defined in GRAMPS.)
Openlayers The first is free too simple to achieve. Start a text editor and go to your gramps home directory, and open the keys.ini file. Scoll down to the interface section, and uses by default OSM maplook for the ''data-views'' variable.On a clean install of GRAMPS, this variable is normally: A lot of private or non free maps depends on OpenLayers. 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
The most interesting is the IGN ( 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. IThat'll speek about keys laters it.
You have GooglemapsTo install the backend, Yahoo! maps, Microsoft maps, .scroll down to [[GeoView#How_to_get_the_HTML_kits_.3F|the installation section]].
== mapstraction ==Like Finally, you can see, it's impossible need to implement all providers maps. For this reason, some people created an api over all these providers api.set the Geoview Preferences:
With only a few modification, you can use the map you want[[Image:GeoViewPreferences. And better! you can switch between the maps keeping the zoom and the centered positionpng]].
It's also in the development phase Openlayers is free too and is sometimes buggyuses by default OSM map. A lot of private or non free maps depends on OpenLayers.
For performances issues, I can confirm it takes approximatively 30 secondes to view 1000 markers for openstreetmap or googleThe most interesting is the IGN ( Institut Géographique National Français )[http://www.geoportail.fr/visu2D.If you have 2000 markers, do?cg=djoxLjEqYzptZXRyb3BvbGUqY3Y6MS4wKnZ2OjEuMSp4eToyLjM0NTI3NDM5ODQwMTE4ODN8NDguODYwODMyNTU3MTczODgqczoxMCpwdjoxLjAqcDpkZWNvdXZlcnRlKmw6UGhvdG98fHwsU2NhbnwxfDEwMHwsQ2Fzc2luaXwxfHw%3D] which offers an old map of France ( about 1780 ) but this time is provider needs a key. I'll speak about 2 times 30 secondeskeys later.
For thisThen you have Googlemaps, Yahoo! maps, Microsoft maps, I limit one html page ... ===== In GRAMPS 3.2 =====You don't need to 200 markersset the providers. I you have more than this limit, I create The first one is always OpenStreetMap and the necessary pages to see all your markersalternate is GoogleMaps.
During testing with ==== Supported longitude/latitude formats ====When you create/modify a places database for France ( > 35000 markers )place, 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 us.possible formats used for longitude/latitude are:
== The provider Key ==Gramps is not a web site. Keys are only for web sites.In GeoView, I use a specific functionality : We are working on local file instead of url, so we don't need a key.some providers like IGN needs key even in this case. So I can't use them. Why ?#Too complex for final user's.#We need a key by providerIn these case, I hope you understand the choice is limited even is mapstraction can do more.=== 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.* Floating point
What is a request ? As I understand with the IGN ( OpenLayers ), a request is a tile ( an image )e. You need several tiles for a viewg.+12.0154 -124.3647
I think it is sufficient for the lambda genealogist.* Classic
== The proxies ==Everybody doesne.g. 50°52't need a proxy21. The majority of us are connected directly to internet. In this case, forget all this92"N 124°52'21.92"E
You need a proxy only if you installed The degree symbol can be either UTF-8 code c2b00a, UTF-8 code c2ba0a or the hash (#) character.The seconds symbol can be either one double quote (") character or if you depend on some internet providerstwo single quote (') characters.
== How to get the html kits ? ==It depends on the distribution you're working on ! They are listed in reverse order.* Colon
pythone.g. -webkitgtk is also called pywebkitgtk=== ubuntu 50:52:21.92 ======= webkit ====You needs libwebkit and python-webkitgtk124:52:21.92
Add to the /etc/apt/sources.list :* Modified GEDCOM
# for python-webkitgtk deb http://ppae.g.launchpad12.net/gwibber-team/ubuntu hardy main0154N # for libwebkit deb http://ppa.launchpad124.net/webkit-team/ubuntu hardy main3647E
It's from nightly builds, so it can crash==== The maps providers ====There are a lot of providers. Some are free.
If you have some crash and want to install By default, the working packageprovider GRAMPS uses is OSM ( OpenStreetMap ). As a free project, you can get libwebkitfrom the following url :we find it our duty to first and foremost support another free initiative.
httpsOpenStreetMap 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://edgeopenstreetbugs.launchpadappspot.netcom/~stemp/+archive==== gecko ====If you want gtkmozembed on ubuntu, you must install : python-gnome2-extrashelp make it better]! We can say OpenStreetMap is and will be the map GRAMPS uses per default.
It==== mapstraction ====Like you can see, it's stable but install many gnome packages even if you are on a kde based distributionimpossible to implement all providers maps. For this reason, some people created an api over all these providers api.
PleaseWith only a few modification, don't troll you can use the map you want. And better!=== suse ======= webkit ====* libwebkit-1_0you can switch between the maps keeping the zoom and the centered position.
For performances issues, I didn't test GeoView on suse can confirm it takes approximately 30 seconds to view 1000 markers for openstreetmap or opensusegoogle. I need some feedbackIf you have 2000 markers, this time is about 2 times 30 seconds.
For this, I found on example in : ftp5limit one HTML page to 200 markers.gwdgIf you have more than this limit, GRAMPS creates the necessary pages to see all your markers.de/pub/opensuse/repositories/home:/bmotmans/openSUSE_<VERSION>/<ARCH>/
Replace <VERSIONDuring testing with a places database for France ( > by 35000 markers ), I set the fedora version you use. ie : Factory, 10.3, 1.0, 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 us.
Replace <ARCH> by i586==== The provider Key ====GRAMPS is not a web site. Keys are mostly only for web sites.In GeoView, x86_64I use a specific functionality : we are working on a local file instead of an url, ..so we normally don't need a key.
* pywebkitHowever, 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.
http===== Constraint =====We have no key, so we have a restricted access ://packages.opensuse-communityAbout 10,000 to 15,000 requests by IP per day depending on the provider.org/index.jsp?searchTerm=pywebkit
==== gecko ======= mandriva ======= webkit ======== gecko ======= fedora ======= webkit ====What is a request ? As I understand with the IGN ( OpenLayers ), a request is a tile ( an image ). You must use : WebKit-gtkneed several tiles for a view.
I didn't test GeoView on Fedora. I need some feedbackthink it is sufficient for the lambda genealogist.
http://download==== Creating new places from the Geography view ====You center the map for the place you want to create.fedoraYou can use the double click for that.redhatWhen you are sure the position is OK, click on the "+" button in the tools bar.Now, the place editor is opened. Enter all the field necessary for this new place then click on the OK button. That's all.==== 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.When you are 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.com/pub/fedora/linux/releases/<VERSION>/Everything/<ARCH>/os/Packages/
Replace <VERSION> by You can use this method to modify the fedora version position you use. ie : 7, 9, 10, ..used in a prior creation.====Results====
Replace <ARCHgallery> by i386, x86_64, Image:Geoview1.png|Fig.1 All event places with coordinates for an individualImage:Geoview2.png|Fig.2 All individual's family places with coordinates==== gecko ======= debian ======= webkit ====Image:Geoview3.png|Fig.3 All event places with coordinates on Family TreeThis is the same packager for ubuntu and debian, so go to the ubuntu paragraphImage:Geoview4.==== gecko ====install the python-gtkmozembed packagepng|Fig.4 All places with coordinates on Family Tree=== windows XP</Vista ===I don't know who is the windows packager for libwebkit and python-webkitgtk or pywebkitgtk.gallery>
<SMILE>==== 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.
Perhaps it will be a good way to go to Linux !==See also==* [[GeoViewHelp]] Addon
</SMILE>[[Category:GEPS|G]][[Category:Plugins]]=== MAC[[Category:Developers/OS X ======= webkit ====This is standard on MAC. Can someone confirm this.Is there a python-webkit package on MAC ?==== gecko ====== ... ==General]]Your modifications are welcomed ...[[Category:Views|G]]
2,186
edits

Navigation menu